ترحيل 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 InvalidCredential. يمكن لعملاء 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. يتم الحفاظ على أدوار الصور مثل first_frame و last_frame و reference_image. لا يتم دعم callback_url بعد؛ استعلم عن واجهة المهمة.

صفحات المرجع

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

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

مثال Action بسيط

curl 'https://api.tokenlab.sh/?Action=CreateContentsGenerationsTasks&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"seedance-2.0",
    "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

ما الذي يتغير

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

صفحات المرجع

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

مثال Action بسيط

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

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

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

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

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

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

​مثال Action بسيط

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

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

ما الذي يتغير

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

صفحات المرجع

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

مثال Action بسيط

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

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