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

Ενσωμάτωση API για Veo3.1 Lite

Χρησιμοποιήστε το Veo3.1 Lite μέσω του Rivya Public API v1 με αναγνωριστικό μοντέλου veo3-1-lite, υποστηριζόμενες εισόδους, παραμέτρους, κανόνες Files API, credits και παραδείγματα απόκρισης.

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

veo3-1-lite

Είσοδοι

text, file

Files API

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

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

10

Δυνατότητα

Βίντεο

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

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

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

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

ΚλειδίΤύποςΥποχρεωτικόΠροεπιλογήΕύροςΕπιλογέςΠεριγραφή
aspectRatioselectΌχι16:9-16:9, 9:16, AutoΑναλογία πλευρών
watermarktextΌχι---Κείμενο υδατογραφήματος
seedsnumberΌχι-min 10000 / max 99999 / step 1-Αφήστε το κενό για νέο τυχαίο αποτέλεσμα κάθε φορά. Η επαναχρησιμοποίηση του ίδιου ακέραιου κάνει ευκολότερη την αναπαραγωγή ή τη λεπτομερή ρύθμιση προηγούμενου αποτελέσματος. Το αποτέλεσμα παραμένει πιο κοντά μόνο όταν η προτροπή και οι άλλες βασικές ρυθμίσεις μένουν επίσης παρόμοιες, και δεν εγγυάται αντιστοίχιση 1:1.
enableTranslationselectΌχιtrue-true, falseΜετάφραση prompt

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

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

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

Εικόνα αναφοράς: Ανέβασε έως 2 αρχεία εικόνας για το υποστηριζόμενο έργο με οδηγό εικόνα.

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

2

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

image

Token διάρκειας

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

kindΜέγιστο μέγεθοςMIME types
image10 MBimage/jpeg, image/png, image/webp

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

{
  "model": "veo3-1-lite",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Προαιρετικό κείμενο υδατογραφήματος",
    "seeds": 10000,
    "enableTranslation": "true"
  }
}

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

{
  "model": "veo3-1-lite",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "aspectRatio": "16:9",
    "watermark": "Προαιρετικό κείμενο υδατογραφήματος",
    "seeds": 10000,
    "enableTranslation": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_veo3_1_lite_example",
  "status": "queued",
  "model": "veo3-1-lite",
  "reserved_credits": 10,
  "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.