API de imagens Seedream 5

Documentação da API

Use estes endpoints para gerar imagens Seedream 5 de forma assíncrona. O consumo de créditos depende da qualidade e do modo.

Autenticação

Todos os pedidos devem incluir a sua chave de API dentro do Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Chaves ausentes ou inválidas retornam 401 Unauthorized.

POST

https://seedream45ai.org/api/generate

Criar tarefa de geração

Submete um novo trabalho Seedream 5. A chamada retorna imediatamente um task_id enquanto a renderização é concluída de forma assíncrona.

Parâmetro	Tipo	Obrigatório	Descrição
prompt	string (max 1500 chars)	Sim	Descrição de texto principal (máximo de 1500 caracteres). Obrigatória em todas as solicitações.
aspectRatio	string	Sim	Proporções compatíveis: 1:1 · 3:4 · 4:3 · 9:16 · 16:9.
quality	string (basic \| high)	Sim	basic (rápido, 2K) ou high (mais detalhado, 4K).
imageUrls	string[]	Não	Imagens de referência opcionais. Obrigatórias no modo de edição.

Consumo de Crédito

Os créditos são deduzidos quando a tarefa é criada. Trabalhos falhados são automaticamente reembolsados.

Predefinição	Créditos deduzidos
Texto para imagem · Basic	12
Texto para imagem · High	18
Edição com referência · Basic	18
Edição com referência · High	24
Sequência de 4 imagens (uma chamada)	48

Exemplo de pedido

POST https://seedream45ai.org/api/generate
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
  "aspectRatio": "4:3",
  "quality": "high",
  "imageUrls": []
}

Exemplo de resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71"
  }
}

GET / POST

https://seedream45ai.org/api/status

Verificar status da tarefa

Use este endpoint para consultar o registro mais recente. Quando a tarefa ainda está em IN_PROGRESS, consultamos o provedor mais uma vez antes de responder.

Parâmetro	Tipo	Obrigatório	Descrição
task_id	string	Sim	ID retornado por /generate. Envie para /status pela consulta (?task_id=).

Campo	Descrição
task_id	ID retornado de /generate.
status	SUCCESS (SUCESSO)
request	Cópia higienizada do payload submetido.
response	Array de URLs de mídia quando o status é SUCCESS.
consumed_credits	Créditos cobrados pela tarefa (0 quando reembolsado).
error_message	Erro do provedor quando o status é FAILED.
created_at	Carimbo de data/hora UTC quando o trabalho foi armazenado.

Exemplo de pedido

GET https://seedream45ai.org/api/status?task_id=sd5_b83bf7c0c51a4c71
Authorization: Bearer <YOUR_API_KEY>

Exemplo de resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd5_b83bf7c0c51a4c71",
    "status": "SUCCESS",
    "request": {
      "prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
      "aspectRatio": "4:3",
      "quality": "high"
    },
    "response": [
      "https://watch_001.png"
    ],
    "consumed_credits": 12,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Tratamento de Erros

401 Unauthorized - Chave API ausente ou inválida.
402 Payment Required - O saldo de crédito não pôde cobrir a dedução.
429 Too Many Requests - Reduza a cadência de polling ou a taxa de pedidos.
500 - Problema transitório; tente novamente com backoff exponencial.