نظرة عامة
هذه الواجهات مخصصة للفرق التي تستخدم بالفعل شكل مهام 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 القديم.قواعد المحتوى
- استخدم
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 غير الصحيحة بدلا من تجاهلها.