Seedance 2.0
Seedance 2.0
الوثائقالبدء
نظرة عامة على APIمن النص إلى الفيديومن الصورة إلى الفيديو
مرجع API

من النص إلى الفيديو

أنشئ فيديوهات من أوصاف نصية باستخدام Seedance 2.0 Open API.

إذا لم يتم تمرير mediaUrls، فسيعمل هذا الـ endpoint في وضع text-to-video الخالص.

Endpoint

POST /api/open/v1/video/generations

مثال على الطلب

curl --request POST \
  --url https://www.seedance2.ink/api/open/v1/video/generations \
  --header 'Authorization: Bearer sd2_live_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.0",
    "prompt": "A river flowing through an autumn forest, aerial view, cinematic motion",
    "aspectRatio": "16:9",
    "duration": 5,
    "resolution": "720p",
    "webhookUrl": "https://your-app.com/webhooks/seedance",
    "metadata": {
      "projectId": "proj_1001",
      "sceneId": "scene_08"
    }
  }'

استجابة ناجحة

{
  "success": true,
  "requestId": "req_1234567890",
  "status": "queued",
  "creditsCharged": 40
}

حقول الطلب

FieldTypeRequiredDescription
modelstringYesإحدى القيم التالية: seedance-2.0, seedance-2.0-fast, seedance-1.5-pro.
promptstringYesوصف بلغة طبيعية يشرح الفيديو المطلوب.
aspectRatiostringNoإحدى القيم: 16:9, 9:16, 1:1.
durationintegerNoيدعم seedance-2.0 و seedance-2.0-fast من 4 إلى 15 ثانية؛ بينما يدعم seedance-1.5-pro 5 أو 10 ثوانٍ.
resolutionstringNoإحدى القيم: 480p, 720p, 1080p.
webhookUrlstringNoعنوان callback الذي يستقبل النتيجة النهائية.
metadataobjectNoبيانات تعريف مخصصة يتم حفظها مع الطلب.

التحقق من النتيجة

curl https://www.seedance2.ink/api/open/v1/video/generations/req_1234567890 \
  --header 'Authorization: Bearer sd2_live_your_api_key'
{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "model": "seedance-2.0",
  "prompt": "A river flowing through an autumn forest, aerial view, cinematic motion",
  "duration": 5,
  "aspectRatio": "16:9",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

إلغاء المهمة

curl --request POST \
  --url https://www.seedance2.ink/api/open/v1/video/generations/req_1234567890/cancel \
  --header 'Authorization: Bearer sd2_live_your_api_key'
{
  "success": true,
  "requestId": "req_1234567890",
  "status": "cancelled"
}

ملاحظات

  • يتم حساب creditsCharged عند قبول المهمة.
  • لا يظهر output.url إلا عندما تكون قيمة status هي succeeded.
  • إذا كنت تريد إشعارات push بدلاً من polling، فقم بإعداد webhook.

نظرة عامة على API

افهم المصادقة، وإرسال المهام، وفحص الحالة، و webhook في Seedance 2.0 Open API.

من الصورة إلى الفيديو

أنشئ فيديوهات من الصور ووسائط المرجع باستخدام Seedance 2.0 Open API.

جدول المحتويات

Endpointمثال على الطلباستجابة ناجحةحقول الطلبالتحقق من النتيجةإلغاء المهمةملاحظات