Geração Assíncrona de Vídeo Wan 2.6

Documentação da API

Use estes endpoints para submeter trabalhos Wan 2.6 e verificar o seu status. Cada chamada gasta créditos com base na duração e áudio (diálogos sincronizados, efeitos sonoros, música).

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://wan26ai.app/api/generate

Criar tarefa de geração

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

Parâmetro	Tipo	Obrigatório	Descrição
model	string	Sim	docs.params.model
prompt	string (max 5000 chars)	Sim	Descrição da cena principal (texto ou fluxo de imagem).
duration	string	Não	Duração da renderização em segundos ("5" ou "10").
resolution	string	Não	docs.params.resolution
image_urls	string[]	Não	URLs opcionais de imagens de referência (obrigatório para imagem para vídeo).
video_urls	string[]	Não	docs.params.video_urls
callback_url	string	Não	docs.params.callback_url
public	boolean	Não	Expor a tarefa a galerias públicas.

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

Exemplo de pedido

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

Exemplo de resposta

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

GET / POST

https://wan26ai.app/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. Enviar via query (?task_id=) ou corpo JSON.

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://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"
}

Exemplo de resposta

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

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.