Reihe Seedream (Doubao)

Die Doubao-Bildmodelle von ByteDance, insgesamt drei. Sie werden über den OpenAI-kompatiblen Endpunkt /v1/images/generations aufgerufen; Text zu Bild und Bearbeitung laufen beide über diesen Endpunkt.

Modellwahl

Aktuelle Preise finden Sie auf der Modellseite .

Text zu Bild

import base64
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
 
resp = client.images.generate(
    model="volcengine/doubao-seedream-5.0-pro",
    prompt="Ein roter Apfel auf einem weißen Tisch",
    size="2560x1440",
)
 
with open("output.jpg", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

curl https://api.ofox.io/v1/images/generations \
  --max-time 600 \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volcengine/doubao-seedream-5.0-pro",
    "prompt": "Ein roter Apfel auf einem weißen Tisch",
    "size": "2560x1440"
  }' | jq -r '.data[0].b64_json' | base64 --decode > output.jpg

Das Ausgabeformat ist fest JPEG; speichern Sie mit der Endung .jpg. Standardmäßig wird base64 zurückgegeben; mit "response_format": "url" erhalten Sie stattdessen einen Bildlink.

Größe (size)

size kennt zwei Schreibweisen:

• Auflösungsstufen 1k, 2k, 4k (Groß-/Kleinschreibung egal): legen nur die Auflösung fest, das Seitenverhältnis bestimmt das Modell anhand des Prompts. Gemessen lieferte 4.5 mit 2k sowohl 2048×2048 als auch 1664×2496.
• Exakte Breite und Höhe WIDTHxHEIGHT: festes Seitenverhältnis; die Pixelzahl muss im Bereich der folgenden Tabelle liegen.

„—“ bedeutet: diesmal nicht gemessen; maßgeblich ist die offizielle Dokumentation von Volcano Engine Ark .

Gängige gültige Größen (erfüllen die Mindestpixelzahl von 4.5 und 5.0 Lite):

Bearbeitung und mehrere Referenzbilder

import base64
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
 
with open("apple.jpg", "rb") as f:
    ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()
 
resp = client.images.generate(
    model="volcengine/doubao-seedream-5.0-pro",
    prompt="Färbe den Apfel lila, lass alles andere unverändert",
    size="2k",
    extra_body={"image": [ref]},
)
 
with open("apple_purple.jpg", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

# Das base64 ist sehr lang; direkt in der Befehlszeile führt es zu Argument list too long, daher zuerst in eine Datei schreiben
printf 'data:image/jpeg;base64,%s' "$(base64 < apple.jpg | tr -d '\n')" > apple.b64
jq -n --rawfile img apple.b64 '{
  model: "volcengine/doubao-seedream-5.0-pro",
  prompt: "Färbe den Apfel lila, lass alles andere unverändert",
  size: "2k",
  image: [$img]
}' > body.json
 
curl https://api.ofox.io/v1/images/generations \
  --max-time 600 \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d @body.json | jq -r '.data[0].b64_json' | base64 --decode > apple_purple.jpg

• image ist ein Array; jeder Eintrag ist eine Bild-URL oder ein String, der mit data:image/...;base64, beginnt. Mehrere Referenzbilder legen Sie nacheinander in das Array und beschreiben im Prompt die Rolle jedes Bildes.
• input_images ist ein Feld nur für Qwen-Image und wird von Seedream nicht unterstützt.
• Seedream unterstützt /v1/images/edits nicht; zum Bearbeiten verwenden Sie das Feld image aus diesem Abschnitt.

Bildserien und mehrere Bilder

Beispiel für eine Bildserie:

{
  "model": "volcengine/doubao-seedream-5.0-lite",
  "prompt": "Generiere 3 separate Bilder: derselbe Fuchs jeweils im Frühling, Sommer und Herbst",
  "size": "2k",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": { "max_images": 3 }
}

• auto bedeutet, dass das Modell entscheidet, wie viele Bilder es generiert; max_images ist nur die Obergrenze. Gemessen setzte 4.5 bei derselben Anfrage einen Comic mit drei Feldern in ein einziges Bild und lieferte nur 1 Bild. Für eine feste Anzahl schreiben Sie ausdrücklich „Generiere N separate Bilder“ in den Prompt.
• Jedes Bild wird einzeln abgerechnet; usage.output_tokens ist die Summe über alle Bilder.

Wasserzeichen

Gemessen enthalten Bilder beim Aufruf über OfoxAI standardmäßig kein Wasserzeichen; zusätzliche Parameter sind nicht nötig.

Dauer

Gemessen dauert 2K etwa 12 bis 40 Sekunden, eine Serie aus 3 Bildern etwa 76 Sekunden. Empfohlen ist ein Client-Timeout von mindestens 300 Sekunden.

Häufige Fehler

Das Request id: 0217… am Ende der Fehlermeldung ist die Anfragenummer des Upstream-Anbieters; geben Sie sie bei Anfragen an den technischen Support zusammen mit der request_id aus der Antwort an.

The parameter `size` specified in the request is not valid: image size must be at least 3686400 pixels.
The parameter `size` specified in the request are not valid: image area must be at least 921600 pixels.
The parameter `size` specified in the request is not valid: image size must be at most 16777216 pixels.
The parameter `size` specified in the request is not valid: the specified size is not supported for model doubao-seedream-4-5.
The parameter `size` specified in the request are not valid: must be 'WIDTHxHEIGHT' or a supported size preset.
The parameter `size` specified in the request is not valid: size must be one of 'WIDTHxHEIGHT', '1k', '2k', or '4k'.
The parameter `sequential_image_generation` specified in the request are not valid: the parameter `sequential_image_generation` is not supported by the current model.
The parameter `output_format` specified in the request is not valid: the parameter `output_format` is not supported by the current model.

Offizielle Dokumentation

Die offizielle Dokumentation beschreibt das Verhalten bei direktem Aufruf von Volcano Engine Ark; beim Aufruf über OfoxAI gelten die gemessenen Ergebnisse dieser Seite.

• Dokumentationszentrum von Volcano Engine Ark 

Häufige Fragen