Ενσωμάτωση API για Wan 2.7 Video
Χρησιμοποιήστε το Wan 2.7 Video μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου wan-2-7-video, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.
wan-2-7-video
text, file
Απαιτείται για λειτουργίες αναφοράς
80
Βίντεο
FIXED
5000 χαρακτήρες
Σύμβαση αιτήματος
Στείλτε το αναγνωριστικό μοντέλου στο ανώτερο επίπεδο. Οι έλεγχοι που είναι ειδικοί για το μοντέλο ανήκουν στο params.
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Περιγραφή |
|---|---|---|---|---|
| model | string | Ναι | wan-2-7-video | Χρησιμοποιήστε το wan-2-7-video ως αναγνωριστικό μοντέλου API. |
| prompt | string | Ναι | - | Μέγιστο 5000 χαρακτήρες για αυτό το μοντέλο. |
| params | object | Όχι | - | Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά. |
| client_request_id | string | Όχι | - | Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα. |
Παράμετροι μοντέλου
| Κλειδί | Τύπος | Υποχρεωτικό | Προεπιλογή | Εύρος | Επιλογές | Περιγραφή |
|---|---|---|---|---|---|---|
| resolution | select | Όχι | 720p | - | 720p, 1080p | Ανάλυση |
| duration | select | Όχι | 5 | - | 5, 10, 15 | Οι εκτελέσεις κειμένου και εικόνας μπορούν να χρησιμοποιήσουν 5, 10 ή 15 δευτερόλεπτα. Η επεξεργασία βίντεο φτάνει αυτήν τη στιγμή έως 10 δευτερόλεπτα, και η Rivya κανονικοποιεί αυτόματα μεγαλύτερες επιλογές σε αυτήν τη λειτουργία. |
| aspect_ratio | select | Όχι | 16:9 | - | 16:9, 9:16, 1:1, 4:3, 3:4 | Οι εκτελέσεις κειμένου σε βίντεο και video-edit το χρησιμοποιούν απευθείας. Η εικόνα σε βίντεο ακολουθεί αυτήν τη στιγμή τη γεωμετρία του ανεβασμένου καρέ αντί να εκθέτει ξεχωριστό διακόπτη αναλογίας πλευρών. |
| negative_prompt | text | Όχι | - | - | - | Αρνητικό prompt |
| prompt_extend | select | Όχι | true | - | true, false | Ελέγχει αν το μοντέλο ξαναγράφει το prompt σου πριν από τη δημιουργία. Κράτησέ το ενεργό για ευκολία ή απενεργοποίησέ το όταν έχεις ήδη πολύ ακριβές prompt. |
| watermark | select | Όχι | false | - | false, true | Υδατογράφημα |
| audio_setting | select | Όχι | auto | - | auto, origin | Ελέγχει πώς αντιμετωπίζεται ο ήχος στη διαδρομή video-edit. Το Auto αφήνει το μοντέλο να αποφασίσει, ενώ το Keep original προσπαθεί να διατηρήσει τον ήχο του πηγαίου βίντεο. |
| seed | number | Όχι | - | min 0 / max 2147483647 | - | Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1. |
Πολιτική μεταφόρτωσης
Ανεβάστε πρώτα αρχεία αναφοράς και μετά τοποθετήστε το URL που επιστράφηκε και το duration token μέσα στο params.referenceMediaItems.
Μέσα αναφοράς: Ανέβασε έως 2 assets. Χρησιμοποίησε έως 2 εικόνες για εικόνα σε βίντεο ή 1 βίντεο συν 1 προαιρετική εικόνα για επεξεργασία βίντεο.
2
image, video
Οι αναφορές βίντεο και ήχου πρέπει να μεταφέρουν `durationToken` από το /api/v1/files όταν απαιτείται επαλήθευση διάρκειας.
| kind | Μέγιστο μέγεθος | MIME types |
|---|---|---|
| image | 20 MB | image/jpeg, image/png, image/webp |
| video | 95 MB | video/mp4, video/quicktime |
Ελάχιστο αίτημα
{
"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": "Προαιρετικοί αποκλεισμοί ή τρόποι αποτυχίας προς αποφυγή.",
"prompt_extend": "true",
"watermark": "false",
"audio_setting": "auto",
"seed": 0
}
}Αίτημα με αρχείο αναφοράς
{
"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": "Προαιρετικοί αποκλεισμοί ή τρόποι αποτυχίας προς αποφυγή.",
"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"
}
]
}
}Απόκριση δημιουργίας
Το τελικό σημείο δημιουργίας επιστρέφει δημόσιο αναγνωριστικό εργασίας. Ελέγχετε περιοδικά το τελικό σημείο κατάστασης μέχρι η εργασία να ολοκληρωθεί με επιτυχία ή να αποτύχει.
{
"id": "task_wan_2_7_video_example",
"status": "queued",
"model": "wan-2-7-video",
"reserved_credits": 80,
"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
Ορισμένες λειτουργίες απαιτούν μεταφορτώσεις αναφοράς μέσω Files API.