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 کے ساتھ مدد چاہیے؟
- 📧 ای میل: aiprocessingrobot@gmail.com
- 💬 سپورٹ سے رابطہ کریں