Generación Asíncrona de Video Seedance 1.5 Pro

Documentación de la API

Utiliza estos endpoints para enviar trabajos Seedance 1.5 Pro y verificar su estado. Cada llamada consume créditos basados en la duración y el audio (diálogos sincronizados, efectos de sonido, música).

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://seedance1-5pro.com/api/generate

Crear tarea de generación

Envía un nuevo trabajo Seedance 1.5 Pro. 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 1000 chars)	Sí	Descripción de la escena principal (texto o flujo de imagen).
aspect_ratio	string	Sí	Soportado: 16:9, 9:16, 1:1. Se ignora cuando existe image_urls.
duration	string	Sí	Duración del renderizado en segundos ("5" o "10").
sound	boolean	No	Incluir audio en el clip (diálogos sincronizados, efectos de sonido, música).
image_urls	string[]	No	URLs opcionales de imágenes de referencia (requerido para imagen a video).

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
5 s sin audio	65
10 s sin audio	130
5 s con audio	130
10 s con audio	260

Ejemplo de solicitud

{
  "prompt": "Drone shot over neon night market",
  "aspect_ratio": "16:9",
  "duration": "5",
  "sound": false,
  "image_urls": [
    "https://cdn.example.com/reference/frame01.png"
  ]
}

Ejemplo de respuesta

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

GET / POST

https://seedance1-5pro.com/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. Enviar a través de query (?task_id=) o cuerpo JSON.

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://seedance1-5pro.com/api/status?task_id=sd15p_b6d54c8f4b4c4e8
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://seedance1-5pro.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "sd15p_b6d54c8f4b4c4e8"
}

Ejemplo de respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8",
    "status": "SUCCESS",
    "request": {
      "prompt": "Drone shot over neon night market",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": false
    },
    "response": [
      "https://static.gogloai.com/seedance15pro/clip_001.mp4"
    ],
    "consumed_credits": 65,
    "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.