

Bilder mit Seedream 5.0 Pro generieren: Anleitung
Schritt-für-Schritt-Anleitung zum Aufruf von Seedream 5.0 Pro auf APIMart: Authentifizierung, Anfragefelder, Task-Abfrage, Ergebnisse auslesen und Bilder vor Ablauf der Links sichern.
Seedream 5.0 Pro läuft mit einer POST-Anfrage, einem API-Key und einem weiteren Schritt: Sie senden den Auftrag, erhalten eine task_id und fragen den Task ab, bis das Bild fertig ist. Seedream 5.0 Pro arbeitet asynchron, daher enthält die erste Antwort nie das Bild.
Die Kurzfassung:
- Ich sende Anfragen an
https://api.apimart.ai/v1/images/generations - Ich füge
Authorization: Bearer YOUR_API_KEYhinzu - Ich setze
modelaufseedream-5-0-pro - Ich übergebe
promptsowieresolution(1K,1.5Koder2K) undsize(autooder ein Seitenverhältnis wie16:9) - Zum Bearbeiten oder Kombinieren gebe ich bis zu 10 Referenzbilder in
image_urlsmit - Ich frage
GET /v1/tasks/{task_id}alle 5–10 Sekunden ab, bis der Statuscompletedlautet - Ich lade das Ergebnis sofort herunter, denn Bildlinks gelten 72 Stunden
Das Wichtigste: Es ist ein Einzelbild-Modell. Jede Anfrage liefert ein Bild, und n größer als 1 wird abgelehnt. Sie können die Seedream 5.0 Pro API auf APIMart testen; alle Felder stehen in der API-Referenz.

Wichtigste Erkenntnisse
- Seedream 5.0 Pro wird per POST an
https://api.apimart.ai/v1/images/generationsaufgerufen, mit dem Header Authorization: Bearer YOUR_API_KEY und model gleich seedream-5-0-pro. - Die Ausgabestufe wählen Sie mit resolution (1K, 1.5K oder 2K), die Form mit size: auto, eines von zehn Seitenverhältnissen oder exakte Pixel. 1.5K kostet so viel wie 1K; 3K und 4K liefern 400.
- Jede Anfrage erzeugt ein Bild. n größer als 1, Gruppengenerierung, Streaming und Websuche werden mit 400 abgelehnt, und es entsteht kein Task.
- Für die Bildbearbeitung senden Sie bis zu 10 Referenzbilder über image_urls, als öffentliche URLs oder Base64-Data-URIs.
- Die erste Antwort enthält nur eine task_id. Fragen Sie den Task-Endpunkt alle 5–10 Sekunden ab und speichern Sie das Bild innerhalb von 72 Stunden.
Schneller Vergleich
| Element | Wofür ich es nutze | Wichtige Grenze oder Hinweis |
|---|---|---|
| Text-zu-Bild | Neue Bilder nur aus dem Prompt | Kein Eingabebild nötig |
| Bearbeitung mit einer Referenz | Hintergrund, Licht oder Details eines Bildes ändern | Ein Eintrag in image_urls |
| Bearbeitung mit mehreren Referenzen | Personen, Outfits oder Szenen kombinieren | Bis zu 10 Referenzbilder |
| Ebenenzerlegung | Ein Poster in bearbeitbare Ebenen aufteilen | Genau ein Eingabebild, bis zu 16 PNG-Ebenen |
| Transparenter Hintergrund | Eine Ebene bearbeiten und Alpha behalten | Ein Eingabebild mit Alpha, output_format: "png" |
Kurz gesagt: Diese Anleitung zeigt, wie ich die Authentifizierung einrichte, den Request-Body baue, den Task abfrage und das Ergebnis speichere, ohne Dateien zu verlieren.
1. API-Zugang und Authentifizierung einrichten
1.1 APIMart-Konto erstellen und API-Key generieren

