Έγγραφα Rivya AI
Σελίδες API μοντέλων

Wan 2.2 A14B Turbo API integration

Χρησιμοποιήστε το Wan 2.2 A14B Turbo μέσω Rivya Public API v1 με model id wan-2-2-a14b-turbo, υποστηριζόμενα inputs, παραμέτρους, κανόνες Files API, credits και παραδείγματα response.

Διαθέσιμο μέσω APIText ή URL ready. Τα reference modes χρησιμοποιούν Files APIΒίντεο
ID μοντέλου API

wan-2-2-a14b-turbo

Inputs

text, file

Files API

Απαιτείται για reference modes

Βασικές πιστώσεις

12

Δυνατότητα

Βίντεο

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

Σύμβαση αιτήματος

Στείλτε το model id στο top level. Τα model-specific controls ανήκουν στο params.

KeyΤύποςΥποχρεωτικόΠροεπιλογήΠεριγραφή
modelstringΝαιwan-2-2-a14b-turboΧρησιμοποιήστε το wan-2-2-a14b-turbo ως API model id.
promptstringΝαι-Μέγιστο 5000 χαρακτήρες για αυτό το μοντέλο.
paramsobjectΌχι-Model-specific parameter object. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα keys.
client_request_idstringΌχι-Προαιρετικό client-side id για tracing requests στο δικό σας σύστημα.

Παράμετροι μοντέλου

KeyΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
resolutionselectΌχι720p-480p, 580p, 720pΟι εκτελέσεις από κείμενο και εικόνα μένουν αυτήν τη στιγμή σε `480p / 720p`, ενώ η διαδρομή με οδηγό εικόνα συν ήχο εκθέτει επίσης `580p`. Η Rivya φιλτράρει αυτόματα τα μη υποστηριζόμενα επίπεδα με βάση την τρέχουσα λειτουργία.
aspect_ratioselectΌχι16:9-16:9, 9:16Παραμένει διαθέσιμη μόνο στο κείμενο σε βίντεο, επειδή τα τρέχοντα δημόσια endpoints για εικόνα και εικόνα συν ήχο δεν εκθέτουν σταθερό πεδίο `aspect_ratio`.
enable_prompt_expansionselectΌχιfalse-false, trueΕνεργοποίησέ το όταν θέλεις η upstream υπηρεσία να επεκτείνει ένα πρόχειρο prompt κειμένου πριν από τη δημιουργία. Παραμένει περιορισμένο σε εκτελέσεις από κείμενο και εικόνα.
seednumberΌχι-min 0 / max 2147483647-Αφήστε το κενό για ένα νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση ενός προηγούμενου αποτελέσματος. Παραμένει πιο κοντά μόνο όταν το prompt και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες και δεν εγγυάται αντιστοίχιση 1:1.
accelerationselectΌχιnone-none, regularΈνα ελαφρύτερο χειριστήριο επιτάχυνσης που παραμένει περιορισμένο στις δημόσιες λειτουργίες κειμένου και εικόνας.
num_framesnumberΌχι80min 40 / max 120 / step 1-Μόνο για διαδρομή με οδηγό εικόνα συν ήχο. Οι έγκυρες τιμές είναι 40 έως 120, και ο αριθμός πρέπει να διαιρείται με το 4. Ένα τυπικό σημείο εκκίνησης είναι το 80.
frames_per_secondnumberΌχι16min 4 / max 60 / step 1-Μόνο για διαδρομή με οδηγό εικόνα συν ήχο. Οι έγκυρες τιμές είναι 4 έως 60. Τα υψηλότερα FPS συνήθως δίνουν πιο ομαλή αίσθηση, αλλά αυξάνουν και την πίεση δημιουργίας.
negative_prompttextΌχι---Μόνο για διαδρομή με οδηγό εικόνα συν ήχο. Χρησιμοποίησέ το για να περιγράψεις αποτυχίες κίνησης, ανεπιθύμητα artifacts ή οπτικά στοιχεία που θέλεις να αποφύγεις.
num_inference_stepsnumberΌχι27min 2 / max 40 / step 1-Μόνο για διαδρομή με οδηγό εικόνα συν ήχο. Οι έγκυρες τιμές είναι 2 έως 40. Περισσότερα βήματα μπορούν να βελτιώσουν την ποιότητα, αλλά αυξάνουν και τον χρόνο εκτέλεσης.
guidance_scalenumberΌχι3.5min 1 / max 10 / step 0.1-Μόνο για διαδρομή με οδηγό εικόνα συν ήχο. Οι έγκυρες τιμές είναι 1 έως 10. Οι υψηλότερες τιμές ακολουθούν το prompt πιο στενά, αλλά μπορούν επίσης να κάνουν την κίνηση να μοιάζει πιο άκαμπτη.
shiftnumberΌχι5min 1 / max 10 / step 0.1-Μόνο για διαδρομή με οδηγό εικόνα συν ήχο. Οι έγκυρες τιμές είναι 1 έως 10. Αλλάζει την αίσθηση χρονικής μετατόπισης της δημιουργίας, οπότε είναι ασφαλέστερο να ξεκινήσεις κοντά στην προεπιλογή.
enable_safety_checkerselectΌχιtrue-true, falseΜόνο για διαδρομή με οδηγό εικόνα συν ήχο. Ενεργοποίησέ το για να τρέξουν έλεγχοι ασφάλειας πριν από τη δημιουργία ή απενεργοποίησέ το όταν χρειάζεσαι λιγότερο φιλτράρισμα και αποδέχεσαι τον συμβιβασμό.

Πολιτική μεταφόρτωσης

Ανεβάστε πρώτα reference files και μετά τοποθετήστε το returned URL και το duration token μέσα στο params.referenceMediaItems.

Κανόνας αναφοράς

Μέσα αναφοράς: Ανέβασε έως 2 στοιχεία. Η λειτουργία κειμένου δεν χρειάζεται κανένα, η εικόνα σε βίντεο χρησιμοποιεί 1 εικόνα, και η διαδρομή με οδηγό εικόνα συν ήχο χρησιμοποιεί 1 εικόνα και 1 ηχητικό κλιπ.

Max files

2

Αποδεκτοί τύποι αρχείων

image, audio

Token διάρκειας

Τα video και audio references πρέπει να μεταφέρουν durationToken από /api/v1/files όταν απαιτείται duration verification.

kindMax sizeMIME types
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

Ελάχιστο αίτημα

{
  "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": "Προαιρετικοί αποκλεισμοί ή τρόποι αποτυχίας προς αποφυγή.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

Αίτημα με αρχείο αναφοράς

{
  "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": "Προαιρετικοί αποκλεισμοί ή τρόποι αποτυχίας προς αποφυγή.",
    "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"
      }
    ]
  }
}

Απόκριση δημιουργίας

Το create endpoint επιστρέφει public task id. Κάντε poll στο status endpoint μέχρι το task να succeed ή fail.

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

Συνηθισμένα σφάλματα

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Ορισμένα modes απαιτούν reference uploads μέσω Files API.