Utilisez Wan 3.0 Video via Rivya Public API v1 avec le model id wan-3-0-video, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APITexte ou URL prêt ; les modes de référence utilisent Files APIVidéo

ID de modèle API

wan-3-0-video

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

per_input_and_output_second · standard_480P=8 · standard_720P=16 · standard_1080P=32 · prime_480P=12.2 · prime_720P=25.2 · prime_1080P=50.4 · ⌈total⌉

Capacité

Vidéo

Facturation

METERED

Limite de prompt

20000 caractères

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	wan-3-0-video	Utilisez wan-3-0-video comme ID de modèle API.
prompt	string	Oui	-	Maximum 20000 caractères pour ce modèle.
params	object	Non	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

Clé	Type	Obligatoire	Par défaut	Plage	Options	Description
seedance_scene	select	Non	text	-	text, frames, reference	Choisissez un contrat d’entrée exclusif avant d’importer des médias.
variant	select	Non	standard	-	standard, prime	Standard et Prime utilisent les mêmes réglages, mais des tarifs par seconde différents.
resolution	select	Non	1080P	-	480P, 720P, 1080P	La réservation multiplie le tarif de la variante et de la résolution par les secondes de vidéo d’entrée vérifiées plus les secondes de sortie réservées, puis arrondit le total une seule fois. La durée intelligente réserve 30 secondes de sortie et n’est pas disponible avec une vidéo de référence.
aspect_ratio	select	Non	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Choisissez un cadrage adaptatif ou un format de sortie fixe.
duration	number	Non	5	min -1 / max 30 / step 1	-	Choisissez -1 pour la durée automatique ou un nombre entier de 2 à 30 secondes. La durée automatique réserve 30 secondes de sortie et ne peut pas être utilisée avec une vidéo de référence.
audio	select	Non	true	-	true, false	Choisissez si la vidéo générée doit inclure un son créé par le modèle.
seed	number	Non	-	min 0 / max 2147483647 / step 1	-	Laissez ce champ vide pour obtenir un nouveau résultat aléatoire à chaque fois. Réutiliser le même entier facilite la reproduction ou l'ajustement fin d'un résultat précédent. Le résultat reste plus proche uniquement si le prompt et les autres réglages clés restent eux aussi similaires, et cela ne garantit pas une correspondance 1:1.

Règle d'importation

Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.

Règle de référence

Images guides ou références multimodales signées: Le scénario images exige une image de départ et accepte une image de fin facultative. Le scénario référence accepte jusqu’à 10 images JPEG, PNG sans transparence, WebP ou BMP de 20 MB chacune, 5 vidéos MP4/MOV de 95 MB et de 1 à 15 secondes chacune, ainsi que 5 séquences audio MP3/WAV de 15 MB et de 1 à 15 secondes chacune. Les durées cumulées de la vidéo et de l’audio sont chacune limitées à 15 secondes.

Nombre max. de fichiers

Types de fichier acceptés

image, video, audio

Duration token

Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.

kind	Taille max.	Types MIME
image	20 MB	image/jpeg, image/png, image/bmp, image/webp
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Requête minimale

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0
  }
}

Requête avec fichier de référence

{
  "model": "wan-3-0-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "variant": "standard",
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": "true",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Réponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

{
  "id": "task_wan_3_0_video_example",
  "status": "queued",
  "model": "wan-3-0-video",
  "reserved_credits": 160,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Certains modes exigent des importations de référence via Files API.

Intégration API Wan 3.0 Video