Skip to main content
POST
cURL
Use POST /v1/images/generations com async: true para enviar uma tarefa de imagem do Seedream sem manter a conexão HTTP aberta. Este fluxo de trabalho assíncrono se aplica a estes IDs de modelo: Para verificar a disponibilidade da conta, consulte a página de modelos ou consulte /v1/models. Para obter detalhes sobre os parâmetros do provedor, consulte a BytePlus API de geração de imagens e o tutorial do Seedream 4.0-5.0.

Enviar a tarefa

Envie model, prompt e async: true. O exemplo também solicita uma resposta de URL 2K com watermark: false. O suporte a tamanhos varia conforme o ID do modelo, portanto use um tamanho compatível com o modelo selecionado. A resposta de criação retorna data.task_id, data.status e uma matriz data.data vazia enquanto a tarefa está pendente. Armazene data.task_id; não use o código de resposta de nível superior como identificador da tarefa.

Consultar a tarefa

Passe o ID da tarefa armazenado para Recuperar uma tarefa de imagem do Seedream. Continue consultando enquanto data.status for pending. Pare quando se tornar success ou failure.

Ler a URL da imagem

Quando uma tarefa for bem-sucedida, leia data.data[0].url do JSON analisado. No shell, jq -r '.data.data[0].url' preserva caracteres especiais na URL completa.Baixe ou transfira a imagem imediatamente. A URL é temporária; esta documentação não pressupõe uma duração fixa.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
model
string
obrigatório

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.

Exemplo:

"doubao-seedream-5-0-260128"

prompt
string
obrigatório

Text prompt describing the image to generate.

Exemplo:

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

async
boolean
obrigatório

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.

Exemplo:

"2K"

response_format
string

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

Exemplo:

"url"

watermark
boolean

Whether to request a visible watermark on the generated image.

Exemplo:

false

Resposta

200 - application/json

Seedream asynchronous task submission response.

code
string
obrigatório

Request status code. A successful submission returns success.

Exemplo:

"success"

message
string
obrigatório

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

data
object
obrigatório
Última modificação em 31 de julho de 2026