Τεκμηρίωση Rivya AI
Σελίδες API μοντέλων

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

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

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

wan-2-7-video

Είσοδοι

text, file

Files API

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

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

80

Δυνατότητα

Βίντεο

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

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

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΠεριγραφή
modelstringΝαιwan-2-7-videoΧρησιμοποιήστε το wan-2-7-video ως αναγνωριστικό μοντέλου API.
promptstringΝαι-Μέγιστο 5000 χαρακτήρες για αυτό το μοντέλο.
paramsobjectΌχι-Αντικείμενο παραμέτρων ειδικό για το μοντέλο. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα κλειδιά.
client_request_idstringΌχι-Προαιρετικό client-side id για ιχνηλάτηση αιτημάτων στο δικό σας σύστημα.

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

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
resolutionselectΌχι720p-720p, 1080pΑνάλυση
durationselectΌχι5-5, 10, 15Οι εκτελέσεις κειμένου και εικόνας μπορούν να χρησιμοποιήσουν 5, 10 ή 15 δευτερόλεπτα. Η επεξεργασία βίντεο φτάνει αυτήν τη στιγμή έως 10 δευτερόλεπτα, και η Rivya κανονικοποιεί αυτόματα μεγαλύτερες επιλογές σε αυτήν τη λειτουργία.
aspect_ratioselectΌχι16:9-16:9, 9:16, 1:1, 4:3, 3:4Οι εκτελέσεις κειμένου σε βίντεο και video-edit το χρησιμοποιούν απευθείας. Η εικόνα σε βίντεο ακολουθεί αυτήν τη στιγμή τη γεωμετρία του ανεβασμένου καρέ αντί να εκθέτει ξεχωριστό διακόπτη αναλογίας πλευρών.
negative_prompttextΌχι---Αρνητικό prompt
prompt_extendselectΌχιtrue-true, falseΕλέγχει αν το μοντέλο ξαναγράφει το prompt σου πριν από τη δημιουργία. Κράτησέ το ενεργό για ευκολία ή απενεργοποίησέ το όταν έχεις ήδη πολύ ακριβές prompt.
watermarkselectΌχιfalse-false, trueΥδατογράφημα
audio_settingselectΌχιauto-auto, originΕλέγχει πώς αντιμετωπίζεται ο ήχος στη διαδρομή video-edit. Το Auto αφήνει το μοντέλο να αποφασίσει, ενώ το Keep original προσπαθεί να διατηρήσει τον ήχο του πηγαίου βίντεο.
seednumberΌχι-min 0 / max 2147483647-Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1.

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

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

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

Μέσα αναφοράς: Ανέβασε έως 2 assets. Χρησιμοποίησε έως 2 εικόνες για εικόνα σε βίντεο ή 1 βίντεο συν 1 προαιρετική εικόνα για επεξεργασία βίντεο.

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

2

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

image, video

Token διάρκειας

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

kindΜέγιστο μέγεθοςMIME types
image20 MBimage/jpeg, image/png, image/webp
video95 MBvideo/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.