Skip to main content
POST
cURL
Utilisez POST /v1/images/generations avec async: true pour soumettre une tâche d’image Seedream sans maintenir la connexion HTTP ouverte. Ce flux de travail asynchrone s’applique aux ID de modèle suivants : Pour connaître la disponibilité de votre compte, consultez la page Modèles ou interrogez /v1/models. Pour plus de détails sur les paramètres du fournisseur, consultez l’API BytePlus de génération d’images et le tutoriel Seedream 4.0-5.0.

Soumettre la tâche

Envoyez model, prompt et async: true. L’exemple demande également une réponse d’URL 2K avec watermark: false. La prise en charge des tailles varie selon l’ID de modèle ; utilisez donc une taille prise en charge par le modèle sélectionné. La réponse de création renvoie data.task_id, data.status et un tableau data.data vide tant que la tâche est en attente. Enregistrez data.task_id ; n’utilisez pas le code de réponse de niveau supérieur comme identifiant de tâche.

Interroger la tâche

Transmettez l’ID de tâche enregistré à Récupérer une tâche d’image Seedream. Continuez à interroger la tâche tant que data.status est pending. Arrêtez lorsqu’il devient success ou failure.

Lire l’URL de l’image

Lorsqu’une tâche réussit, lisez data.data[0].url dans le JSON analysé. Dans le shell, jq -r '.data.data[0].url' préserve les caractères spéciaux de l’URL complète.Téléchargez ou transférez l’image sans tarder. L’URL est temporaire ; cette documentation ne suppose pas de durée de validité fixe.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json
model
string
requis

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.

Exemple:

"doubao-seedream-5-0-260128"

prompt
string
requis

Text prompt describing the image to generate.

Exemple:

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

async
boolean
requis

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.

Exemple:

"2K"

response_format
string

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

Exemple:

"url"

watermark
boolean

Whether to request a visible watermark on the generated image.

Exemple:

false

Réponse

200 - application/json

Seedream asynchronous task submission response.

code
string
requis

Request status code. A successful submission returns success.

Exemple:

"success"

message
string
requis

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

data
object
requis
Dernière modification le 31 juillet 2026