wan2.7-r2v API

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

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

Parâmetros: duration=5resolution=1080Pratio=16:9Imagem de referência

Prompt: One continuous take, no cuts. Keep the glass flowers from the reference exactly as they are and carry them into a new place: a wide city crossing at night in the rain. The whole bed of glass blooms now grows straight out of the wet asphalt across the junction, ringing as the rain strikes them, headlights firing caustics along the road. The camera starts at kerb height among the stems, moves forward through them and rises to look down the length of the crossing. One hard pink key from a shopfront on the left, cold blue signals behind. Real weight and inertia, glass and water, no text.

Solicitação que produziu esta amostra, com a URL da mídia de entrada substituída

{
  "model": "wan2.7-r2v",
  "input": {
    "prompt": "One continuous take, no cuts. Keep the glass flowers from the reference exactly as they are and carry them into a new place: a wide city crossing at night in the rain. The whole bed of glass blooms now grows straight out of the wet asphalt across the junction, ringing as the rain strikes them, headlights firing caustics along the road. The camera starts at kerb height among the stems, moves forward through them and rises to look down the length of the crossing. One hard pink key from a shopfront on the left, cold blue signals behind. Real weight and inertia, glass and water, no text.",
    "media": [
      {
        "type": "reference_image",
        "url": "https://example.com/input-image.png"
      }
    ]
  },
  "parameters": {
    "duration": 5,
    "resolution": "1080P",
    "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-r2v",
    "input": {"prompt": "The subject in Image 1 walks through the street from Video 1.", "media": [{"type": "reference_image", "url": "https://example.com/reference.png"}, {"type": "reference_video", "url": "https://example.com/reference.mp4"}]},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "duration": 5, "prompt_extend": false, "watermark": 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 R2V usa mídia reference_image / reference_video e pode anexar reference_voice. Não misture esse fluxo de trabalho com funções first_frame/last_frame.

Campo	Obrigatório	Notas
model	Sim	wan2.7-r2v
input.prompt	Sim	Descreva a cena e a mídia de referência usando a sintaxe documentada
input.media[]	Sim	Pelo menos um reference_image ou reference_video
input.media[].reference_voice	Não	URL WAV/MP3 público para características de voz
parameters.resolution	Não	720P / 1080P (padrão 1080P)
parameters.ratio	Não	16:9 / 9:16 / 1:1 / 4:3 / 3:4 (ignorado quando first_frame está presente)
parameters.duration	Não	Use o limite de duração mais curto quando um vídeo de referência estiver presente
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

R2V requer pelo menos um reference_image ou reference_video, com no máximo cinco imagens/vídeos de referência combinados. Um first_frame e um reference_voice podem ser anexados; o limite de duração é menor quando um vídeo de referência está presente.

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-r2v",
    "input": {"prompt": "让图像主体沿视频动作自然移动", "media": [
      {"type": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"}
    ]},
    "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-r2v	O modelo documentado nesta página.