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 सँग मद्दत चाहिन्छ?