API सन्दर्भ
Veo 3.1 AI भिडियो जेनेरेशनको लागि पूर्ण API कागजात
अवलोकन
Veo 3.1 API ले तपाईंलाई टेक्स्ट विवरण वा छविहरूबाट प्रोग्रामेटिक रूपमा AI भिडियोहरू उत्पन्न गर्न अनुमति दिन्छ। हाम्रो RESTful API सरल, शक्तिशाली र तपाईंको अनुप्रयोगहरूमा सजिलै एकीकृत गर्न डिजाइन गरिएको छ।
आधार URL
https://veo3o1.com/apiप्रमाणीकरण
सबै API अनुरोधहरूलाई API कुञ्जी प्रयोग गरेर प्रमाणीकरण आवश्यक छ। तपाईंको API कुञ्जी Authorization हेडरमा समावेश गर्नुहोस्:
Authorization: Bearer YOUR_API_KEYतपाईं आफ्नो खाता ड्यासबोर्ड बाट API कुञ्जीहरू उत्पन्न गर्न सक्नुहुन्छ।
भिडियो उत्पन्न गर्नुहोस्
टेक्स्ट वा छविबाट नयाँ AI भिडियो सिर्जना गर्नुहोस्।
एन्डपोइन्ट
POST /generate-videoअनुरोध बडी
{
"generationType": "text_to_video" | "image_to_video",
"prompt": "Your video description",
"aspectRatio": "auto" | "16:9" | "9:16",
"imageUrl": "https://...", // Required if generationType is "image_to_video"
"imageKey": "r2-key" // Optional, for uploaded images
}प्यारामिटरहरू
| प्यारामिटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
generationType | string | हो | जेनेरेशन प्रकार: text_to_video वा image_to_video |
prompt | string | हो | तपाईंले उत्पन्न गर्न चाहनुभएको भिडियोको विवरण |
aspectRatio | string | होइन | भिडियो पक्ष अनुपात। पूर्वनिर्धारित: auto |
imageUrl | string | सशर्त | generationType image_to_video भएमा आवश्यक |
imageKey | string | होइन | अपलोड गरिएका छविहरूको लागि भण्डारण कुञ्जी |
प्रतिक्रिया
{
"code": 0,
"msg": "Success",
"data": {
"uuid": "video-uuid-123",
"status": "pending",
"generationType": "text_to_video",
"prompt": "Your video description",
"aspectRatio": "16:9",
"createdAt": "2025-10-16T10:00:00Z"
}
}उदाहरण
curl -X POST https://veo3o1.com/api/generate-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"generationType": "text_to_video",
"prompt": "A beautiful sunset over the ocean with waves gently lapping the shore",
"aspectRatio": "16:9"
}'भिडियो स्थिति प्राप्त गर्नुहोस्
भिडियो जेनेरेशन अनुरोधको स्थिति जाँच गर्नुहोस्।
एन्डपोइन्ट
GET /video-status/{uuid}प्यारामिटरहरू
| प्यारामिटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
uuid | string | हो | जेनेरेशन अनुरोधबाट भिडियो UUID |
प्रतिक्रिया
{
"code": 0,
"msg": "Success",
"data": {
"uuid": "video-uuid-123",
"status": "completed" | "pending" | "processing" | "failed",
"videoUrl": "https://...", // Available when status is "completed"
"progress": 85, // Processing progress (0-100)
"estimatedTime": 120 // Estimated seconds remaining
}
}स्थिति मानहरू
pending: भिडियो प्रशोधनको लागि लाममा छprocessing: भिडियो उत्पन्न भइरहेको छcompleted: भिडियो तयार छ र डाउनलोडको लागि उपलब्ध छfailed: जेनेरेशन असफल भयो (त्रुटि सन्देश जाँच गर्नुहोस्)
छवि अपलोड गर्नुहोस्
छविबाट भिडियो जेनेरेशनको लागि छवि अपलोड गर्नुहोस्।
एन्डपोइन्ट
POST /upload-video-imageअनुरोध
छवि फाइल अपलोड गर्न multipart/form-data प्रयोग गर्नुहोस्।
curl -X POST https://veo3o1.com/api/upload-video-image \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg"प्रतिक्रिया
{
"code": 0,
"msg": "Upload successful",
"data": {
"imageUrl": "https://...",
"imageKey": "r2-key-123"
}
}समर्थित ढाँचाहरू
- JPEG/JPG
- PNG
- WebP
- अधिकतम फाइल साइज: 50MB
त्रुटि कोडहरू
| कोड | विवरण |
|---|---|
| 0 | सफलता |
| 1000 | अमान्य प्यारामिटरहरू |
| 1001 | अपर्याप्त क्रेडिटहरू |
| 1002 | प्रमाणीकरण असफल |
| 1003 | दर सीमा नाघ्यो |
| 5000 | सर्भर त्रुटि |
त्रुटि प्रतिक्रिया उदाहरण
{
"code": 1001,
"msg": "Insufficient credits",
"data": {
"required": 2,
"current": 0
}
}उत्तम अभ्यासहरू
- जिम्मेवार पोलिङ: भिडियो स्थिति हरेक 5-10 सेकेन्डमा जाँच गर्नुहोस्, निरन्तर होइन
- त्रुटि ह्यान्डलिङ: एक्सपोनेन्सियल ब्याकअफसँग पुन: प्रयास तर्क लागू गर्नुहोस्
- नतिजाहरू क्यास गर्नुहोस्: पुन: जेनेरेशनबाट बच्न उत्पन्न भिडियोहरू भण्डारण गर्नुहोस्
- Webhooks प्रयोग गर्नुहोस्: पूर्णता सूचनाहरूको लागि पोलिङभन्दा बढी कुशल
- इनपुटहरू प्रमाणित गर्नुहोस्: API कलहरू अघि प्रम्प्ट लम्बाइ र छवि ढाँचाहरू जाँच गर्नुहोस्
समर्थन
API सँग मद्दत चाहिन्छ?