API de imágenes Seedream 5

Documentación de la API

Usa estos endpoints para generar imágenes Seedream 5 de forma asíncrona. Los créditos dependen de la calidad y el modo.

Autenticación

Todas las solicitudes deben incluir tu clave API dentro del Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Las claves faltantes o inválidas devuelven 401 Unauthorized.

POST

https://seedream45ai.org/api/generate

Crear tarea de generación

Envía un nuevo trabajo Seedream 5. La llamada devuelve inmediatamente un task_id mientras que el renderizado se completa de forma asíncrona.

Parámetro	Tipo	Requerido	Descripción
prompt	string (max 1500 chars)	Sí	Descripción de texto principal (máximo 1500 caracteres). Obligatoria en cada solicitud.
aspectRatio	string	Sí	Proporciones compatibles: 1:1 · 3:4 · 4:3 · 9:16 · 16:9.
quality	string (basic \| high)	Sí	basic (rápido, 2K) o high (más detallado, 4K).
imageUrls	string[]	No	Imágenes de referencia opcionales. Obligatorias en el modo de edición.

Consumo de Créditos

Los créditos se deducen cuando se crea la tarea. Los trabajos fallidos se reembolsan automáticamente.

Preajuste	Créditos deducidos
Texto a imagen · Basic	12
Texto a imagen · High	18
Edición con referencia · Basic	18
Edición con referencia · High	24
Serie de 4 imágenes (una llamada)	48

Ejemplo de solicitud

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": []
}

Ejemplo de respuesta

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

GET / POST

https://seedream45ai.org/api/status

Verificar estado de la tarea

Utiliza este endpoint para consultar el registro más reciente. Cuando la tarea aún está en IN_PROGRESS, consultamos al proveedor una vez más antes de responder.

Parámetro	Tipo	Requerido	Descripción
task_id	string	Sí	ID devuelto por /generate. Envíalo a /status mediante la consulta (?task_id=).

Campo	Descripción
task_id	ID devuelto desde /generate.
status	SUCCESS (ÉXITO)
request	Copia sanitizada del payload enviado.
response	Array de URLs de medios cuando el estado es SUCCESS.
consumed_credits	Créditos cobrados por la tarea (0 cuando se reembolsa).
error_message	Error del proveedor cuando el estado es FAILED.
created_at	Marca de tiempo UTC en que se almacenó el trabajo.

Ejemplo de solicitud

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

Ejemplo de respuesta

{
  "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"
  }
}

Manejo de Errores

401 Unauthorized - Clave API faltante o inválida.
402 Payment Required - El saldo de crédito no pudo cubrir la deducción.
429 Too Many Requests - Reduzca la cadencia de sondeo o la tasa de solicitudes.
500 - Problema transitorio; reintente con retroceso exponencial.