Seedream 5.0 Pro API-Leitfaden: Bilder per Code generieren und bearbeiten

Seedream 5.0 Pro API-Leitfaden

Die Seedream 5.0 Pro API bietet Entwicklern Zugriff auf das führende Bildgenerierungs- und Bildbearbeitungsmodell von ByteDance über einen produktionsorientierten asynchronen Workflow. Dieser Leitfaden zeigt, wie Sie Text-zu-Bild- und Bildbearbeitungsaufgaben über Poyo.ai übermitteln und anschließend das Ergebnis per Polling oder Webhook abrufen.

Der aktuelle Preis beträgt 15 Credits, etwa 0,075 $ pro generiertem Bild, für beide Modellvarianten.

API-Modelle und Parameter

Workflow	Modell-ID
Text zu Bild	`seedream-5.0-pro`
Bildbearbeitung	`seedream-5.0-pro-edit`

Unterstützte Eingaben:

prompt: erforderliche Anweisung zur Generierung oder Bearbeitung
size: ein Auflösungs-Preset wie 1K oder 2K oder ein Seitenverhältnis wie 1:1, 4:3, 3:4, 16:9 oder 9:16
n: Anzahl der zu generierenden Bilder
output_format: jpeg oder png
image_urls: Referenzbilder für das Edit-Modell, bis zu 10
callback_url: optionaler HTTPS-Endpunkt für Benachrichtigungen nach Abschluss

Siehe die Live-API-Referenz für das aktuelle Schema.

1. API-Key erstellen

Erstellen Sie ein Poyo.ai-Konto, öffnen Sie die API-Key-Verwaltung und speichern Sie den Schlüssel in einer Umgebungsvariable. Veröffentlichen Sie niemals einen Produktiv-Key im Browser-Code und übertragen Sie ihn nicht in ein Git-Repository.

export POYO_API_KEY="your-api-key"

2. Text-zu-Bild-Anfrage senden

Alle Aufgaben verwenden den einheitlichen Submit-Endpunkt:

POST https://api.poyo.ai/api/generate/submit

cURL

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header "Authorization: Bearer $POYO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "seedream-5.0-pro",
    "callback_url": "https://example.com/webhooks/poyo",
    "input": {
      "prompt": "Editorial science magazine cover about clean energy cities, title \"THE ELECTRIC CITY\", structured grid, accurate icons, dark navy and electric green palette",
      "size": "3:4",
      "n": 1,
      "output_format": "png"
    }
  }'

Die Antwort enthält eine Task-ID:

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "not_started",
    "created_time": "2026-07-16T10:10:00"
  }
}

3. Seedream 5.0 Pro mit JavaScript aufrufen

const API_URL = 'https://api.poyo.ai/api/generate/submit';

async function generateSeedreamImage(prompt) {
  const response = await fetch(API_URL, {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.POYO_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'seedream-5.0-pro',
      input: {
        prompt,
        size: '2K',
        n: 1,
        output_format: 'png',
      },
    }),
  });

  const payload = await response.json();
  if (!response.ok || payload.code !== 200) {
    throw new Error(payload.error?.message || 'Seedream request failed');
  }
  return payload.data.task_id;
}

Verwenden Sie 2K, wenn die Auflösung wichtiger ist als ein festes Seitenverhältnis. Nutzen Sie einen Wert für das Seitenverhältnis, wenn das Ausgabeformat die wichtigste Einschränkung darstellt.

4. Seedream 5.0 Pro mit Python aufrufen

import os
import requests

API_URL = "https://api.poyo.ai/api/generate/submit"

def generate_seedream_image(prompt: str) -> str:
    response = requests.post(
        API_URL,
        headers={
            "Authorization": f"Bearer {os.environ['POYO_API_KEY']}",
            "Content-Type": "application/json",
        },
        json={
            "model": "seedream-5.0-pro",
            "input": {
                "prompt": prompt,
                "size": "16:9",
                "n": 1,
                "output_format": "jpeg",
            },
        },
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()
    if payload.get("code") != 200:
        raise RuntimeError(payload.get("error", {}).get("message", "Request failed"))
    return payload["data"]["task_id"]

5. Bilder mit mehreren Referenzen bearbeiten

Wechseln Sie die Modell-ID und stellen Sie image_urls bereit. Beschreiben Sie dem Modell, welchen Beitrag jede Referenz leisten soll.

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header "Authorization: Bearer $POYO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "seedream-5.0-pro-edit",
    "input": {
      "prompt": "Use the room from reference 1. Replace only the chair with the chair from reference 2. Put the logo from reference 3 on the wall. Preserve the original camera, windows, floor, and afternoon lighting.",
      "image_urls": [
        "https://example.com/room.jpg",
        "https://example.com/chair.png",
        "https://example.com/logo.png"
      ],
      "size": "16:9",
      "n": 1,
      "output_format": "png"
    }
  }'

