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

Wan 2.7 Video API integration

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

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

wan-2-7-video

Inputs

text, file

Files API

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

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

80

Δυνατότητα

Βίντεο

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

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

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

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

KeyΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
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-Αφήστε το κενό για ένα νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση ενός προηγούμενου αποτελέσματος. Παραμένει πιο κοντά μόνο όταν το prompt και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες και δεν εγγυάται αντιστοίχιση 1:1.

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

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

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

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

Max files

2

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

image, video

Token διάρκειας

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

kindMax sizeMIME 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"
      }
    ]
  }
}

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

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

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

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