Skip to main content
POST
cURL
Bruk POST /v1/images/generations med async: true for å sende inn en Seedream-bildeoppgave uten å holde HTTP-tilkoblingen åpen. Denne asynkrone arbeidsflyten gjelder for disse modell-ID-ene: For tilgjengelighet for kontoen, se Models-siden eller spør etter /v1/models. Se BytePlus for detaljer om leverandørparametere API for bildegenerering og veiledningen for Seedream 4.0-5.0.

Send inn oppgaven

Send model, prompt og async: true. Eksempelet ber også om et 2K URL-svar med watermark: false. Størrelsesstøtten varierer etter modell-ID, så bruk en størrelse som støttes av den valgte modellen. Opprettelsessvaret returnerer data.task_id, data.status og en tom data.data-matrise mens oppgaven venter. Lagre data.task_id; ikke bruk svarkoden på øverste nivå som oppgaveidentifikator.

Spør etter oppgaven

Send den lagrede oppgave-ID-en til Hent en Seedream-bildeoppgave. Fortsett å spørre så lenge data.status er pending. Stopp når den blir success eller failure.

Les bilde-URL-en

Når en oppgave lykkes, les data.data[0].url fra parsede JSON-data. I shell bevarer jq -r '.data.data[0].url' spesialtegn i hele URL-en.Last ned eller overfør bildet raskt. URL-en er midlertidig; denne dokumentasjonen forutsetter ikke en fast levetid.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Kropp

application/json
model
string
påkrevd

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.

Eksempel:

"doubao-seedream-5-0-260128"

prompt
string
påkrevd

Text prompt describing the image to generate.

Eksempel:

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

async
boolean
påkrevd

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.

Eksempel:

"2K"

response_format
string

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

Eksempel:

"url"

watermark
boolean

Whether to request a visible watermark on the generated image.

Eksempel:

false

Svar

200 - application/json

Seedream asynchronous task submission response.

code
string
påkrevd

Request status code. A successful submission returns success.

Eksempel:

"success"

message
string
påkrevd

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

data
object
påkrevd
Sist endret 31. juli 2026