Bild zu Bild

POST /v3/generation/image-to-image

Erzeugen Sie ein neues Bild aus einem Referenzbild.

Anforderungsparameter

Anforderungsheader

Parameter	Typ	Erforderlich	Standard	Beschreibung
Content-Type	Zeichenfolge	Ja	-	`application/json`
Authorization	Zeichenfolge	Ja	-	`Bearer {api_key}`

Anforderungstext

Parameter	Typ	Erforderlich	Standard	Beschreibung
input	Zeichenfolge	Ja	-	Referenzbild. Unterstützt `file_token`, ein Bild URL oder `task_id`
inputs	string[]	Nein	-	Liste mehrerer Referenzbilder. `seedream`-Modelle unterstützen bis zu 4 Bilder und `banana`-Modelle unterstützen bis zu 10 Bilder. Sie können mit `[image number]` auf ein bestimmtes Bild in `prompt` verweisen
prompt	Zeichenfolge	Bedingt erforderlich	-	Anleitung zur Bildbearbeitung. Erforderlich, wenn `template` nicht angegeben ist
model	Zeichenfolge	Nein	`seedream_v5`	Bildmodell. Unterstützte Werte: `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	Zeichenfolge	Nein	`low`	Qualitätsstufe. Nur `chat_image_2` (`low`, `medium`, `high`) sowie `chat_image_2.5_flare` / `chat_image_2.5_sunburst` (zusätzlich `xhigh`, `max`). Ohne Angabe gilt `low`; `auto` wird nicht unterstützt. `high`/`xhigh`/`max` kosten mehr Credits.
background	Zeichenfolge	Nein	-	Hintergrundbehandlung. Nur `chat_image_2.5_flare` / `chat_image_2.5_sunburst`: `auto`, `opaque`, `transparent`. Bei anderen Modellen wird der Wert ignoriert, nicht abgelehnt. `transparent` erfordert `output_format=png` (JPEG hat keinen Alphakanal).
template	Zeichenfolge	Nein	-	Vorlagenname. Unterstützte Werte: `asset_extraction`, `character_completion`, `t_pose`, `head_extraction`, `3d_enhance`, `variants`, `print_clay`, `figure`
t_pose	Boolescher Wert	Nein	`false`	In T-Pose umwandeln
sketch_to_render	Boolescher Wert	Nein	`false`	Konvertieren Sie eine Skizze in ein gerendertes Bild

Fordern Sie Beispiele an

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);

Antwort

Erfolgsantwort

JSON

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

Antwortfelder

Parameter	Typ	Beschreibung
code	ganze Zahl	Statuscode. `0` zeigt Erfolg an
data.task_id	Zeichenfolge	Eindeutiger Aufgabenbezeichner, der zum Abfragen des Generierungsfortschritts und der Ergebnisse verwendet wird

Fehlercodes

HTTP Statuscode	Fehlercode	Beschreibung	Empfehlung
429	2000	Generationslimit überschritten	Reduzieren Sie die Anforderungshäufigkeit und versuchen Sie es später noch einmal
400	2002	Nicht unterstützter Anforderungsparameter	Überprüfen Sie die Parameternamen und Wertebereiche des Anforderungshauptteils
400	2003	Die Eingabedatei ist leer	Bestätigen Sie, dass `input` auf eine gültige Bildressource verweist
400	2004	Nicht unterstützter Dateityp	Verwenden Sie ein unterstütztes Bildformat (PNG, JPEG, WebP).
400	2008	Die Eingabe verstößt gegen die Inhaltsrichtlinien	Überarbeiten Sie das Eingabebild oder die Eingabeaufforderung und entfernen Sie Beschreibungen, die gegen die Richtlinien verstoßen
403	2010	Unzureichende Credits	Fügen Sie Credits hinzu und versuchen Sie es erneut
400	2015	Modellversion veraltet	Aktualisieren Sie `model` auf eine aktuell unterstützte Version