API Wan 3.0

Referência completa da API para os modelos de geração de vídeo Wan 3.0 da Alibaba.

Variantes do modelo

Esta API é compatível com quatro variantes do modelo:

Comparação rápida

Endpoint compartilhado

Todas as variantes do Wan 3.0 usam o endpoint de tarefas de vídeo:

POST /api/v1/video/task

Parâmetros compartilhados

Obrigatórios

Opcionais

Wan 3.0 de texto para vídeo

Defina model_name como "wan-3.0-text-to-video" e forneça os parâmetros compartilhados obrigatórios.

Exemplo de solicitação

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'wan-3.0-text-to-video',
    prompt: 'A cinematic tracking shot follows a cyclist through a rain-soaked neon city at night',
    duration: 8,
    resolution: '1080p',
    aspect_ratio: '16:9',
    sound: true,
    seed: 42
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Wan 3.0 de imagem para vídeo

Entradas de imagem obrigatórias

As duas imagens devem estar nos formatos JPEG, JPG, PNG sem canal alfa, BMP ou WEBP. Cada lado da imagem deve ter de 240 a 8000 pixels.

Exemplo de solicitação

javascriptCopiar
{
  model_name: 'wan-3.0-image-to-video',
  prompt: 'The camera glides forward as daylight gradually shifts into a warm evening glow',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  duration: 8,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 edição de vídeo

Entrada de vídeo obrigatória

A duração do vídeo de origem somada à duration de saída solicitada não deve exceder 30 segundos.

Exemplo de solicitação

javascriptCopiar
{
  model_name: 'wan-3.0-video-edit',
  prompt: 'Turn the daytime scene into a rainy evening while preserving the subject and camera movement',
  video_url: 'https://example.com/source-video.mp4',
  duration: 10,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  seed: 42
}

Wan 3.0 de referência para vídeo

As entradas de referência são opcionais e podem ser combinadas, exceto files e links, que não podem ser enviados juntos.

Entradas de referência opcionais

Exemplo de solicitação

javascriptCopiar
{
  model_name: 'wan-3.0-reference-to-video',
  prompt: 'Use the references to create a cinematic product launch with coordinated motion and sound',
  duration: 12,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  images: ['https://example.com/product-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/sound-reference.mp3'],
  links: ['https://example.com/public-creative-brief'],
  seed: 42
}

Para usar um arquivo de referência em vez de uma página da web, omita links e informe uma única URL em files.

Formato da resposta

Resposta inicial

Todos os modelos retornam um task_id para polling:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Resposta do polling

Faça polling de GET /api/v1/video/{taskId} para verificar o status:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valores de status

• submitted: Tarefa aceita e aguardando processamento
• processing: Geração do vídeo em andamento
• succeed: Geração do vídeo concluída
• failed: Falha na geração do vídeo

Práticas recomendadas

1. Orientação do prompt: descreva claramente os sujeitos, as ações, o movimento da câmera, o ritmo, o ambiente e a intenção sonora.
2. Entradas de imagem: use imagens iniciais, finais e de referência que correspondam à proporção solicitada. Imagens PNG não devem conter canal alfa.
3. Duração da edição de vídeo: verifique a duração da origem antes de escolher a duração de saída solicitada, para que o total permaneça dentro de 30 segundos.
4. Limites de referência: valide a quantidade, o formato, as dimensões e a duração combinada de cada conjunto de referências antes do envio.
5. Arquivos e links: envie um arquivo de referência ou um link de página da web pública, nunca ambos na mesma solicitação.