Seedream 5.5 AI

Referência para desenvolvedores

Documentação da API do Seedream 5 Pro

Crie imagens com o Seedream 5 Pro pela API assíncrona deste site. O Seedream 5.5 continua em prévia e ainda não pode ser chamado aqui.

Início rápido

  1. Crie uma chave na seção de chaves de API do espaço de trabalho.
  2. Envie model=seedream-5-pro e um prompt para POST /api/v1/images/generate.
  3. Use o data.task_id retornado para consultar GET /api/v1/images/status?task_id=TASK_ID com a mesma chave de API.

Autenticação

Envie Authorization: Bearer YOUR_API_KEY pelo seu servidor. Não é necessária uma sessão de navegador nem Cookie. Mantenha sua chave de API em sigilo.

Authorization: Bearer YOUR_API_KEY

Endpoints e campos da solicitação

POST /api/v1/images/generate

Envie um corpo JSON com model, prompt, aspect_ratio e resolution (1k ou 2k). O campo opcional image_urls aceita até 10 URLs de imagens de referência; public é um booleano opcional. A resposta contém code, message e data com task_id e status.

GET /api/v1/images/status?task_id=TASK_ID

A consulta com task_id retorna code, message e data com task_id, status, consumed_credits e image_urls (uma lista de URLs de imagens). Pode incluir error_message se a tarefa falhar.

O único modelo que pode ser chamado é seedream-5-pro

Continue consultando durante o processamento e leia image_urls ao concluir ou error_message em caso de falha.

Exemplo de cURL

Copie os comandos para o terminal, substitua YOUR_API_KEY pela sua chave de API privada e TASK_ID pelo data.task_id da primeira resposta.

curl -X POST https://seedream5-5ai.com/api/v1/images/generate -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' --data '{"model":"seedream-5-pro","prompt":"Um cartaz de cafeteria com letras claras e legíveis","aspect_ratio":"1:1","resolution":"1k","image_urls":[],"public":false}'

curl 'https://seedream5-5ai.com/api/v1/images/status?task_id=TASK_ID' -H 'Authorization: Bearer YOUR_API_KEY'