Documentation Rivya AI
Pages API par modèle

Intégration API Wan 2.7 Video

Utilisez Wan 2.7 Video via Rivya Public API v1 avec le model id wan-2-7-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-2-7-video

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

per_output_second · 720p=16 · 1080p=24 · ⌈total⌉

Capacité

Vidéo

Facturation

FIXED

Limite de prompt

5000 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éTypeObligatoirePar défautDescription
modelstringOuiwan-2-7-videoUtilisez wan-2-7-video comme ID de modèle API.
promptstringOui-Maximum 5000 caractères pour ce modèle.
paramsobjectNon-Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_idstringNon-ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

CléTypeObligatoirePar défautPlageOptionsDescription
resolutionselectNon720p-720p, 1080pRésolution
durationnumberNon5min 0 / max 15-text/image: integer 2–15 s; video edit: duration=0 or integer 2–10 s
aspect_ratioselectNon16:9-16:9, 9:16, 1:1, 4:3, 3:4Les générations à partir de texte et les retouches vidéo utilisent directement ce réglage. Pour une génération à partir d'image, le format suit celui du fichier importé et aucun sélecteur distinct n'est proposé.
negative_prompttextNon---prompt ≤ 5000; negative_prompt ≤ 500
prompt_extendselectNontrue-true, falseDétermine si le modèle réécrit votre invite avant la génération. Gardez cette option activée pour plus de confort, ou désactivez-la lorsque votre texte est déjà très précis.
watermarkselectNonfalse-false, trueFiligrane
audio_settingselectNonauto-auto, originContrôle la gestion de l'audio dans le parcours d'édition vidéo. Auto laisse le modèle décider, tandis que Conserver l'original essaie de préserver l'audio de la vidéo source.
seednumberNon-min 0 / max 2147483647-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

Médias de référence: Médias de référence: image: JPG/PNG/WebP ≤ 30 MB; video edit: 1 MP4/MOV ≤ 30 MB + 0–1 image; maximum 2 assets total.

Nombre max. de fichiers

2

Types de fichier acceptés

image, video

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.

kindTaille max.Types MIME
image30 MBimage/jpeg, image/png, image/webp
video30 MBvideo/mp4, video/quicktime

Requête minimale

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "negative_prompt": "negative_prompt ≤ 500",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0
  }
}

Requête avec fichier de référence

{
  "model": "wan-2-7-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "negative_prompt": "negative_prompt ≤ 500",
    "prompt_extend": "true",
    "watermark": "false",
    "audio_setting": "auto",
    "seed": 0,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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_2_7_video_example",
  "status": "queued",
  "model": "wan-2-7-video",
  "reserved_credits": 80,
  "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.