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
}

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
generationTypestringहाँजनरेशन प्रकार: text_to_video या image_to_video
promptstringहाँउस वीडियो का विवरण जो आप जनरेट करना चाहते हैं
aspectRatiostringनहींवीडियो पहलू अनुपात। डिफ़ॉल्ट: auto
imageUrlstringसशर्तयदि generationType image_to_video है तो आवश्यक
imageKeystringनहींअपलोड की गई छवियों के लिए स्टोरेज कुंजी

प्रतिक्रिया

{
  "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}

पैरामीटर

पैरामीटरप्रकारआवश्यकविवरण
uuidstringहाँजनरेशन अनुरोध से वीडियो 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
  }
}

सर्वोत्तम अभ्यास

  1. जिम्मेदार पोलिंग: वीडियो स्थिति हर 5-10 सेकंड में जांचें, लगातार नहीं
  2. त्रुटि हैंडलिंग: एक्सपोनेंशियल बैकऑफ के साथ रिट्राई लॉजिक लागू करें
  3. परिणाम कैश करें: पुनः जनरेशन से बचने के लिए जनरेट किए गए वीडियो स्टोर करें
  4. Webhooks का उपयोग करें: पूर्णता सूचनाओं के लिए पोलिंग से अधिक कुशल
  5. इनपुट मान्य करें: API कॉल से पहले प्रॉम्प्ट लंबाई और छवि प्रारूप जांचें

सहायता

API के साथ मदद चाहिए?