Skip to main content
POST
cURL
Usa POST /v1/images/generations con async: true para enviar una tarea de imagen de Seedream sin mantener abierta la conexión HTTP. Este flujo de trabajo asíncrono se aplica a estos ID de modelo: Para conocer la disponibilidad de la cuenta, consulta la página de modelos o consulta /v1/models. Para obtener detalles sobre los parámetros del proveedor, consulta la API de BytePlus para generación de imágenes y el tutorial de Seedream 4.0-5.0.

Enviar la tarea

Envía model, prompt y async: true. El ejemplo también solicita una respuesta de URL 2K con watermark: false. La compatibilidad con tamaños varía según el ID de modelo, así que usa un tamaño compatible con el modelo seleccionado. La respuesta de creación devuelve data.task_id, data.status y un array data.data vacío mientras la tarea está pendiente. Almacena data.task_id; no uses el código de respuesta de nivel superior como identificador de la tarea.

Sondear la tarea

Pasa el ID de tarea almacenado a Recuperar una tarea de imagen de Seedream. Continúa sondeando mientras data.status sea pending. Detente cuando pase a ser success o failure.

Leer la URL de la imagen

Cuando una tarea se completa correctamente, lee data.data[0].url del JSON analizado. En la shell, jq -r '.data.data[0].url' conserva los caracteres especiales de la URL completa.Descarga o transfiere la imagen de inmediato. La URL es temporal; esta documentación no presupone una duración fija.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
model
string
requerido

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.

Ejemplo:

"doubao-seedream-5-0-260128"

prompt
string
requerido

Text prompt describing the image to generate.

Ejemplo:

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

async
boolean
requerido

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.

Ejemplo:

"2K"

response_format
string

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

Ejemplo:

"url"

watermark
boolean

Whether to request a visible watermark on the generated image.

Ejemplo:

false

Respuesta

200 - application/json

Seedream asynchronous task submission response.

code
string
requerido

Request status code. A successful submission returns success.

Ejemplo:

"success"

message
string
requerido

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

data
object
requerido
Última modificación el 31 de julio de 2026