Skip to main content
POST
cURL
Usa POST /v1/images/generations con async: true per inviare un’attività di immagini Seedream senza mantenere aperta la connessione HTTP. Questo flusso di lavoro asincrono si applica ai seguenti ID modello: Per la disponibilità dell’account, consulta la pagina Modelli oppure interroga /v1/models. Per i dettagli sui parametri del provider, consulta l’API di BytePlus per la generazione di immagini e il tutorial di Seedream 4.0-5.0.

Invia l’attività

Invia model, prompt e async: true. L’esempio richiede anche una risposta URL 2K con watermark: false. Il supporto delle dimensioni varia in base all’ID modello, quindi usa una dimensione supportata dal modello selezionato. La risposta di creazione restituisce data.task_id, data.status e un array data.data vuoto mentre l’attività è in sospeso. Memorizza data.task_id; non usare il codice di risposta di primo livello come identificatore dell’attività.

Esegui il polling dell’attività

Per passare l’ID dell’attività memorizzato, usa Recupera un’attività di immagini Seedream. Continua il polling finché data.status è pending. Interrompilo quando diventa success o failure.

Leggi l’URL dell’immagine

Quando un’attività ha esito positivo, leggi data.data[0].url dal JSON analizzato. Nella shell, jq -r '.data.data[0].url' preserva i caratteri speciali nell’URL completo.Scarica o trasferisci tempestivamente l’immagine. L’URL è temporaneo; questa documentazione non presuppone una durata fissa.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
model
string
obbligatorio

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.

Esempio:

"doubao-seedream-5-0-260128"

prompt
string
obbligatorio

Text prompt describing the image to generate.

Esempio:

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

async
boolean
obbligatorio

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.

Esempio:

"2K"

response_format
string

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

Esempio:

"url"

watermark
boolean

Whether to request a visible watermark on the generated image.

Esempio:

false

Risposta

200 - application/json

Seedream asynchronous task submission response.

code
string
obbligatorio

Request status code. A successful submission returns success.

Esempio:

"success"

message
string
obbligatorio

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

data
object
obbligatorio
Ultima modifica il 31 luglio 2026