Skip to main content
POST
Verwenden Sie die OpenAI-kompatible Route POST /v1/images/generations von CometAPI, um die Seedream-Bildgenerierung auszuführen. Dieser Endpunkt unterstützt Text-zu-Bild-Prompts, Anfragen mit Referenzbildern und begrenzte sequenzielle Bildausgabe, wenn das ausgewählte Modell diese Steuerungen unterstützt. Diese Seite behandelt seedream-5-0-pro-260628 für Pro-Text-zu-Bild-Anfragen und seedream-5-0-260128 für Beispiele mit Referenzbildern, Sequenzen und Async in Seedream 5.0. Informationen zur Verfügbarkeit für Ihr Konto finden Sie auf der Models page oder per Abfrage von /v1/models. Details zu Provider-Parametern finden Sie in der BytePlus-image generation API und im Seedream 4.0-5.0 tutorial.

​
Wählen Sie eine Anfrageform

  • Text zu Bild: Senden Sie model, prompt, size und optionale Ausgabesteuerungen wie response_format, output_format und watermark.
  • Bild zu Bild: Fügen Sie image als Array öffentlicher HTTPS-URLs oder data-URIs hinzu. Verwenden Sie ein Array, auch wenn Sie nur ein Referenzbild senden.
  • Sequenzieller Prompt: Setzen Sie sequential_image_generation auf auto und verwenden Sie sequential_image_generation_options.max_images als Obergrenze. Das Modell kann weniger Bilder als das Maximum zurückgeben.
  • Async-Task: Fügen Sie async: true hinzu, wenn die Erstellungsanfrage data.task_id zurückgeben soll, anstatt die HTTP-Verbindung offen zu halten.
Referenzbilder plus generierte Bilder müssen innerhalb des Provider-Limits bleiben. Halten Sie sequenzielle Anfragen mit max_images begrenzt.

​
Führen Sie einen asynchronen Bild-Task aus

Setzen Sie async auf true für Bild-Jobs, die Ihr Client absenden und abfragen soll. Die Erstellungsanfrage gibt data.task_id zurück; verwenden Sie diesen Wert mit Retrieve a Seedream image task, bis data.status success oder failure ist. Verwenden Sie 2K in den Async-Beispielen für Seedream-5.0-Anfragen. Die Unterstützung für Größen variiert je nach model ID, wählen Sie daher eine vom Modell unterstützte Größe, bevor Sie einen asynchronen Task absenden.

​
Referenzbilder senden

Verwenden Sie data:image/png;base64,YOUR_BASE64_IMAGE für Inline-Bilddaten oder eine öffentliche HTTPS-URL, die der Provider abrufen kann. Die API-Referenzbeispiele zeigen die vollständige JSON-Struktur für jeden Anfragetyp.

​
Ausgabe-URLs lesen

Die zurückgegebene url ist ein signierter Objektspeicher-Link und kann &, % und andere Sonderzeichen enthalten. Extrahieren Sie die URL aus geparstem JSON, anstatt eine unvollständige Terminalzeile zu kopieren. In Shell-Beispielen bewahrt jq -r '.data[]?.url' die vollständige signierte URL.

Autorisierungen

​
Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Body

application/json

Parameters for Seedream image generation. Send JSON for text-to-image, image-to-image, and sequential prompt requests.

​
model
string
Standard:seedream-5-0-pro-260628
erforderlich

Seedream model ID to use. Query /v1/models or open the Models page for available model IDs.

​
prompt
string
Standard:A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.
erforderlich

Text prompt describing the image or edit goal. Use a concrete visual request, such as a blue ceramic mug on a white table, soft studio lighting.

​
response_format
enum<string>
Standard:url

Response image format. Use url for a temporary signed image URL, or b64_json when you need base64 image data in the response.

Verfügbare Optionen:
url,
b64_json
​
size
string
Standard:2K

Output resolution. Use a model-supported tier such as 2K or a model-supported WIDTHxHEIGHT value such as 2048x2048. Not every model ID accepts every tier.

​
image
string[]

Optional reference images for image-to-image generation. Each item can be a public HTTPS URL or a data URI such as data:image/png;base64,YOUR_BASE64_IMAGE. Use an array even for one image. Reference images plus generated images must not exceed the provider limit.

​
watermark
boolean
Standard:false

When true, requests a visible AI-generated watermark on the output image. Set false when your workflow handles disclosure separately.

​
async
boolean
Standard:false

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll the Seedream image task endpoint GET /v1/images/generations/{task_id} for the final image data.

​
output_format
enum<string>
Standard:png

Output image file format. Use png when you need lossless output, or jpeg for smaller files.

Verfügbare Optionen:
png,
jpeg
​
guidance_scale
number

Optional prompt-adherence control for model versions that support it. Higher values can follow the prompt more closely but may reduce naturalness. Omit this field when you do not need model-specific tuning.

Erforderlicher Bereich: 1 <= x <= 10
​
seed
integer
Standard:-1

Optional random seed for reproducible attempts on model versions that support seeding. Use -1 or omit the field for a random seed.

Erforderlicher Bereich: -1 <= x <= 2147483647
​
sequential_image_generation
enum<string>
Standard:disabled

Controls sequential prompt handling. Use auto to let the model return a sequence when the prompt calls for one. Use disabled for ordinary single-image requests.

Verfügbare Optionen:
auto,
disabled
​
sequential_image_generation_options
object

Options for sequential prompt handling. This object is only used when sequential_image_generation is auto.

Antwort

200 - application/json

Image generation response. Synchronous requests return completed image data. Async requests return a task response with data.task_id.

​
created
integer
erforderlich

Unix timestamp in seconds when the image response was created.

​
data
object[]
erforderlich

Generated image results. The array can contain one or more images depending on the request and model response.

​
usage
object

Usage information for the request. Fields vary by model and route.