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

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

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

يتيح لك Seedance 2.0 Open API إرسال مهام إنشاء فيديو غير متزامنة من منتجك الخاص واسترجاع النتيجة بعد اكتمال المعالجة.

Base URL

https://www.seedance2.ink

Authentication

تستخدم جميع طلبات Open API رمز Bearer يتم إنشاؤه من لوحة Seedance.

Authorization: Bearer sd2_live_your_api_key
{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

تدفق التكامل

  1. أنشئ API Key من لوحة Seedance.
  2. أرسل مهمة عبر POST /api/open/v1/video/generations.
  3. احفظ قيمة requestId التي يتم إرجاعها.
  4. نفّذ polling على GET /api/open/v1/video/generations/{requestId} حتى تصل المهمة إلى الحالة النهائية.
  5. إذا لزم الأمر، استخدم webhook لتلقي إشعار عند اكتمال المهمة.

النقاط الطرفية الأساسية

MethodEndpointDescription
GET/api/open/v1/modelsيعرض النماذج، والمدد، ونسب العرض، والدقات، وبيانات التسعير المتاحة.
POST/api/open/v1/video/generationsينشئ مهمة جديدة لتوليد الفيديو.
GET/api/open/v1/video/generations/{requestId}يفحص حالة المهمة ويعيد رابط الإخراج عند الجاهزية.
POST/api/open/v1/video/generations/{requestId}/cancelيلغي مهمة في قائمة الانتظار أو قيد المعالجة.

Available Models

ModelBest forSupported durationsResolutions
seedance-2.0Highest quality, multimodal generation4-15 seconds480p, 720p, 1080p
seedance-2.0-fastFaster turnaround4-15 seconds480p, 720p, 1080p
seedance-1.5-proLower-cost fallback workloads5 or 10 seconds480p, 720p, 1080p

Supported aspect ratios:

  • 16:9
  • 9:16
  • 1:1

الحالات

StatusDescription
queuedتم قبول الطلب وهو الآن في قائمة الانتظار.
processingالتوليد قيد المعالجة حالياً.
succeededاكتملت المهمة بنجاح وأصبح output.url متاحاً.
failedفشلت المهمة. راجع error.
cancelledتم إلغاء المهمة قبل اكتمالها.

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models
{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhook

يمكنك تحديد webhookUrl لكل طلب، أو إعداد عنوان callback افتراضي على مستوى API Key.

  • إذا وُجد الاثنان معاً، تكون الأولوية لـ webhookUrl الموجود داخل الطلب.
  • إذا تم إعداد Webhook Secret، فسيتم إرسال الترويسة x-seedance-signature.
  • لا يتم إرسال webhook إلا عند وصول المهمة إلى حالة نهائية.
x-seedance-signature: <hex_sha256_hmac>
{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

أكواد الأخطاء

HTTP statusError codeDescription
400invalid_requestمحتوى الطلب لا يطابق البنية المتوقعة.
401unauthorizedAPI Key مفقود أو غير صالح.
402insufficient_creditsلا توجد Credits كافية لإنشاء المهمة.
404not_foundتعذر العثور على المهمة ضمن API Key الحالي.
429rate_limitedتم تجاوز الحد لكل دقيقة أو الحصة الشهرية.
500internal_errorحدث خطأ داخلي غير متوقع.

الخطوات التالية

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

البدء

أسرع طريقة للبدء باستخدام Seedance 2.0 بشكل عملي.

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

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

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

Base URLAuthenticationتدفق التكاملالنقاط الطرفية الأساسيةAvailable ModelsالحالاتModels Endpoint ExampleWebhookأكواد الأخطاءالخطوات التالية