Registrieren Sie sich bei APIMart, öffnen Sie im Dashboard die API-Key-Verwaltung und erstellen Sie einen Key. Kopieren Sie ihn sofort und speichern Sie ihn serverseitig in einem Secret Manager oder einer Umgebungsvariable.
Legen Sie den Key nie in Frontend-Code oder einem öffentlichen Repository ab. Wer ihn hat, kann Ihr Guthaben verbrauchen. In Node.js lesen Sie ihn aus process.env.APIMART_API_KEY, in der Shell nutzen Sie export APIMART_API_KEY="your-key-here".
1.2 Base-URL und Bearer-Authentifizierungsheader setzen
Jede Anfrage geht an die Base-URL https://api.apimart.ai und enthält zwei Header:
| Header | Wert |
|---|---|
Authorization | Bearer YOUR_API_KEY |
Content-Type | application/json |
Behalten Sie das Präfix Bearer mit genau einem Leerzeichen bei. Ein fehlendes oder falsch formatiertes Token liefert 401. Funktioniert cURL, Ihre App aber nicht, liegt der Fehler meist darin, wie die App die Header aufbaut.
2. Eine Seedream 5.0 Pro-Bildanfrage erstellen

2.1 Kernfelder: Model, Prompt, Resolution und Size
Eine Text-zu-Bild-Anfrage braucht model und prompt. Zwei weitere Felder steuern die Ausgabe:
model:seedream-5-0-pro(seedream-5.0-prowird ebenfalls akzeptiert).prompt: eine Beschreibung in natürlicher Sprache. Neben Chinesisch und Englisch rendert das Modell Text nativ auch auf Deutsch, Japanisch, Koreanisch, Spanisch, Portugiesisch, Französisch, Russisch, Indonesisch, Vietnamesisch und in weiteren Sprachen. Bleiben Sie bei etwa 600 englischen Wörtern; sehr lange Prompts können Details verlieren.resolution:1K(Standard),1.5Koder2K. 1.5K kostet so viel wie 1K und ist daher meist die bessere Wahl.size:auto(Standard), eines von zehn Seitenverhältnissen (1:1,4:3,3:4,16:9,9:16,3:2,2:3,2:1,1:2,21:9) oder exakte Pixel wie2048x1024. Exakte Pixel müssen insgesamt zwischen 921.600 und 4.624.220 liegen, mit einem Seitenverhältnis zwischen 1:16 und 16:1.
Zum Beispiel liefert resolution: "1.5K" mit size: "16:9" ein Bild mit 2048×1152 Pixeln.
2.2 Optionale Felder
| Optionaler Parameter | Typ | Wann verwenden |
|---|---|---|
image_urls | Array | Bearbeitung und Komposition mit mehreren Referenzen; bis zu 10 öffentliche URLs oder Base64-Data-URIs |
output_format | String | jpeg (Standard) oder png |
background | String | transparent, um Alpha zu behalten, wenn Sie ein Bild mit vorhandenem Alphakanal bearbeiten (erfordert png) |
layer_decomposition | Boolean | Ein Bild in ein Basisbild und bis zu 16 transparente PNG-Ebenen zerlegen |
optimize_prompt_options | Object | Prompt-Optimierung; nur {"mode": "standard"} wird unterstützt |
watermark | Boolean | Hinweis „KI-generiert“ unten rechts einfügen |
nsfw_check | Boolean | Prompt und Eingabebilder vor dem Absenden prüfen |
Jedes Referenzbild darf jpeg, png, webp, bmp, tiff, gif, heic oder heif sein, bis 30 MB und 36 Millionen Pixel. Das erste Referenzbild ist kostenlos; jedes weitere kostet einen festen Aufpreis.
Um eine Bearbeitung genau zu platzieren, schreiben Sie Koordinaten in den Prompt: <point>x y</point> für einen Punkt oder <bbox>x1 y1 x2 y2</bbox> für einen Bereich.
2.3 Felder, die dieses Modell ablehnt
Seedream 5.0 Pro ist ein Einzelbild-Modell. Diese Anfragen liefern 400, erzeugen keinen Task und werden nicht berechnet:
ngrößer als 1 odersequential_image_generation(für Gruppenbilder Seedream 5.0 Lite verwenden)streamodertools(Streaming und Websuche werden nicht unterstützt)- mehr als 10 Einträge in
image_urls - nicht unterstützte Stufen wie
3Koder4Koder Seitenverhältnisse außerhalb der Liste oben
2.4 Beispielaufrufe in cURL und JavaScript
Hier eine minimale cURL-Anfrage für ein 16:9-Bild in der Stufe 1.5K:
curl --request POST \
--url https://api.apimart.ai/v1/images/generations \
--header "Authorization: Bearer $APIMART_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedream-5-0-pro",
"prompt": "A sunlit mountain trail in autumn, photorealistic, wide angle",
"resolution": "1.5K",
"size": "16:9"
}'
Die Antwort bestätigt nur den Task:
{
"code": 200,
"data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}
Und hier eine Bearbeitung mit mehreren Referenzen in Node.js mit fetch:
const response = await fetch("https://api.apimart.ai/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APIMART_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "seedream-5-0-pro",
prompt: "Replace the outfit in image 1 with the outfit in image 2",
image_urls: ["https://example.com/person.jpg", "https://example.com/dress.jpg"],
resolution: "2K",
size: "auto",
}),
});
const { data } = await response.json();
const taskId = data[0].task_id;
Führen Sie diese Aufrufe nur auf dem Server aus, nie im Client-Code.
3. Task abfragen und Bild speichern
3.1 Task-Status prüfen
Senden Sie GET https://api.apimart.ai/v1/tasks/{task_id} mit demselben Authorization-Header. Seedream 5.0 Pro setzt auf Qualität, ein Task kann daher einige Minuten dauern. Fragen Sie alle 5–10 Sekunden ab und setzen Sie das Client-Timeout auf etwa 5 Minuten.
Beenden Sie die Abfrage, wenn status completed oder failed lautet. Fehlgeschlagene Tasks werden vollständig erstattet.
3.2 Ergebnis auslesen
Ein abgeschlossener Task sieht so aus:
{
"code": 200,
"data": {
"id": "task_01JFXYZ123456789ABCDEF",
"status": "completed",
"progress": 100,
"result": {
"images": [
{
"url": ["https://cdn.example.com/images/image_task_xxx_0.png"],
"expires_at": 1784696685
}
]
}
}
}
Lesen Sie das Bild aus data.result.images[0].url[0]. Die Antwort enthält auch die Task-cost. Links gelten 72 Stunden (expires_at ist ein Unix-Zeitstempel). Laden Sie die Datei daher herunter und legen Sie sie in Ihrem eigenen Speicher ab, statt nur die URL zu speichern.
3.3 Vollständiges Beispiel in Python
import os
import time
import requests
BASE_URL = "https://api.apimart.ai"
headers = {
"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}",
"Content-Type": "application/json",
}
created = requests.post(
f"{BASE_URL}/v1/images/generations",
headers=headers,
json={
"model": "seedream-5-0-pro",
"prompt": "A product poster with the headline SUMMER SALE in bold letters",
"resolution": "1.5K",
"size": "3:4",
"output_format": "png",
},
timeout=30,
)
created.raise_for_status()
task_id = created.json()["data"][0]["task_id"]
while True:
task = requests.get(f"{BASE_URL}/v1/tasks/{task_id}", headers=headers, timeout=30).json()["data"]
if task["status"] == "completed":
image_url = task["result"]["images"][0]["url"][0]
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", task["status"]))
time.sleep(5)
with open("seedream-5-0-pro.png", "wb") as f:
f.write(requests.get(image_url, timeout=60).content)
4. Drei gängige Bild-Workflows
-
Poster und Grafiken mit Text. Setzen Sie den gewünschten Text in Anführungszeichen in den Prompt, beschreiben Sie das Layout (zum Beispiel „Hochformat-Poster, Überschrift oben“) und nutzen Sie
resolution: "1.5K"mit einem festen Verhältnis wie3:4. Wechseln Sie nur für finale Assets zu2K, da die 2K-Stufe mehr kostet. -
Bearbeitung mit mehreren Referenzen. Geben Sie Personen-, Produkt- oder Szenenbilder in
image_urlsan und nennen Sie sie im Prompt nach Reihenfolge („Bild 1“, „Bild 2“). Mitsize: "auto"folgt das Ausgabeformat den Referenzen. Mit<bbox>-Koordinaten legen Sie genau fest, wohin etwas soll. -
Ebenenzerlegung und transparente Bearbeitung. Senden Sie ein PNG oder JPEG mit
layer_decomposition: trueund Sie erhalten ein Basisbild plus bis zu 16 transparente PNG-Ebenen mit Positions- und Stapelangaben. Um eine einzelne Ebene zu bearbeiten, senden Sie sie mitbackground: "transparent"undoutput_format: "png"zurück. Ebenen-Tasks werden nach einer Vorautorisierung pro tatsächlich ausgegebenem Bild abgerechnet; zu viel Reserviertes wird erstattet.
5. Abschließende Checkliste für eine zuverlässige Seedream 5.0 Pro-Integration
Authentifizierung und Key-Sicherheit. Bewahren Sie den Key in einer Umgebungsvariable oder einem Secret Manager auf und rufen Sie die API nur aus dem Backend auf.
Parameter vor dem Senden prüfen. Verwenden Sie seedream-5-0-pro, lassen Sie n weg (oder setzen Sie 1), halten Sie image_urls bei höchstens 10 und nutzen Sie nur 1K, 1.5K oder 2K mit einer unterstützten size.
Auf den asynchronen Ablauf auslegen. Fragen Sie alle 5–10 Sekunden ab, setzen Sie ein Client-Timeout von etwa 5 Minuten und behandeln Sie Tasks mit failed.
Auslieferung als Speicherfrage behandeln. Laden Sie jedes Bild herunter, sobald der Task erfolgreich ist; Links laufen nach 72 Stunden ab.
Kosten prüfen, bevor Sie skalieren. Die Ausgabe wird pro Bild nach Pixelstufe abgerechnet (1K und 1.5K teilen sich den niedrigeren Preis, 2K kostet mehr), und jedes Referenzbild nach dem ersten kostet einen Aufpreis. Prüfen Sie vor großen Batches die aktuelle Preistabelle.
FAQs
Wie prüfe ich einen Bild-Task, nachdem ich eine task_id erhalten habe?
Senden Sie GET https://api.apimart.ai/v1/tasks/{task_id} mit Ihrem Authorization: Bearer-Header.
Fragen Sie alle 5–10 Sekunden ab, bis status completed lautet, und lesen Sie das Bild dann aus data.result.images[0].url[0]. Lautet der Status failed, prüfen Sie das Feld error; fehlgeschlagene Tasks werden erstattet.
Kann ich mehrere Bilder oder eine Base64-Ausgabe in einer Anfrage erhalten?
Nein. Seedream 5.0 Pro liefert ein Bild pro Anfrage, und n größer als 1 wird mit 400 abgelehnt. Für mehrere Varianten senden Sie mehrere Anfragen oder nutzen Seedream 5.0 Lite für Gruppengenerierung.
Das Ergebnis ist immer eine URL; mit output_format wählen Sie jpeg oder png. Base64 wird für Eingabebilder in image_urls unterstützt, nicht für die Ausgabe.
Wie verliere ich generierte Bilder am besten nicht?
Bildlinks gelten 72 Stunden, und expires_at im Ergebnis nennt den genauen Zeitpunkt.
Laden Sie jedes Bild in Ihren eigenen Speicher, sobald der Task completed erreicht, und protokollieren Sie die task_id selbst. Behandeln Sie die zurückgegebene URL nicht als dauerhaften Speicher.
Über das APIMart Team
Das APIMart Team schreibt Modell-Guides, Vergleiche und Preisanalysen für Entwickler, die mit KI bauen. APIMart bietet eine API für Chat-, Bild- und Videomodelle verschiedener Anbieter, sodass Sie die hier vorgestellten Modelle vor dem Launch direkt miteinander vergleichen können.
Wählen Sie Ihr gewünschtes Modell im Marktplatz
Testen Sie Chat-, Bild- und Videomodelle im APIMart-Marktplatz und erleben Sie Modellfunktionen schnell über eine einheitliche API.
