Seedream 5.5 AI

Referencia para desarrolladores

Documentación de la API de Seedream 5 Pro

Crea imágenes con Seedream 5 Pro mediante la API asíncrona de este sitio. Seedream 5.5 sigue en vista previa y todavía no se puede invocar aquí.

Inicio rápido

  1. Crea una clave en la sección de claves API del espacio de trabajo.
  2. Envía model=seedream-5-pro y un prompt a POST /api/v1/images/generate.
  3. Usa el data.task_id recibido para consultar GET /api/v1/images/status?task_id=TASK_ID con la misma clave API.

Autenticación

Envía Authorization: Bearer YOUR_API_KEY desde tu servidor. No hace falta una sesión de navegador ni Cookie. Mantén tu clave API en privado.

Authorization: Bearer YOUR_API_KEY

Endpoints y campos de solicitud

POST /api/v1/images/generate

Envía un cuerpo JSON con model, prompt, aspect_ratio y resolution (1k o 2k). El campo opcional image_urls admite hasta 10 URL de imágenes de referencia; public es un booleano opcional. La respuesta contiene code, message y data con task_id y status.

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

La consulta con task_id devuelve code, message y data con task_id, status, consumed_credits e image_urls (un array de URL de imágenes). Puede incluir error_message si la tarea falla.

El único modelo que se puede invocar es seedream-5-pro

Sigue consultando mientras se procesa la tarea y lee image_urls al terminar o error_message si falla.

Ejemplo de cURL

Copia los comandos en tu terminal, sustituye YOUR_API_KEY por tu clave API privada y luego TASK_ID por el data.task_id de la primera respuesta.

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":"Un cartel de cafetería con letras claras y legibles","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'