Ενσωμάτωση API για Wan 2.5 Video
Χρησιμοποιήστε το Wan 2.5 Video μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου wan-2-5-video, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.
wan-2-5-video
text, file
Απαιτείται για λειτουργίες αναφοράς
per_video · 720p_5=60 · 720p_10=120 · 1080p_5=100 · 1080p_10=200 · ⌈total⌉
Βίντεο
FIXED
800 χαρακτήρες
Σύμβαση αιτήματος
Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Περιγραφή |
|---|---|---|---|---|
| model | string | Ναι | wan-2-5-video | Χρησιμοποιήστε το wan-2-5-video ως αναγνωριστικό μοντέλου API. |
| prompt | string | Ναι | - | Μέγιστο 800 χαρακτήρες για αυτό το μοντέλο. |
| params | object | Όχι | - | Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά. |
| client_request_id | string | Όχι | - | Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα. |
Παράμετροι μοντέλου
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Εύρος | Επιλογές | Περιγραφή |
|---|---|---|---|---|---|---|
| resolution | select | Όχι | 720p | - | 720p, 1080p | Ανάλυση |
| duration | select | Όχι | 5 | - | 5, 10 | Διάρκεια |
| aspect_ratio | select | Όχι | 16:9 | - | 16:9, 9:16, 1:1 | Αναλογία πλευρών |
| enable_prompt_expansion | select | Όχι | false | - | false, true | Επειδή το Wan 2.5 είναι για σύντομα κλιπ που έχουν ήδη αρκετά συγκεκριμένη κατεύθυνση. Όταν συγκρίνεις παραλλαγές του ίδιου πλάνου, το seed βοηθά να μείνεις πιο κοντά σε επαναλήψιμη επιλογή, το αρνητικό prompt βοηθά να αφαιρέσεις κοινές αποτυχίες και η επέκταση prompt σε αφήνει να αποφασίσεις αν θα μείνεις κυριολεκτικός ή θα αφήσεις το μοντέλο να αναπτύξει λεπτομέρειες. Αυτός ο συνδυασμός είναι χρήσιμος όταν το κλιπ είναι μόνο 5 ή 10 δευτερόλεπτα, αλλά η κατεύθυνση είναι ήδη συγκεκριμένη. |
| seed | number | Όχι | - | min 0 / max 2147483647 | - | Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1. |
| negative_prompt | text | Όχι | - | - | - | Αρνητικό prompt |
Πολιτική μεταφόρτωσης
Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.
Εικόνα αναφοράς: Ανέβασε έως 1 αρχείο εικόνας για λειτουργία εικόνας σε βίντεο.
1
image
Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.
| kind | Μέγιστο μέγεθος | MIME types |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Ελάχιστο αίτημα
{
"model": "wan-2-5-video",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5",
"aspect_ratio": "16:9",
"enable_prompt_expansion": "false",
"seed": 0,
"negative_prompt": "Προαιρετικοί αποκλεισμοί ή τρόποι αποτυχίας προς αποφυγή."
}
}Αίτημα με αρχείο αναφοράς
{
"model": "wan-2-5-video",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5",
"aspect_ratio": "16:9",
"enable_prompt_expansion": "false",
"seed": 0,
"negative_prompt": "Προαιρετικοί αποκλεισμοί ή τρόποι αποτυχίας προς αποφυγή.",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Απόκριση δημιουργίας
Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.
{
"id": "task_wan_2_5_video_example",
"status": "queued",
"model": "wan-2-5-video",
"reserved_credits": 60,
"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.
