wan2.7-r2v API

Utilisez l’ID de modèle exact wan2.7-r2v. Le champ modèle doit correspondre exactement à cette page.

Exemple de sortiewan2.7-r2vPOST /v1/videos5.0s

Paramètres : duration=5resolution=1080Pratio=16:9Image de référence

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.

Requête qui a produit cet échantillon, avec l'URL du média d'entrée remplacée

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

Authentification et point de terminaison

Utilisez une clé API Modelflare avec https://modelflare.dev/v1. Le point d’entrée de la passerelle est POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Créer une tâche

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

Sondage et téléchargement

Enregistrez l’ID de la tâche. Sondez GET /v1/videos/{task_id} et téléchargez avec GET /v1/videos/{task_id}/content. Les URL des résultats peuvent expirer, alors transférez le fichier rapidement.

bash

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

Demander des notes

Wan utilise couramment input et parameters ; Les modes guidé par image et média de référence ne doivent pas être mélangés.

Paramètres de requête

Wan2.7 R2V utilise le support reference_image / reference_video et peut attacher reference_voice. Ne mélangez pas ce flux de travail avec les rôles first_frame / last_frame.

Champ	Obligatoire	Remarques
model	Oui	wan2.7-r2v
input.prompt	Oui	Décrire la scène et le média de référence en utilisant la syntaxe documentée
input.media[]	Oui	Au moins un reference_image ou reference_video
input.media[].reference_voice	Non	URL WAV/MP3 publique pour les caractéristiques vocales
parameters.resolution	Non	720P / 1080P (par défaut 1080P)
parameters.ratio	Non	16:9 / 9:16 / 1:1 / 4:3 / 3:4 (ignoré lorsque first_frame est présent)
parameters.duration	Non	Utiliser la limite de durée la plus courte lorsqu’une vidéo de référence est présente
parameters.prompt_extend	Non	Définir sur false lorsque ce contrat modèle dédié l’exige
parameters.watermark	Non	S’il faut ajouter un filigrane
parameters.seed	Non	Graine aléatoire facultative

Limites d’entrée et de sortie

R2V nécessite au moins un reference_image ou reference_video, avec au plus cinq images/vidéos de référence combinées. Un first_frame et un reference_voice peuvent être attachés ; la limite de durée est plus courte lorsqu’une vidéo de référence est présente.

Exemples de flux de travail documentés

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

Erreurs et tâches ayant échoué

Les paramètres de modèle invalides renvoient un 4xx avec un ID de demande. Une tâche asynchrone peut également échouer une fois la création réussie ; utilisez error_code et error_message de la réponse au sondage comme raison finale de la tâche. Ne réessayez pas la même requête avec une forme JSON différente.

Portée prise en charge

Cette page couvre la génération et l’édition de modèles Modelflare. L’enrichissement de la recherche ou de la carte, la gestion de la voix et la gestion de la bibliothèque d’éléments sont des API de ressources en dehors de cette surface d’appel de modèle publique et ne sont pas des champs de requête obligatoires.

Tarification et facturation

Ce modèle utilise la facturation vidéo à la seconde. Consultez la page de tarification du modèle pour connaître le prix client actuel, le prix catalogue de référence et les spécifications complètes.

Note

Cette page documente l’interface publique de Modelflare ; les champs et limites indiqués ici sont le contrat en cours.

Variantes

ID du modèle	Différence
wan2.7-r2v	Le modèle documenté sur cette page.