Generación Asíncrona de Video Wan 2.6

Documentación de la API

Utiliza estos endpoints para enviar trabajos Wan 2.6 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://wan26ai.app/api/generate

Crear tarea de generación

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

Parámetro	Tipo	Requerido	Descripción
model	string	Sí	docs.params.model
prompt	string (max 5000 chars)	Sí	Descripción de la escena principal (texto o flujo de imagen).
duration	string	No	Duración del renderizado en segundos ("5" o "10").
resolution	string	No	docs.params.resolution
image_urls	string[]	No	URLs opcionales de imágenes de referencia (requerido para imagen a video).
video_urls	string[]	No	docs.params.video_urls
callback_url	string	No	docs.params.callback_url
public	boolean	No	Exponer la tarea a galerías públicas.

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
720p × 5s	80
720p × 10s	150
720p × 15s	220
1080p × 5s	115
1080p × 10s	220
1080p × 15s	325

Ejemplo de solicitud

{
  "model": "wan/2-6-text-to-video",
  "prompt": "A golden retriever running through a sunlit meadow, slow motion, cinematic",
  "duration": "5",
  "resolution": "1080p"
}

// Image-to-Video example:
{
  "model": "wan/2-6-image-to-video",
  "prompt": "Add gentle wind motion to the scene",
  "duration": "5",
  "resolution": "720p",
  "image_urls": ["https://example.com/reference.jpg"]
}

// Video-to-Video example:
{
  "model": "wan/2-6-video-to-video",
  "prompt": "Transform to anime style",
  "duration": "5",
  "resolution": "720p",
  "video_urls": ["https://example.com/source.mp4"]
}

Ejemplo de respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n35abc123def456wan26",
    "status": "IN_PROGRESS"
  }
}

GET / POST

https://wan26ai.app/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://wan26ai.app/api/status?task_id=n35abc123def456wan26
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://wan26ai.app/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n35abc123def456wan26"
}

Ejemplo de respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n35abc123def456wan26",
    "status": "SUCCESS",
    "request": {
      "model": "wan/2-6-text-to-video",
      "prompt": "A golden retriever running through a sunlit meadow",
      "duration": "5",
      "resolution": "1080p"
    },
    "response": [
      "https://static.gogloai.com/wan26/video_001.mp4"
    ],
    "consumed_credits": 115,
    "error_message": null,
    "created_at": "2025-12-17T10:30:00Z"
  }
}

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.