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