Resimden Resme

POST /v3/generation/image-to-image

Referans görüntüden yeni bir görüntü oluşturun.

İstek Parametreleri

Başlıkları Talep Et

Parametre	Tür	Gerekli	Varsayılan	Açıklama
Content-Type	dize	Evet	-	`application/json`
Authorization	dize	Evet	-	`Bearer {api_key}`

Talep Gövdesi

Parametre	Tür	Gerekli	Varsayılan	Açıklama
input	dize	Evet	-	Referans resmi. `file_token`, bir görüntü URL veya `task_id`’yi destekler
inputs	dize[]	Hayır	-	Birden fazla referans görselinin listesi. `seedream` modelleri en fazla 4 görüntüyü destekler ve `banana` modelleri en fazla 10 görüntüyü destekler. `[image number]`'yi kullanarak `prompt`’deki belirli bir görüntüye referans verebilirsiniz.
prompt	dize	Şartlı olarak gerekli	-	Resim düzenleme talimatı. `template` belirtilmediğinde gereklidir
model	dize	Hayır	`seedream_v5`	Görüntü modeli. Desteklenen değerler: `seedream_v5`, `banana`, `banana_pro`, `banana2`, `chat_image_1`, `chat_image_1.5`, `chat_image_2`, `chat_image_2.5_flare`, `chat_image_2.5_sunburst`
quality	dize	Hayır	`low`	Kalite kademesi. Yalnızca `chat_image_2` (`low`, `medium`, `high`) ve `chat_image_2.5_flare` / `chat_image_2.5_sunburst` (ayrıca `xhigh`, `max`) destekler. Belirtilmezse `low` kabul edilir; `auto` desteklenmez. `high`/`xhigh`/`max` daha fazla kredi harcar.
background	dize	Hayır	-	Arka plan işleme. Yalnızca `chat_image_2.5_flare` / `chat_image_2.5_sunburst`: `auto`, `opaque`, `transparent`. Diğer modellerde reddedilmez, yok sayılır. `transparent` için `output_format=png` gerekir (JPEG alfa kanalı taşımaz).
template	dize	Hayır	-	Şablon adı. Desteklenen değerler: `asset_extraction`, `character_completion`, `t_pose`, `head_extraction`, `3d_enhance`, `variants`, `print_clay`, `figure`
t_pose	boolean	Hayır	`false`	T pozuna dönüştür
sketch_to_render	boolean	Hayır	`false`	Bir çizimi işlenmiş bir görüntüye dönüştürme

Örnekler İste

curl -X POST https://openapi.tripo3d.ai/v3/generation/image-to-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "https://example.com/reference.png",
    "prompt": "Replace the background with a starry sky",
    "model": "seedream-v4"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/image-to-image"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "https://example.com/reference.png",
    "prompt": "Replace the background with a starry sky",
    "model": "seedream-v4"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/generation/image-to-image";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "https://example.com/reference.png",
    prompt: "Replace the background with a starry sky",
    model: "seedream-v4"
  })
});

const data = await response.json();
console.log(data);

Yanıt

Başarı Yanıtı

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}

Yanıt Alanları

Parametre	Tür	Açıklama
code	tamsayı	Durum kodu. `0` başarıyı gösterir
data.task_id	dize	Oluşturma ilerlemesini ve sonuçlarını sorgulamak için kullanılan benzersiz görev tanımlayıcı

Hata Kodları

HTTP Durum Kodu	Hata Kodu	Açıklama	Tavsiye
429	2000	Üretim sınırı aşıldı	İstek sıklığını azaltın ve daha sonra yeniden deneyin
400	2002	Desteklenmeyen istek parametresi	İstek gövdesi parametre adlarını ve değer aralıklarını kontrol edin
400	2003	Giriş dosyası boş	`input`’nin geçerli bir görüntü kaynağına işaret ettiğini doğrulayın
400	2004	Desteklenmeyen dosya türü	Desteklenen bir resim formatı kullanın (PNG, JPEG, WebP)
400	2008	Giriş içerik politikasını ihlal ediyor	Giriş görselini gözden geçirin veya politikayı ihlal eden açıklamaları isteyin ve kaldırın
403	2010	Yetersiz kredi	Kredi ekleyin ve yeniden deneyin
400	2015	Model sürümü kullanımdan kaldırıldı	`model`’yi şu anda desteklenen bir sürüme yükseltin