توثيق API سيدانس 2.0 API

كل ما تحتاجه لدمج توليد الفيديو Seedance 2.0 في تطبيقك.

عنوان URL الأساسي

https://api.defapi.org

المصادقة

تتطلب جميع طلبات API مفت��ح API في رأس Authorization.

Authorization: Bearer <your-api-key>

مثال: Bearer dk-1234567890abcdef

POST/api/video/seedance/gen

توليد فيديو باستخدام Seedance AI. يُرجع task_id للاستعلام.

جسم الطلب

المعاملالنوعمطلوبالوصف
modelstringلانموذج الذكاء الاصطناعي المستخدم. الافتراضي: seedance-2.0
contentarrayنعممصفوفة من عناصر النص/URL الصورة. بحد أقصى 9 صور. مرجع بـ @image1, @image2…
durationintegerلامدة الفيديو بالثواني. الخيارات: 5, 10, 15. الافتراضي: 5
ratiostringلانسبة العرض إلى الارتفاع. الخيارات: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9. الافتراضي: 16:9
callback_urlstringلاعنوان Webhook URL لاستقبال إشعارات اكتمال المهمة

أمثلة

نص إلى فيديو

POST https://api.defapi.org/api/video/seedance/gen
Authorization: Bearer dk-1234567890abcdef
Content-Type: application/json

{
  "model": "seedance-2.0",
  "content": [
    { "type": "text", "text": "A beautiful beach scene with waves gently lapping at the shore" }
  ]
}

صورة إلى فيديو (مرجع الصور بـ @image1, @image2)

{
  "model": "seedance-2.0",
  "content": [
    { "type": "text", "text": "The cat in @image1 walks through a garden, then meets the dog in @image2" },
    { "type": "image_url", "image_url": { "url": "https://example.com/cat.png" } },
    { "type": "image_url", "image_url": { "url": "https://example.com/dog.png" } }
  ],
  "duration": 5,
  "callback_url": "https://example.com/webhook/video-callback"
}

الاستجابة

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}
GET/api/task/query

استعلام عن حالة ونتيجة مهمة توليد الفيديو.

معاملات الاستعلام

المعاملالنوعمطلوبالوصف
task_idstringنعممعرّف المهمة الذي يُرجعه نقطة نهاية التوليد

أمثلة

GET https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071
Authorization: Bearer dk-1234567890abcdef

الاستجابة

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta823dfb-eaac-44fd-aec2-3e2c7ba8e071",
    "status": "success",
    "result": { "video": "https://example.com/generated-video.mp4" },
    "consumed": "0.500000",
    "status_reason": { "message": null },
    "created_at": "2025-08-03T10:22:20.010Z"
  }
}

رموز الخطأ

حالة HTTPحقل codeالمعنى
2000ن��اح
4001طلب غير صالح — معاملات خاطئة
4011غير مصرح — مفتاح API مفقود أو غير صالح
4041المهمة غير موجودة
5001خطأ داخلي في الخادم