Χρησιμοποιήστε το Wan 3.0 Video μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου wan-3-0-video, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

Διαθέσιμο μέσω APIΚείμενο ή URL έτοιμο. Οι λειτουργίες αναφοράς χρησιμοποιούν το Files APIΒίντεο

ID μοντέλου API

wan-3-0-video

Είσοδοι

text, file

Files API

Απαιτείται για λειτουργίες αναφοράς

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

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⌉

Δυνατότητα

Βίντεο

Χρέωση

METERED

Όριο prompt

20000 χαρακτήρες

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

Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	wan-3-0-video	Χρησιμοποιήστε το wan-3-0-video ως αναγνωριστικό μοντέλου API.
prompt	string	Ναι	-	Μέγιστο 20000 χαρακτήρες για αυτό το μοντέλο.
params	object	Όχι	-	Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

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

Κλειδί	Τύπος	Υποχρεωτικό	Προεπιλογή	Εύρος	Επιλογές	Περιγραφή
seedance_scene	select	Όχι	text	-	text, frames, reference	Επιλέξτε ένα αποκλειστικό συμβόλαιο εισόδου πριν μεταφορτώσετε πολυμέσα.
variant	select	Όχι	standard	-	standard, prime	Τα Standard και Prime χρησιμοποιούν τα ίδια στοιχεία ελέγχου αλλά διαφορετικές χρεώσεις ανά δευτερόλεπτο.
resolution	select	Όχι	1080P	-	480P, 720P, 1080P	Η κράτηση ισούται με την τιμή της παραλλαγής και της ανάλυσης επί το άθροισμα των επαληθευμένων δευτερολέπτων εισερχόμενου βίντεο και των δεσμευμένων δευτερολέπτων εξόδου· το σύνολο στρογγυλοποιείται προς τα πάνω μία φορά. Η έξυπνη διάρκεια δεσμεύει 30 δευτερόλεπτα εξόδου και δεν διατίθεται με βίντεο αναφοράς.
aspect_ratio	select	Όχι	adaptive	-	adaptive, 16:9, 4:3, 1:1, 3:4, 9:16	Επιλέξτε προσαρμοστικό καδράρισμα ή μία σταθερή αναλογία εξόδου.
duration	number	Όχι	5	min -1 / max 30 / step 1	-	Επιλέξτε -1 για έξυπνη διάρκεια ή έναν ακέραιο από 2 έως 30 δευτερόλεπτα. Η έξυπνη διάρκεια δεσμεύει 30 δευτερόλεπτα εξόδου και δεν μπορεί να χρησιμοποιηθεί με βίντεο αναφοράς.
audio	select	Όχι	true	-	true, false	Επιλέξτε αν το παραγόμενο βίντεο θα περιλαμβάνει ήχο που δημιουργείται από το μοντέλο.
seed	number	Όχι	-	min 0 / max 2147483647 / step 1	-	Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1.

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

Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.

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

Καρέ καθοδήγησης ή υπογεγραμμένες πολυτροπικές αναφορές: Το σενάριο καρέ δέχεται μία υποχρεωτική πρώτη εικόνα και μία προαιρετική τελευταία εικόνα. Το σενάριο αναφοράς δέχεται έως 10 εικόνες JPEG, PNG χωρίς διαφάνεια, WebP ή BMP των 20 MB η καθεμία, 5 βίντεο MP4/MOV των 95 MB και διάρκειας 1–15 δευτερολέπτων το καθένα και 5 ηχητικά κλιπ MP3/WAV των 15 MB και διάρκειας 1–15 δευτερολέπτων το καθένα· η συνολική διάρκεια βίντεο και ήχου περιορίζεται ξεχωριστά στα 15 δευτερόλεπτα.

Μέγιστος αριθμός αρχείων

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

image, video, audio

Token διάρκειας

Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.

kind	Μέγιστο μέγεθος	MIME types
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

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

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

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

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

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

Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.

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

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

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Ορισμένες λειτουργίες απαιτούν μεταφορτώσεις αναφοράς μέσω Files API.

Ενσωμάτωση API για Wan 3.0 Video