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 کے ساتھ مدد چاہیے؟