Skip to main content

نظرة عامة

هذه الواجهات مخصصة للفرق التي تستخدم بالفعل شكل مهام Seedance بأسلوب Volc. يتم التوثيق باستخدام TokenLab Bearer API key. يبدأ معرف المهمة المرجع بـ cgt-؛ قم بالاستعلام عن الحالة حتى تصبح status إحدى succeeded أو failed أو cancelled أو expired. يستخدم عقد المهام الرسمي مسارات REST تحت /api/v3/contents/generations/tasks. تبقى أسماء Action القديمة للتوافق مع تكاملات TokenLab السابقة فقط، وليست جزءًا من عقد المطابقة الرسمية. يقبل callback_url عنوان HTTP(S) عامًا. يرسل TokenLab نفس كائن الاستعلام عند كل تغير إلى queued أو running أو succeeded أو failed أو expired، من دون رؤوس TokenLab خاصة؛ وتُعاد محاولات succeeded وfailed حتى ثلاث مرات بعد مهلة خمس ثوان.
للاسترداد الآمن بعد انقطاع الاتصال، أرسل Idempotency-Key فريدًا مع طلب إنشاء REST. تؤدي إعادة إرسال نفس الجسم والمفتاح إلى إرجاع معرف cgt-... نفسه؛ ويؤدي استخدام المفتاح نفسه مع جسم مختلف إلى 409. لا ينطبق ذلك على مسار Action القديم.
انظر أيضا نماذج فيديو Seedance 2.0 و توليد الفيديو.

قواعد المحتوى

  • استخدم type=text لنص الطلب.
  • يعامل type=image_url بدون role كإطار أول، أو يمكنك تعيين role=first_frame.
  • استخدم role=last_frame فقط مع إطار أول.
  • استخدم role=reference_image أو reference_video أو reference_audio للوسائط المرجعية.
  • لا تخلط مدخلات الإطار الأول/الأخير مع الوسائط المرجعية في طلب واحد.

ملاحظات المعلمات

  • يقبل ratio القيم 16:9 و 4:3 و 1:1 و 3:4 و 9:16 و 21:9 أو adaptive.
  • القيمة الافتراضية الرسمية لـ generate_audio هي false؛ اضبطها على true عند الحاجة إلى صوت متزامن.
  • يتم قبول service_tier=default. ترفض مهام Seedance 2.0 المتوافقة service_tier=flex و frames و camera_fixed=true.
  • عندما يدعم النموذج المختار ذلك، يمكن أن يحتوي tools على كائنات مثل { "type": "web_search" }. يتم رفض عناصر tool غير الصحيحة بدلا من تجاهلها.

مثال