توثيق 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 للاستعلام.
جسم الطلب
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
| model | string | لا | نموذج الذكاء الاصطناعي المستخدم. الافتراضي: seedance-2.0 |
| content | array | نعم | مصفوفة من عناصر النص/URL الصورة. بحد أقصى 9 صور. مرجع بـ @image1, @image2… |
| duration | integer | لا | مدة الفيديو بالثواني. الخيارات: 5, 10, 15. الافتراضي: 5 |
| ratio | string | لا | نسبة العرض إلى الارتفاع. الخيارات: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9. الافتراضي: 16:9 |
| callback_url | string | لا | عنوان 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_id | string | نعم | معرّف المهمة الذي يُرجعه نقطة نهاية التوليد |
أمثلة
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 | المعنى |
|---|---|---|
| 200 | 0 | ن��اح |
| 400 | 1 | طلب غير صالح — معاملات خاطئة |
| 401 | 1 | غير مصرح — مفتاح API مفقود أو غير صالح |
| 404 | 1 | المهمة غير موجودة |
| 500 | 1 | خطأ داخلي في الخادم |