wan2.7-r2v API

Utilice el ID de modelo exacto wan2.7-r2v. El campo del modelo debe coincidir exactamente con esta página.

Salida de muestrawan2.7-r2vPOST /v1/videos5.0s

Parámetros: duration=5resolution=1080Pratio=16:9Imagen de referencia

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.

Solicitud que produjo este ejemplo, con la URL del medio de entrada reemplazada

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

Autenticación y punto final

Utilice una clave API de Modelflare con https://modelflare.dev/v1. El punto de entrada de la puerta de enlace es POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Crear una tarea

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}
  }'

Encuesta y descarga

Guardar el ID de la tarea. Sondear GET /v1/videos/{task_id} y descargar con GET /v1/videos/{task_id}/content. Las URL de resultados pueden caducar, así que transfiera el archivo lo antes posible.

bash

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

Solicitar notas

Wan comúnmente usa input y parameters; Los modos guiados por cuadros y los medios de referencia no deben mezclarse.

Solicitar parámetros

Wan2.7 R2V utiliza medios reference_image / reference_video y puede adjuntar reference_voice. No mezcle este flujo de trabajo con roles first_frame / last_frame.

Campo	Requerido	Notas
model	Sí	wan2.7-r2v
input.prompt	Sí	Describir la escena y los medios de referencia utilizando la sintaxis documentada.
input.media[]	Sí	Al menos un reference_image o reference_video
input.media[].reference_voice	No	URL pública WAV/MP3 para características de voz
parameters.resolution	No	720P / 1080P (predeterminado 1080P)
parameters.ratio	No	16:9 / 9:16 / 1:1 / 4:3 / 3:4 (ignorado cuando first_frame está presente)
parameters.duration	No	Utilice el límite de duración más corto cuando esté presente un vídeo de referencia
parameters.prompt_extend	No	Establecer falso cuando este contrato modelo dedicado lo requiera
parameters.watermark	No	Si se debe agregar una marca de agua
parameters.seed	No	Semilla aleatoria opcional

Límites de entrada y salida

R2V requiere al menos un reference_image o reference_video, con como máximo cinco imágenes/vídeos de referencia combinados. Se pueden conectar un first_frame y un reference_voice; el límite de duración es más corto cuando hay un vídeo de referencia.

Ejemplos de flujos de trabajo 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}
  }'

Errores y tareas fallidas

Los parámetros del modelo no válidos devuelven un 4xx con un ID de solicitud. Una tarea asincrónica también puede fallar después de que la creación sea exitosa; utilice error_code y error_message de la respuesta de la encuesta como motivo final de la tarea. No vuelva a intentar la misma solicitud con una forma JSON diferente.

Alcance soportado

Esta página cubre las llamadas de generación y edición de modelos de Modelflare. El enriquecimiento de mapas o búsquedas, la administración de voz y la administración de bibliotecas de elementos son API de recursos fuera de esta superficie pública de llamada de modelo y no son campos de solicitud obligatorios.

Precios y facturación

Este modelo utiliza facturación de video por segundo. Consulte la página de precios de modelos para conocer el precio actual para el cliente, el precio de lista de referencia y las especificaciones completas.

Nota

Esta página documenta la interfaz pública de Modelflare; Los campos y límites que se muestran aquí son el contrato actual.

Variantes

ID del modelo	Diferencia
wan2.7-r2v	El modelo documentado en esta página.