ترحيل Seedance من Volcengine

استخدم هذا الدليل إذا كان تطبيقك يرسل طلبات Seedance بأسلوب Volcengine. يمكنك الاحتفاظ بأسماء Action وVersion=2024-01-01 وcontent[] وأجسام المواد بصيغة PascalCase وغلاف الاستجابة الخاص بـ Volcengine. يلزم تغيير نقطة النهاية وطريقة المصادقة فقط.

ما الذي يتغير

العنصر	عميل Volcengine الحالي	TokenLab
عنوان URL الأساسي	`Volcengine API`	`https://api.tokenlab.sh/`
المصادقة	`AK/SK`	`Authorization: Bearer <TOKENLAB_API_KEY>`
طلب Action	`Action`, `Version`	`Action`, `Version`
جسم المهمة	`content[]`	`content[]`
جسم المادة	`PascalCase`	`PascalCase`
النتيجة غير المتزامنة	`معرف المهمة`	`cgt-...` + الاستعلام

تعيد الطلبات التي تحتوي على توقيع AK/SK فقط الخطأ 401 AuthenticationError. يمكن لعملاء Action استخدام POST /?Action=...&Version=2024-01-01، كما يبقى POST /api/v3?Action=...&Version=2024-01-01 متاحًا. يستخدم عملاء REST المسار /api/v3/contents/generations/tasks.

شكل الطلب ودورة حياة المهمة

إذا كان تكاملك يرسل بالفعل طلبات Seedance بأسلوب Volc، يمكنك استخدام واجهة التوافق بدلا من إعادة تشكيل الجسم لـ /v1/videos/generations. أرسل مفتاح TokenLab API على شكل Authorization: Bearer ...، واستخدم POST /api/v3/contents/generations/tasks للإنشاء بنمط REST أو /api/v3?Action=CreateContentsGenerationsTasks&Version=2024-01-01 لطلبات Action. تعيد استجابة الإنشاء معرف مهمة cgt-...؛ وتستخدم استجابات الحالة queued أو running أو succeeded أو failed أو cancelled أو expired. تقبل واجهة التوافق عناصر content[] مثل text وimage_url وvideo_url وaudio_url وdraft_task. يقبل callback_url عنوان HTTP(S) عامًا، ويرسل نفس كائن الاستعلام عند كل تغير إلى queued أوrunning أوsucceeded أوfailed أوexpired؛ تُعاد محاولات succeeded وfailed حتى ثلاث مرات بعد خمس ثوان، مع بقاء الاستعلام مسار الاسترداد.

صفحات المرجع

لا تُعد استخدام تعداد أو بنية استجابة /v1/tasks/{id}. يستخدم v1 الحالات pending وprocessing وcompleted وfailed، بينما يستخدم v3 الحالات queued وrunning وsucceeded وfailed وcancelled وexpired. في v3 تكون duration سلسلة نصية ولا يظهر error إلا عند الفشل. للاسترداد بعد انقطاع الاتصال، أرسل Idempotency-Key فريدًا مع إنشاء REST. إعادة إرسال الجسم نفسه والمفتاح نفسه تعيد معرف cgt-... نفسه، بينما يعيد جسم مختلف مع المفتاح نفسه 409.

إجراءات المهام

Action	العنصر	JSON
`CreateContentsGenerationsTasks`	إنشاء مهمة فيديو	`model`, `content[]`
`GetContentsGenerationsTask`	جلب مهمة واحدة	`TaskId`
`ListContentsGenerationsTasks`	عرض المهام	الفلاتر والترقيم
`DeleteContentsGenerationsTasks`	إلغاء مهمة أو حذفها	`TaskId`

مثال REST بسيط

curl 'https://api.tokenlab.sh/api/v3/contents/generations/tasks' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Idempotency-Key: $CLIENT_JOB_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"seedance-2.5",
    "content":[
      {"type":"text","text":"A cinematic product reveal"},
      {"type":"image_url","role":"reference_image","image_url":{"url":"https://example.com/reference.png"}}
    ],
    "ratio":"16:9",
    "duration":5,
    "resolution":"720p"
  }'

المواد والتحقق من الأشخاص

تدعم نقطة Action نفسها عشر عمليات للمواد ومجموعاتها. راجع إجراءات المواد المتوافقة مع Volcengine لمعرفة أجسام PascalCase والفلاتر والترقيم وغلاف الاستجابة وروابط المواد الصالحة 12 ساعة. تتطلب مواد الأشخاص أيضًا إنشاء جلسة تحقق مرئي وجلب نتيجة التحقق المرئي قبل الرفع.

قائمة التحقق من الترحيل

استبدل مضيف API بـ https://api.tokenlab.sh.
استبدل توقيع AK/SK بمفتاح TokenLab من نوع Bearer.
احتفظ بـ Action والإصدار وحالة الأحرف في الجسم.
استخدم ProjectName نفسه لطلبات المواد والتحقق المرتبطة.
احفظ معرفات المهمة والمجموعة والمادة التي يعيدها TokenLab.
تحقق من الإنشاء والاستعلام والقائمة والخطأ قبل نقل حركة الإنتاج.

البدء

الأدلة الأساسية

أدلة الوسائط

ترحيل Seedance من Volcengine

ما الذي يتغير

شكل الطلب ودورة حياة المهمة

صفحات المرجع

إجراءات المهام

مثال REST بسيط

المواد والتحقق من الأشخاص

قائمة التحقق من الترحيل

​ما الذي يتغير

​شكل الطلب ودورة حياة المهمة

​صفحات المرجع

​إجراءات المهام

​مثال REST بسيط

​المواد والتحقق من الأشخاص

​قائمة التحقق من الترحيل

ما الذي يتغير

شكل الطلب ودورة حياة المهمة

صفحات المرجع

إجراءات المهام

مثال REST بسيط

المواد والتحقق من الأشخاص

قائمة التحقق من الترحيل