logo Omni Video

اوپن API

امیج / ویڈیو جنریشن ٹاسکس بنانے کے لیے REST API۔ اپنے اکاؤنٹ پیج سے sk- کی کے ساتھ تصدیق کریں۔

API کیز کا انتظام کریں

تصدیق

تمام درخواستوں کے لیے بیئرر ٹوکن درکار ہے۔ اپنے اکاؤنٹ پیج سے ایک بنائیں۔

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

دستیاب ماڈلز

نیچے دی گئی model_id ویلیوز ہی اوپن API کے ذریعے قبول کی جاتی ہیں۔

model_idصلاحیتآؤٹ پٹ
seedance-2Seedance 2.0 (text / image to video)video_url
gpt-image-2ChatGPT Image 2 (text / image to image)image_url
nano-banana-2Nano Banana 2 (text / image to image)image_url

ٹاسک بنائیں

جنریشن کی درخواست جمع کروائیں۔ جواب میں ایک task_id ملے گا جسے آپ پول کر سکتے ہیں۔

POST /api/v1/tasks/create

درخواست کا باڈی

{
  "model_id": "gpt-image-2",
  "prompt": "a serene zen garden at sunrise, ultra detailed",
  "image_urls": [],
  "aspect_ratio": "16:9"
}

cURL مثال

curl -X POST https://your-site.com/api/v1/tasks/create \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "gpt-image-2",
    "prompt": "a serene zen garden at sunrise",
    "aspect_ratio": "16:9"
  }'

جواب

{
  "code": 200,
  "msg": "提交成功，等待生成",
  "data": {
    "task_id": "abcdef123456",
    "request_id": "kie_xxxxxxxxxxxx",
    "credits": 15
  }
}

جمع کروانے پر کریڈٹس منہا ہو جاتے ہیں۔ ناکام ٹاسکس خودکار طور پر ریفنڈ ہو جاتے ہیں۔

ٹاسک کی تلاش

ٹاسک کو آئی ڈی کے ذریعے پول کریں جب تک task_status 3 (کامیاب) یا 4 (ناکام) تک نہ پہنچ جائے۔

GET /api/v1/tasks/{task_id}

cURL مثال

curl https://your-site.com/api/v1/tasks/abcdef123456 \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

جواب

{
  "code": 200,
  "msg": "ok",
  "data": {
    "task_id": "abcdef123456",
    "task_status": 3,
    "task_type": "image",
    "model_id": "gpt-image-2",
    "image_url": "https://your-cdn.com/...",
    "video_url": null,
    "audio_url": null,
    "credits": 15,
    "created_at": 1730000000
  }
}

task_status: 1 قطار میں، 2 چل رہا ہے، 3 کامیاب، 4 ناکام۔

غلطیاں

  • code: 200 — کامیابی
  • code: 0 — کاروباری ناکامی (تفصیلات کے لیے msg فیلڈ دیکھیں)
  • HTTP 401 — غلط یا غائب API کلید