Veo3.1 Quality API इंटीग्रेशन
Rivya Public API v1 के जरिए मॉडल ID veo3-1-quality, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Veo3.1 Quality का उपयोग करें।
veo3-1-quality
text, file
संदर्भ मोड के लिए जरूरी
150
वीडियो
FIXED
5000 अक्षर
रिक्वेस्ट संरचना
मॉडल ID को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | विवरण |
|---|---|---|---|---|
| model | string | हां | veo3-1-quality | veo3-1-quality API मॉडल ID का उपयोग करें। |
| prompt | string | हां | - | इस मॉडल के लिए अधिकतम 5000 अक्षर। |
| params | object | नहीं | - | मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत key के लिए नीचे दी गई पंक्तियां देखें। |
| client_request_id | string | नहीं | - | अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक क्लाइंट-साइड ID। |
मॉडल पैरामीटर
| कुंजी | प्रकार | जरूरी | डिफॉल्ट | सीमा | विकल्प | विवरण |
|---|---|---|---|---|---|---|
| aspectRatio | select | नहीं | 16:9 | - | 16:9, 9:16, Auto | आस्पेक्ट रेशियो |
| watermark | text | नहीं | - | - | - | Watermark text जोड़ें |
| seeds | number | नहीं | - | min 10000 / max 99999 / step 1 | - | हर बार नया यादृच्छिक नतीजा पाने के लिए इसे खाली छोड़ें। वही पूर्णांक दोबारा इस्तेमाल करने से पिछले नतीजे को दोहराना या बारीक समायोजित करना आसान होता है। नतीजा तभी ज्यादा करीब रहता है जब प्रॉम्प्ट और बाकी मुख्य सेटिंग भी मिलती-जुलती रहें; फिर भी यह 1:1 मिलान की गारंटी नहीं है। |
| enableTranslation | select | नहीं | true | - | true, false | Prompt translation नियंत्रण |
अपलोड नीति
पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और durationToken को params.referenceMediaItems में रखें।
Reference image जोड़ें: Supported image-led project के लिए 2 तक image files upload करें।
2
image
अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला durationToken होना चाहिए।
| kind | अधिकतम आकार | MIME प्रकार |
|---|---|---|
| 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": "Optional watermark text डालें",
"seeds": 10000,
"enableTranslation": "true"
}
}संदर्भ फाइल रिक्वेस्ट
{
"model": "veo3-1-quality",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"aspectRatio": "16:9",
"watermark": "Optional watermark text डालें",
"seeds": 10000,
"enableTranslation": "true",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Create रिस्पॉन्स
create एंडपॉइंट सार्वजनिक टास्क ID लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।
{
"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
कुछ मोड में Files API संदर्भ अपलोड जरूरी हैं।