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 के साथ मदद चाहिए?