Seedream5.5 API
Entdecken Sie Seedream5.5 API-Abläufe für Bilderzeugung, präzise Bearbeitung, mehrsprachige Texte und Kompositionen aus mehreren Bildern. Ordnen Sie Prompts und Referenzen in diesem APIMart-Arbeitsbereich und prüfen Sie anschließend die API-Beispiele und die Parametertabelle weiter unten.
Seedream5.5 API-Arbeitsbereich
- 1K, 1.5K, 2K, Seitenverhältnisse und eigene Pixelgrößen
- Bis zu 10 Referenzen; eine für Transparenz oder Ebenen
- JPEG / PNG, Prompt-Optimierung und Ausgabeeinstellungen
Beschreiben Sie Motiv, Bildaufbau, Beleuchtung und den gewünschten Text.
Referenzbilder
Bis zu 10 Referenzen oder eine für Transparenz und Ebenentrennung. Lokale Dateien: JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC oder HEIF, höchstens 30 MB pro Datei. Verwenden Sie in JSON öffentliche HTTP(S)-URLs oder vollständige Bild-Data-URIs; lokale Dateien bleiben Browser-Vorschauen.
Referenzbilder: Jede Seite größer als 14 px, Breite-Höhe-Verhältnis 1/16–16 und insgesamt höchstens 36.000.000 Pixel. Transparente Hintergründe erfordern ein Eingabebild mit Alphakanal.
Die generierten Bilder werden hier angezeigt
Klare Bildvorgaben mit Seedream5.5 API formulieren
Bereiten Sie einen Seedream5.5 API-Entwurf für eine neue Szene oder eine gezielte Bearbeitung vor. Definieren Sie Motiv, Licht und Bildaufbau und trennen Sie gewünschte Änderungen von den Details, die erhalten bleiben sollen.
Seedream5.5 API-Beispiele: Bilder aus Text und Bildbearbeitung
Die Seedream5.5 API-Beispiele verwenden das gemeinsame asynchrone Aufgabenformat von APIMart mit Prompts, Referenzen, Größe, Auflösung und Ausgabeoptionen. Fragen Sie das Ergebnis separat mit der zurückgegebenen Aufgaben-ID ab.
- 1
API-Schlüssel einrichten
Speichern Sie Ihren APIMart-API-Schlüssel in APIMART_API_KEY. Die Seedream5.5 API-Beispiele verwenden Authorization: Bearer <key> sowohl zum Senden von Anfragen als auch zum Abfragen von Aufgaben.
- 2
Seedream5.5 API-Anfrage zusammenstellen
Das Beispiel verwendet POST /v1/images/generations mit model: seedream-5.5, prompt, size, resolution und output_format. Ergänzen Sie image_urls für Bearbeitungen. Lesen Sie die Aufgaben-ID aus data[0].task_id.
- 3
Ergebnis der API-Aufgabe abrufen
Verwenden Sie GET /v1/tasks/{task_id}. Lesen Sie bei einer abgeschlossenen Aufgabe data.result.images[0].url[0] und bei einer fehlgeschlagenen Aufgabe data.error.message.
Informationen zur Authentifizierung und allgemeinen API-Nutzung finden Sie in der APIMart-Dokumentation.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5.5",
"prompt": "Ein Produktplakat im Editorial-Stil mit einer weißen Keramiktasse auf einem hellen Holztisch, weichem Seitenlicht, der Überschrift \"MORGENRITUAL\" oben, klarer Typografie und großzügigem Weißraum.",
"size": "16:9",
"resolution": "1.5K",
"output_format": "png"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "seedream-5.5",
"prompt": "Ein Produktplakat im Editorial-Stil mit einer weißen Keramiktasse auf einem hellen Holztisch, weichem Seitenlicht, der Überschrift \"MORGENRITUAL\" oben, klarer Typografie und großzügigem Weißraum.",
"size": "16:9",
"resolution": "1.5K",
"output_format": "png"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5.5",
"prompt": "Ersetze im Referenzbild die Überschrift \"MORGENRITUAL\" durch \"ABENDRUHE\". Behalte die Tasse, den Tisch, die Beleuchtung, die Textposition und alle anderen Elemente bei.",
"image_urls": [
"https://example.com/reference.png"
],
"size": "auto",
"resolution": "2K",
"output_format": "png"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Parameter der Seedream5.5 API
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|---|---|---|---|---|
model | string | Ja | Standard: seedream-5.5 | Modellwert in diesem Seedream5.5 API-Arbeitsbereich und seinen Beispielen: seedream-5.5. |
prompt | string | Ja | Standard: — | Ihre Seedream5.5-Anweisung: Beschreiben Sie ein neues Bild oder die Änderungen und zu erhaltenden Details. Optional, wenn layer_decomposition true ist. |
size | string | Nein | Standard: 1:1 | Standard im Arbeitsbereich: 1:1. Wählen Sie auto; ein Verhältnis aus 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9; eine Stufe aus 1K, 1.5K, 2K; oder eigene Pixelgrößen wie 2048x1024. Eigene Größen erfordern insgesamt 921.600–4.624.220 Pixel und ein Breite-Höhe-Verhältnis von 1/16–16. |
resolution | string | Nein | Standard: 1K | Auflösung des Seedream5.5 API-Entwurfs: 1K, 1.5K oder 2K. Gilt, wenn size ein Seitenverhältnis oder auto ist. Entfällt bei Stufen- und Pixelgrößen sowie bei der Ebenentrennung. |
image_urls | array | Nein | Standard: — | Bis zu 10 Referenzbilder als öffentliche HTTP(S)-URLs oder vollständige Base64-Bild-Data-URIs. JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC und HEIF; höchstens 30 MB pro Bild. Breite-Höhe-Verhältnis 1/16–16, jede Seite größer als 14 px und insgesamt höchstens 36.000.000 Pixel. Transparenz oder Ebenentrennung erfordert genau eine Referenz. Lokale Blob-URLs dienen als Browser-Vorschauen. |
output_format | string | Nein | Standard: jpeg | Ausgabeformat: jpeg oder png. Ein transparenter Hintergrund im Formular wählt automatisch PNG aus. |
background | string | Nein | Standard: opaque | opaque oder transparent. Ein transparenter Hintergrund erfordert genau ein Eingabebild mit Alphakanal und eine PNG-Ausgabe. |
layer_decomposition | boolean | Nein | Standard: false | Teilt eine PNG- oder JPEG-Referenz in ein Basisbild und transparente Ebenen. In diesem Modus akzeptiert size nur auto, 1K, 1.5K oder 2K; prompt ist optional und resolution entfällt. |
optimize_prompt_options | object | Nein | Standard: Omitted | Optionale Prompt-Optimierung: {"mode":"standard"}. Im Arbeitsbereich ist sie standardmäßig ausgeschaltet; dadurch entfällt dieses Feld. |
watermark | boolean | Nein | Standard: false | Legt fest, ob das Ausgabebild ein Wasserzeichen zur Kennzeichnung als KI-generiert erhält. |
nsfw_check | boolean | Nein | Standard: false | Legt fest, ob Prompt und Eingabebilder vor der Verarbeitung der API-Aufgabe moderiert werden. |
n | integer | Nein | Standard: 1 | Die normale Generierung liefert ein Bild. JSON akzeptiert nur n: 1; der Arbeitsbereich lässt es in der normalisierten Konfiguration weg. |
