Documentation Rivya AI
Pages API par modèle

Intégration API Wan 2.2 A14B Turbo

Utilisez Wan 2.2 A14B Turbo via Rivya Public API v1 avec le model id wan-2-2-a14b-turbo, 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-2-a14b-turbo

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

12

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-2-a14b-turboUtilisez wan-2-2-a14b-turbo 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-480p, 580p, 720pLes générations texte et image restent actuellement sur `480p / 720p`, tandis que le parcours image-plus-audio expose aussi `580p`. Rivya filtre automatiquement les paliers non pris en charge selon le mode actuel.
aspect_ratioselectNon16:9-16:9, 9:16Ce réglage reste disponible uniquement en text-to-video, car les endpoints publics actuels image et image-plus-audio n'exposent pas de champ `aspect_ratio` stable.
enable_prompt_expansionselectNonfalse-false, trueActivez ce réglage lorsque vous voulez que le service amont développe un prompt texte approximatif avant la génération. Il reste limité aux générations texte et image.
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.
accelerationselectNonnone-none, regularContrôle d'accélération plus léger qui reste limité aux modes publics texte et image.
num_framesnumberNon80min 40 / max 120 / step 1-Uniquement pour le parcours image-plus-audio. Les valeurs valides vont de 40 à 120, et le nombre doit être divisible par 4. Un point de départ courant est 80.
frames_per_secondnumberNon16min 4 / max 60 / step 1-Uniquement pour le parcours image-plus-audio. Les valeurs valides vont de 4 à 60. Un FPS plus élevé semble généralement plus fluide, mais augmente aussi la pression de génération.
negative_prompttextNon---Uniquement pour le parcours image-plus-audio. Utilisez-le pour décrire les échecs de mouvement, les artefacts indésirables ou les éléments visuels à éviter.
num_inference_stepsnumberNon27min 2 / max 40 / step 1-Uniquement pour le parcours image-plus-audio. Les valeurs valides vont de 2 à 40. Des étapes plus élevées peuvent améliorer la qualité, mais augmentent aussi le temps d'exécution.
guidance_scalenumberNon3.5min 1 / max 10 / step 0.1-Uniquement pour le parcours image-plus-audio. Les valeurs valides vont de 1 à 10. Les valeurs plus élevées suivent le prompt de plus près, mais peuvent aussi rendre le mouvement plus rigide.
shiftnumberNon5min 1 / max 10 / step 0.1-Uniquement pour le parcours image-plus-audio. Les valeurs valides vont de 1 à 10. Ce réglage change la sensation de décalage temporel de la génération ; il est donc plus sûr de commencer près de la valeur par défaut.
enable_safety_checkerselectNontrue-true, falseUniquement pour le parcours image-plus-audio. Activez-la pour lancer des vérifications de sécurité avant la génération, ou désactivez-la lorsque vous avez besoin de moins de filtrage et acceptez ce compromis.

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: Importez jusqu'à 2 assets. Le mode texte n'en demande aucun, l'image-to-video utilise 1 image, et le parcours image-plus-audio utilise 1 image avec 1 clip audio.

Nombre max. de fichiers

2

Types de fichier acceptés

image, 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.

kindTaille max.Types MIME
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg, audio/flac, audio/x-ms-wma

Requête minimale

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Exclusions facultatives ou modes d'échec à éviter.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

Requête avec fichier de référence

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Exclusions facultatives ou modes d'échec à éviter.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true",
    "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_2_a14b_turbo_example",
  "status": "queued",
  "model": "wan-2-2-a14b-turbo",
  "reserved_credits": 12,
  "final_credits": 0,
  "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.