wan3.0-video API

Utilisez l’ID de modèle exact wan3.0-video. Le champ modèle doit correspondre exactement à cette page.

Exemple de sortiewan3.0-videoPOST /v1/videos5.0s

Paramètres : 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.

Requête qui a produit cet échantillon

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

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

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

Wan3.0 utilise input.prompt ou input.media avec les commandes de sortie dans parameters. Les médias peuvent représenter des images, des références, de l’audio, des fichiers ou des pages Web.

Champ	Obligatoire	Remarques
model	Oui	wan3.0-video
input.prompt	Conditionnel	Fournissez ceci ou input.media
input.media[]	Conditionnel	first_frame, last_frame, reference_*, file ou link
parameters.resolution	Non	480P / 720P / 1080P (par défaut 1080P)
parameters.ratio	Non	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / adaptive
parameters.duration	Non	2 à 30 secondes, ou -1 pour une durée automatique
parameters.audio	Non	S’il faut générer de l’audio synchronisé
parameters.prompt_extend	Non	Définir sur false lorsque ce contrat modèle dédié l’exige
parameters.seed	Non	Graine aléatoire facultative
parameters.watermark	Non	S’il faut ajouter un filigrane

Limites d’entrée et de sortie

Wan3.0 prend en charge le texte, les première/dernière images, jusqu’à 10 images de référence, 5 vidéos de référence, 5 clips audio de référence et une entrée de fichier ou de page Web. La sortie est 480P, 720P ou 1080P pendant 2 à 30 secondes ou synchronisation automatique -1. Les première/dernière images, les supports de référence, les fichiers et les pages Web sont des flux de travail mutuellement exclusifs sélectionnés par input.media[].type.

Exemples de flux de travail documentés

Wan3.0 utilise une enveloppe input/parameters pour le texte, le guidage de trame, les médias de référence, les fichiers et les pages Web ; ces flux de travail s’excluent mutuellement.

Première et dernière images

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édias de référence

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

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
wan3.0-video	Le modèle documenté sur cette page.