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 सह मदत हवी आहे?