wan2.7-t2v API

Use o ID exato do modelo wan2.7-t2v. O campo do modelo deve corresponder exatamente a esta página.

Exemplo de saídawan2.7-t2vPOST /v1/videos5.0s

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

Prompt: One continuous take, no cuts. A glasshouse at night, rows of plants and misted panes. A figure in an emerald latex suit presses one palm flat against the glass; every drop of condensation on that wall begins running upward instead of down, gathering as it goes until the whole pane is a moving constellation of green and gold points that spreads to the roof panels overhead. The camera starts on the hand, pulls back through the planting and cranes up to take in the whole roof. One hard warm key from a work lamp on the floor, cold moonlight outside. Real weight and inertia, water surface tension on glass, no text.

Solicitação que produziu esta amostra

{
  "model": "wan2.7-t2v",
  "prompt": "One continuous take, no cuts. A glasshouse at night, rows of plants and misted panes. A figure in an emerald latex suit presses one palm flat against the glass; every drop of condensation on that wall begins running upward instead of down, gathering as it goes until the whole pane is a moving constellation of green and gold points that spreads to the roof panels overhead. The camera starts on the hand, pulls back through the planting and cranes up to take in the whole roof. One hard warm key from a work lamp on the floor, cold moonlight outside. Real weight and inertia, water surface tension on glass, 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": "wan2.7-t2v",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "prompt_extend": false}
  }'

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

Wan2.7 T2V centraliza em input.prompt e opcionalmente aceita input.audio_url. Descreva as mudanças na cena no prompt; não envie shot_type.

Campo	Obrigatório	Notas
model	Sim	wan2.7-t2v
input.prompt	Sim	Utilize o limite documentado na página oficial
input.negative_prompt	Não	Alerta negativo
input.audio_url	Não	WAV/MP3 público; omitir para deixar o modelo gerar áudio
parameters.resolution	Não	720P / 1080P (padrão 1080P)
parameters.ratio	Não	16:9 / 9:16 / 1:1 / 4:3 / 3:4
parameters.duration	Não	Duração do vídeo em segundos
parameters.prompt_extend	Não	Definir como falso quando este contrato de modelo dedicado exigir isso
parameters.watermark	Não	Se deve adicionar uma marca d’água
parameters.seed	Não	Semente aleatória opcional

Limites de entrada e saída

T2V emite 720P ou 1080P por 2 a 15 segundos. Omita input.audio_url para gerar áudio sincronizado; um WAV/MP3 fornecido é cortado ou deixa silêncio para corresponder à duração solicitada. Descreva o tempo de disparo múltiplo no prompt e não envie shot_type.

Exemplos de fluxo de trabalho documentados

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-t2v",
    "input": {"prompt": "从文字生成一段稳定的电影镜头"},
    "parameters": {"resolution": "1080P", "duration": 8, "prompt_extend": false}
  }'

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
wan2.7-t2v	O modelo documentado nesta página.