توثيق المطورين

طريق مباشر من الوصف إلى الفيديو.

تستدعي هذه الأمثلة SeedanceLink. استخدم مفتاح API الخاص بك؛ فجلسة تسجيل الدخول باستخدام Google مخصصة للوحة التحكم على الويب.

قبل البدء

سجّل الدخول، وأضف رصيدًا كافيًا لعرض السعر، وأنشئ مفتاحًا ضمن مجموعة مفعّل فيها Seedance. يطلب أصغر مثال أدناه فيديو لمدة 4 ثوانٍ بدقة 480p.

إنشاء مفتاح API الخاص بك النماذج والأسعار

المصادقة

أرسل Authorization: Bearer YOUR_API_KEY في طلبات الإنشاء والحالة والمحتوى. استخدم المفتاح نفسه الذي أنشأ المهمة. لا تضع مفتاحك في URL أبدًا.

Authorization: Bearer YOUR_API_KEY

عنوان أصل APIhttps://seedancelink.io

نموذج المثال

عند عدم تحديدها، تكون المدة 5 ثوانٍ والدقة 720p. تختار هذه الأمثلة صراحةً 4 ثوانٍ و480p. أرسل application/json واستخدم أحد معرّفي النموذج المعروضين في صفحة النماذج.

شغّل أمثلة curl في نفس طرفية macOS/Linux أو Windows WSL. يضبط المثال الأول مفتاحك وعنوان API لهذا الموقع. احتفظ بمفتاحك سريًا.

إنشاء مهمة

يطلب المثال فيديو مدته أربع ثوانٍ. احفظ id الذي تعيده API. يدعم Seedance 2.0 مدة 4–15 ثانية وSeedance 2.5 مدة 4–30 ثانية. يدعم كلاهما 480p و720p و1080p.

POST /api/v3/contents/generations/tasks

API_KEY='YOUR_API_KEY'
API_BASE='https://seedancelink.io'

curl --fail-with-body --request POST "$API_BASE/api/v3/contents/generations/tasks" \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-2.0-933",
  "content": [
    {
      "type": "text",
      "text": "قارب صغير يعبر بحيرة هادئة عند شروق الشمس بإضاءة سينمائية."
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9"
}'

مثال على الاستجابة

{
  "id": "YOUR_TASK_ID",
  "status": "queued"
}

احفظ معرّف المهمة من الاستجابة واستخدمه في الخطوتين التاليتين.

التحقق من حالتها

استبدل REPLACE_WITH_RESPONSE_ID بذلك id. تحقق كل 15 ثانية أثناء الانتظار أو التنفيذ. نزّل عند succeeded. عند failed أو needs_reconcile أوقف الاستعلام؛ تواصل مع الدعم عند needs_reconcile. لا تعِد الإرسال تلقائيًا.

GET /api/v3/contents/generations/tasks/<task_id>

TASK_ID='REPLACE_WITH_RESPONSE_ID'

curl --fail-with-body "$API_BASE/api/v3/contents/generations/tasks/$TASK_ID" \
  --header "Authorization: Bearer $API_KEY"

مثال على الاستجابة

{
  "id": "YOUR_TASK_ID",
  "status": "succeeded"
}

تحقق كل 15 ثانية تقريبًا. نزّل الفيديو فقط بعد وصول الحالة إلى succeeded.

تنزيل الفيديو

استخدم نفس المفتاح الذي أنشأ المهمة. تتطلب نقطة التنزيل المحمية مفتاح Bearer؛ فتح الرابط في المتصفح وحده لا يكفي. يتبع curl تحويلات HTTPS دون مشاركة المفتاح مع مواقع أخرى.

GET /api/v3/contents/generations/tasks/<task_id>/content

curl --fail --location --proto-redir '=https' --max-redirs 3 \
  "$API_BASE/api/v3/contents/generations/tasks/$TASK_ID/content" \
  --header "Authorization: Bearer $API_KEY" \
  --output video.mp4

حالات المهمة والفوترة

queued: تم قبولها وهي قيد الانتظار.
running: جارٍ إنشاء الفيديو.
succeeded: اكتملت؛ نقطة نهاية المحتوى التي تتطلب المصادقة جاهزة.
failed: فشل الإنشاء؛ أُعيد المبلغ المحجوز.
needs_reconcile: نتيجة الإرسال غير مؤكدة؛ يبقى المبلغ محجوزًا للمراجعة.

عرض السعر قبل الإنشاء.

الثواني المطلوبة × سعر الدقة × المعامل المطبق. يُحجز المبلغ عند الإرسال، ويُخصم عند النجاح، ويُعاد عند الفشل.

نزّل باستخدام المفتاح نفسه

بعد succeeded، استخدم content.video_url أو نقطة نهاية المحتوى أدناه مع مفتاح API الخاص بك. لا يمنع الرصيد المتبقي الصفري تنزيل مهمة مدفوعة بالفعل.

إذا كانت نتيجة الإرسال غير مؤكدة

يبقى إيصال 202 مع needs_reconcile محتويًا على معرّف مهمة محلي. احفظ هذا المعرّف وتحقق منه. لا تنشئ مهمة أخرى تلقائيًا؛ فالمبلغ الأصلي لا يزال محجوزًا.