Skip to main content
POST
cURL
Gebruik POST /v1/images/generations met async: true om een Seedream-afbeeldingstaak in te dienen zonder de HTTP-verbinding open te houden. Deze asynchrone workflow is van toepassing op de volgende model-ID’s: Zie voor beschikbaarheid voor accounts de pagina Modellen of vraag /v1/models op. Zie voor details over providerparameters de BytePlus API voor het genereren van afbeeldingen en Seedream 4.0-5.0-tutorial.

De taak indienen

Verstuur model, prompt en async: true. In het voorbeeld wordt ook een 2K-URL-antwoord aangevraagd met watermark: false. Ondersteuning voor formaten verschilt per model-ID, dus gebruik een formaat dat door het geselecteerde model wordt ondersteund. Het antwoord voor het maken retourneert data.task_id, data.status en een lege array data.data terwijl de taak in afwachting is. Sla data.task_id op; gebruik niet de responscode op het hoogste niveau als taak-ID.

De taak pollen

Geef de opgeslagen taak-ID door aan Een Seedream-afbeeldingstaak ophalen. Blijf pollen zolang data.status gelijk is aan pending. Stop wanneer deze success of failure wordt.

De afbeeldings-URL lezen

Wanneer een taak slaagt, lees data.data[0].url uit geparseerde JSON. In de shell behoudt jq -r '.data.data[0].url' speciale tekens in de volledige URL.Download of draag de afbeelding snel over. De URL is tijdelijk; deze documentatie gaat niet uit van een vaste geldigheidsduur.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Body

application/json
model
string
vereist

Seedream model ID. This async workflow is documented for doubao-seedream-4-0-250828, doubao-seedream-4-5-251128, doubao-seedream-5-0-260128, and seedream-5-0-pro-260628. Query /v1/models or open the Models page for account availability.

Voorbeeld:

"doubao-seedream-5-0-260128"

prompt
string
vereist

Text prompt describing the image to generate.

Voorbeeld:

"A clean studio photograph of a small red ceramic teapot on a pale blue table, soft window light, no text."

async
boolean
vereist

Asynchronous task mode. Set this to true, store data.task_id, and poll the task endpoint.

size
string

Requested output size. Use a value supported by the selected model.

Voorbeeld:

"2K"

response_format
string

Response workflow for this async request. The example uses url and retrieves the URL from the completed task.

Voorbeeld:

"url"

watermark
boolean

Whether to request a visible watermark on the generated image.

Voorbeeld:

false

Respons

200 - application/json

Seedream asynchronous task submission response.

code
string
vereist

Request status code. A successful submission returns success.

Voorbeeld:

"success"

message
string
vereist

Status message. A successful submission can return an empty string.

data
object
vereist
Laatst gewijzigd op 31 juli 2026