APIMart
APIMart

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.

Tutorial

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_KEY hinzu
  • Ich setze model auf seedream-5-0-pro
  • Ich übergebe prompt sowie resolution (1K, 1.5K oder 2K) und size (auto oder ein Seitenverhältnis wie 16:9)
  • Zum Bearbeiten oder Kombinieren gebe ich bis zu 10 Referenzbilder in image_urls mit
  • Ich frage GET /v1/tasks/{task_id} alle 5–10 Sekunden ab, bis der Status completed lautet
  • 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.

APIMart
Seedream 5.0 Pro API: Spickzettel für Anfrage und Abfrage

Wichtigste Erkenntnisse

  • Seedream 5.0 Pro wird per POST an https://api.apimart.ai/v1/images/generations aufgerufen, 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

ElementWofür ich es nutzeWichtige Grenze oder Hinweis
Text-zu-BildNeue Bilder nur aus dem PromptKein Eingabebild nötig
Bearbeitung mit einer ReferenzHintergrund, Licht oder Details eines Bildes ändernEin Eintrag in image_urls
Bearbeitung mit mehreren ReferenzenPersonen, Outfits oder Szenen kombinierenBis zu 10 Referenzbilder
EbenenzerlegungEin Poster in bearbeitbare Ebenen aufteilenGenau ein Eingabebild, bis zu 16 PNG-Ebenen
Transparenter HintergrundEine Ebene bearbeiten und Alpha behaltenEin 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

APIMart

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:

HeaderWert
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/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

APIMart

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-pro wird 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.5K oder 2K. 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 wie 2048x1024. 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 ParameterTypWann verwenden
image_urlsArrayBearbeitung und Komposition mit mehreren Referenzen; bis zu 10 öffentliche URLs oder Base64-Data-URIs
output_formatStringjpeg (Standard) oder png
backgroundStringtransparent, um Alpha zu behalten, wenn Sie ein Bild mit vorhandenem Alphakanal bearbeiten (erfordert png)
layer_decompositionBooleanEin Bild in ein Basisbild und bis zu 16 transparente PNG-Ebenen zerlegen
optimize_prompt_optionsObjectPrompt-Optimierung; nur {"mode": "standard"} wird unterstützt
watermarkBooleanHinweis „KI-generiert“ unten rechts einfügen
nsfw_checkBooleanPrompt 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:

  • n größer als 1 oder sequential_image_generation (für Gruppenbilder Seedream 5.0 Lite verwenden)
  • stream oder tools (Streaming und Websuche werden nicht unterstützt)
  • mehr als 10 Einträge in image_urls
  • nicht unterstützte Stufen wie 3K oder 4K oder 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 wie 3:4. Wechseln Sie nur für finale Assets zu 2K, da die 2K-Stufe mehr kostet.

  • Bearbeitung mit mehreren Referenzen. Geben Sie Personen-, Produkt- oder Szenenbilder in image_urls an und nennen Sie sie im Prompt nach Reihenfolge („Bild 1“, „Bild 2“). Mit size: "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: true und Sie erhalten ein Basisbild plus bis zu 16 transparente PNG-Ebenen mit Positions- und Stapelangaben. Um eine einzelne Ebene zu bearbeiten, senden Sie sie mit background: "transparent" und output_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.

Tags#Seedream 5.0 Pro#Bildgenerierung#API-Tutorial#Entwickler

Ü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.

Bereit zum Ausprobieren?

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.

Chat-ModelleBildmodelleVideomodelle
Modellmarktplatz öffnen