wan3.0-video API

Use o ID exato do modelo wan3.0-video. O campo do modelo deve corresponder exatamente a esta página.

Exemplo de saídawan3.0-videoPOST /v1/videos5.0s

Parâmetros: duration=5resolution=1080Pratio=16:9

Prompt: Macro slow-motion shot of steamed milk poured into a ceramic cup of espresso, forming a rosetta latte art pattern. Warm morning light from a window, wooden counter, soft steam rising, shallow depth of field, commercial food photography, no text.

Solicitação que produziu esta amostra

{
  "model": "wan3.0-video",
  "prompt": "Macro slow-motion shot of steamed milk poured into a ceramic cup of espresso, forming a rosetta latte art pattern. Warm morning light from a window, wooden counter, soft steam rising, shallow depth of field, commercial food photography, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080P",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Autenticação e endpoint

Use uma chave de API Modelflare com https://modelflare.dev/v1. O ponto de entrada do gateway é POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Criar uma tarefa

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "audio": true}
  }'

Pesquisa e download

Salve o ID da tarefa. Enquete GET /v1/videos/{task_id} e download com GET /v1/videos/{task_id}/content. Os URLs de resultados podem expirar, portanto transfira o arquivo imediatamente.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Solicitar notas

Wan comumente usa input e parameters; os modos guiado por quadro e mídia de referência não devem ser misturados.

Parâmetros de solicitação

Wan3.0 usa input.prompt ou input.media com controles de saída em parameters. A mídia pode representar frames, referências, áudio, arquivos ou páginas da web.

Campo	Obrigatório	Notas
model	Sim	wan3.0-video
input.prompt	Condicional	Forneça isto ou input.media
input.media[]	Condicional	first_frame, last_frame, reference_*, file ou link
parameters.resolution	Não	480P / 720P / 1080P (padrão 1080P)
parameters.ratio	Não	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / adaptive
parameters.duration	Não	2–30 segundos ou -1 para duração automática
parameters.audio	Não	Se deve gerar áudio sincronizado
parameters.prompt_extend	Não	Definir como falso quando este contrato de modelo dedicado exigir isso
parameters.seed	Não	Semente aleatória opcional
parameters.watermark	Não	Se deve adicionar uma marca d’água

Limites de entrada e saída

Wan3.0 suporta texto, primeiro/último quadro, até 10 imagens de referência, 5 vídeos de referência, 5 clipes de áudio de referência e uma entrada de arquivo ou página da web. A saída é 480P, 720P ou 1080P por 2–30 segundos ou temporização automática -1. Primeiro/último quadro, mídia de referência, arquivos e páginas da web são fluxos de trabalho mutuamente exclusivos selecionados por input.media[].type.

Exemplos de fluxo de trabalho documentados

Wan3.0 usa um envelope input/parameters para texto, orientação de quadro, mídia de referência, arquivos e páginas da web; esses fluxos de trabalho são mutuamente exclusivos.

Primeiro e último frames

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "镜头从第一帧平滑推进到最后一帧", "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "ratio": "adaptive", "audio": true}
  }'

Mídia de referência

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "保持角色、动作和音色一致", "media": [
      {"type": "reference_image", "url": "https://example.com/character.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"},
      {"type": "reference_audio", "url": "https://example.com/voice.mp3"}
    ]},
    "parameters": {"resolution": "720P", "duration": -1, "ratio": "adaptive"}
  }'

Erros e tarefas com falha

Parâmetros de modelo inválidos retornam um 4xx com um ID de solicitação. Uma tarefa assíncrona também pode entrar com falha após a criação ser bem-sucedida; use error_code e error_message da resposta da enquete como o motivo final da tarefa. Não tente novamente a mesma solicitação com um formato JSON diferente.

Escopo suportado

Esta página cobre chamadas de geração e edição de modelo Modelflare. O enriquecimento de pesquisa ou mapa, gerenciamento de voz e gerenciamento de biblioteca de elementos são APIs de recursos fora dessa superfície pública de chamada de modelo e não são campos de solicitação obrigatórios.

Preços e cobrança

Este modelo utiliza cobrança de vídeo por segundo. Consulte a página de preços do modelo para obter o preço atual do cliente, a lista de preços de referência e as especificações completas.

Nota

Esta página documenta a interface pública do Modelflare; os campos e limites mostrados aqui são o contrato atual.

Variantes

ID do modelo	Diferença
wan3.0-video	O modelo documentado nesta página.