Für zuverlässige Bearbeitungen sollten Sie den Prompt in drei Bereiche aufteilen: Rollen der Referenzen, gewünschte Änderungen und zu erhaltende Eigenschaften.

6. Ergebnis abrufen

Die Übermittlung erfolgt asynchron. Nach Erhalt der task_id können Sie entweder:

den einheitlichen Task-Status-Endpunkt von Poyo.ai per Polling abfragen; oder
callback_url bereitstellen und den Abschluss-Webhook verarbeiten.

Folgen Sie der Dokumentation zur Aufgabenverwaltung für die aktuelle Status-Route und das Antwortobjekt. Verwenden Sie in Produktionsumgebungen exponentielles Backoff statt kontinuierlichem Polling.

Fehlerbehandlung

Behandeln Sie diese Fälle ausdrücklich:

400: ungültige Modellparameter, nicht unterstützte Größen, nicht erreichbare Bild-URLs oder fehlerhaftes JSON
401: fehlender oder ungültiger API-Key
fehlgeschlagene asynchrone Aufgabe: Generierung ist nach einer gültigen Übermittlung fehlgeschlagen
Webhook-Wiederholung: Dasselbe Abschlussereignis kann mehr als einmal zugestellt werden

Speichern Sie die Task-ID zusammen mit Ihrer internen Job-ID, gestalten Sie die Webhook-Verarbeitung idempotent und protokollieren Sie Anbieter-Fehlermeldungen, ohne Geheimnisse zu erfassen.

Checkliste für den produktiven Einsatz

Bewahren Sie API-Keys ausschließlich serverseitig auf.
Prüfen Sie Prompt-Länge und Bild-URL-Typen vor der Übermittlung.
Verwenden Sie HTTPS-Referenzbilder, auf die der Generierungsdienst zugreifen kann.
Legen Sie Timeouts für Übermittlungsanfragen fest.
Wiederholen Sie vorübergehende Netzwerkfehler, aber wiederholen Sie ungültige Anfragen nicht blind.
Verfolgen Sie Kosten als number of requested outputs × 15 credits bei der aktuellen Preisgestaltung.
Prüfen Sie generierten Text, Produktdetails und Faktenaussagen vor der Veröffentlichung.
Fügen Sie eine Inhaltsmoderation hinzu, die zu Ihrem Produkt und Markt passt.

Wann Pro statt Lite verwenden?

Verwenden Sie Seedream 5.0 Pro für strukturierte Designs, komplexe Layouts, mehrsprachigen Text und kontrollierte Bearbeitungen. Verwenden Sie Seedream 5.0 Lite für kostengünstigere Bildaufgaben mit höherem Volumen, bei denen die Designpräzision von Pro nicht erforderlich ist.

Für eine nicht technische Übersicht lesen Sie Seedream 5.0 Pro Funktionen und Preise. Sie können die API-Payload außerdem visuell auf der Seedream 5.0 Pro Modellseite testen.

Häufig gestellte Fragen

Was ist der Seedream 5.0 Pro API-Endpunkt?

Senden Sie Generierungs- und Bearbeitungsaufgaben an POST https://api.poyo.ai/api/generate/submit.

Was ist die Edit-Modell-ID?

Verwenden Sie seedream-5.0-pro-edit und fügen Sie einen oder mehrere Werte in input.image_urls ein.

Wie viele Referenzbilder werden unterstützt?

Die aktuelle Poyo.ai-Dokumentation unterstützt bis zu 10 Referenzbilder für die Seedream 5.0 Pro Bildbearbeitung.

Wie viel kostet ein API-Bild?

Der aktuelle Preis von Poyo.ai beträgt 15 Credits, etwa 0,075 $, für jedes generierte oder bearbeitete Bild.