Text zu Bild

POST /v3/generation/text-to-image

Generieren Sie ein Bild aus einer Textaufforderung.

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
prompt	Zeichenfolge	Ja	-	Textaufforderung, bis zu 1024 Zeichen
model	Zeichenfolge	Nein	`seedream_v4`	Bildmodell. Unterstützte Werte: `seedream_v5`, `seedream_v4`, `gemini-2.5-flash`, `gemini-3-pro`, `gemini-3.1-flash`, `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/text-to-image \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "prompt": "A cat wearing a spacesuit, cyberpunk style",
    "model": "seedream-v4"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/text-to-image"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "prompt": "A cat wearing a spacesuit, cyberpunk style",
    "model": "seedream-v4"
}

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

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

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    prompt: "A cat wearing a spacesuit, cyberpunk style",
    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	2008	Die Eingabe verstößt gegen die Inhaltsrichtlinien	Überarbeiten Sie 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