Χρησιμοποιήστε το Veo3.1 Quality μέσω Rivya Public API v1 με model id veo3-1-quality, υποστηριζόμενα inputs, παραμέτρους, κανόνες Files API, credits και παραδείγματα response.

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

ID μοντέλου API

veo3-1-quality

Inputs

text, file

Files API

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

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

150

Δυνατότητα

Βίντεο

Χρέωση

FIXED

Όριο prompt

5000 χαρακτήρες

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

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

Key	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
model	string	Ναι	veo3-1-quality	Χρησιμοποιήστε το veo3-1-quality ως API model id.
prompt	string	Ναι	-	Μέγιστο 5000 χαρακτήρες για αυτό το μοντέλο.
params	object	Όχι	-	Model-specific parameter object. Χρησιμοποιήστε τις παρακάτω γραμμές για τα επιτρεπόμενα keys.
client_request_id	string	Όχι	-	Προαιρετικό client-side id για tracing requests στο δικό σας σύστημα.

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

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

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

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

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

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

Max files

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

image

Token διάρκειας

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

kind	Max size	MIME types
image	10 MB	image/jpeg, image/png, image/webp

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

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

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

{
  "model": "veo3-1-quality",
  "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"
      }
    ]
  }
}

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

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

{
  "id": "task_veo3_1_quality_example",
  "status": "queued",
  "model": "veo3-1-quality",
  "reserved_credits": 150,
  "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.

Veo3.1 Quality API integration