توليد الفيديو

توليد الفيديو غير متزامن. POST /v1/videos/generations يعيد هوية مهمة عامة وعادةً ما يعيد poll_url؛ يظهر الفيديو النهائي في ردود الحالة اللاحقة. عندما يستطيع نموذج Seedance المحدد استخدام مكتبة مواد TokenLab، يتم تجهيز روابط الصور و data URL المضمنة المدعومة كمواد TokenLab قابلة لإعادة الاستخدام قبل التوليد. إذا استغرق التجهيز أكثر من 60 ثانية، أعد المحاولة بعد أن تصبح auto_material_asset_ids المعادة في حالة ACTIVE. إذا لم يستطع النموذج المحدد استخدام مكتبة المواد، تستمر مدخلات الصور العادية عبر مسار الصور المعتاد.

العمليات المدعومة

استخدم operation صريحة في الإنتاج. يمكن لـ TokenLab استنتاج بعض العمليات من المدخلات، لكن القيم الصريحة للعملية تجعل التحقق والدعم وإعادة المحاولة أكثر وضوحًا.

العملية	المدخل المطلوب أو النموذجي	حالة الاستخدام
`text-to-video`	`prompt`	توليد من النص فقط
`image-to-video`	`image_url` أو `image` متوافق	تحريك صورة البداية
`reference-to-video`	`reference_images` و `video_urls` / `audio_urls` الاختيارية على النماذج المدعومة	الحفاظ على الهوية أو الأسلوب أو مراجع الأصول
`start-end-to-video`	`start_image`, `end_image`	التحكم في الإطارات الأولى والأخيرة
`video-to-video`	`video_url` أو `task_id` المحدد للنموذج	تحويل أو تحسين مقطع موجود
`motion-control`	`image_url` بالإضافة إلى `video_url`	تطبيق مرجع الحركة على موضوع
`audio-to-video`	`audio_url`	تدفقات الفيديو المشروطة بالصوت
`video-extension`	`task_id`, `extend_at`, أو حقول التمديد المحددة للنموذج	متابعة فيديو تم توليده

اكتشاف النموذج

curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \\
  -H "Authorization: Bearer sk-your-api-key"

استخدم معرفات النماذج التي تعرضها TokenLab في model، ثم اختر متغيرات العملية عبر operation ومدخلات الوسائط المناسبة. تشمل الأمثلة wan-2.7 وhappyhorse-1.0 وviduq3 وviduq3-mix وpixverse-v6 وkling-3.0-video وveo3.1 وseedance-2.0؛ لا تستخدم أسماء العمليات الخاصة بالمزوّد كأسماء نماذج في TokenLab. اقرأ تفاصيل النموذج المحدد قبل الاعتماد على الحقول المتخصصة مثل reference_images, kling_elements, output_audio, duration, resolution, أو aspect_ratio.

إنشاء الطلب

curl https://api.tokenlab.sh/v1/videos/generations \\
  -H "Authorization: Bearer sk-your-api-key" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "veo3.1",
    "operation": "text-to-video",
    "prompt": "لقطة سينمائية هادئة لقط يسير في حديقة مضاءة بأشعة الشمس",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

لإدخال وسائط الإنتاج، يفضل استخدام https URLs العامة بدلاً من data: URLs المضمنة. إذا كنت تستخدم URLs مؤقتة، أبقها صالحة حتى ينتهي TokenLab من إنشاء المهمة.

المدخلات والحقول المحددة للنموذج

طلبات عائلة Veo 3 افتراضيًا تكون على وضع الصوت عند حذف output_audio. قم بتعيينها صراحة عندما يدعم النموذج التبديل وتعتمد تجربة المستخدم الخاصة بك على الصوت.
kling_elements مخصصة لطلبات kling-3.0-video المشروطة بالصورة. قم بالإشارة إلى كل عنصر في prompt كـ @name؛ لا تجمعها مع output_audio=true.
بالنسبة إلى عائلة Seedance 2.0، اقرأ دليل نماذج فيديو Seedance 2.0 قبل استخدام مخرجات 4K أو حدود Fast/Mini أو مدخلات المرجع متعددة الوسائط.
بالنسبة لـ grok-imagine-video، يستخدم video-to-video video_url العامة بصيغة .mp4؛ يجب أن تأتي الحدود المحددة للنموذج مثل duration و resolution من تفاصيل النموذج.

PixVerse و HappyHorse

نموذج	العمليات	المدخلات	الدقة	المدة	محدد الصوت
`pixverse-c1`, `pixverse-v6`	`text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video`	`prompt`; `image_url`; `start_image` + `end_image`; `reference_images`	360p, 540p, 720p, 1080p	أي عدد صحيح من 1 إلى 15 ثانية	`output_audio`, الافتراضي `false`
`pixverse-v5.6`	`text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video`	نفس الحقول مثل C1 و V6	360p, 540p, 720p, 1080p	5 أو 8 أو 10 ثوانٍ؛ 1080p يدعم 5 أو 8 ثوانٍ	`output_audio`, الافتراضي `false`
`happyhorse-1.0`	`text-to-video`, `image-to-video`, `reference-to-video`, `video-to-video`	`prompt`; `image_url`; `reference_images`; `video_url` + `reference_images`	720p, 1080p	من 3 إلى 15 ثانية لعمليات التوليد؛ إخراج video-to-video محدود بـ 15 ثانية	لا ترسل `output_audio`

في TokenLab، نماذج PixVerse أعلاه لا تقبل operation=video-extension.

curl https://api.tokenlab.sh/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "operation": "image-to-video",
    "prompt": "A slow camera move through a neon-lit street",
    "image_url": "https://example.com/start.jpg",
    "resolution": "1080p",
    "duration": 5,
    "output_audio": true
  }'

استعلام النتائج

استخدم poll_url المعاد أولاً. إذا كنت بحاجة إلى نقطة نهاية ثابتة، استخدم GET /v1/tasks/{id} بنفس id / task_id من رد الإنشاء. قد تعيد مهام الفيديو المكتملة video_url أو video أو videos بحسب النموذج وعدد المخرجات. اعتبر billing_transaction_id معرفًا للفوترة، وليس معرفًا للمهمة.

الأخطاء الشائعة

لا تقم بتشفير مسارات حالة الفيديو القديمة؛ يفضل استخدام poll_url.
لا تجمع بين حقول الإطار الأول مع تدفقات صورة مرجعية مخصصة ما لم يسمح بذلك تفاصيل النموذج.
لا تفترض أن duration تصف طول فيديو المرجع المدخل؛ عادةً ما تتحكم في طول المخرجات المولدة.
لا تقم بإعادة محاولة طلبات الإنشاء بعد انتهاء المهلة دون التحقق مما إذا كانت المهمة قد تم إنشاؤها بالفعل.

مرجع API

الموضوع	المرجع
إنشاء فيديو	إنشاء فيديو
الحصول على حالة الفيديو	الحصول على حالة الفيديو
الحصول على حالة المهمة	الحصول على حالة المهمة
إلغاء المهمة	إلغاء المهمة
الفواتير والتسعير	الفواتير والتسعير

واجهات فيديو بأسلوب OpenAI ومتوافقة مع Volc

استخدم /v1/videos/generations لواجهة الفيديو الموحدة في TokenLab عبر النماذج. إذا كنت تنقل تكاملا قائما مع Seedance 2.0 يستخدم بالفعل content[] أو طلبات Action بأسلوب Volc، فاستخدم واجهات توافق Seedance تحت /api/v3. يستخدم الأسلوبان مفاتيح TokenLab Bearer API والاستعلام غير المتزامن، لكن شكل الطلب والاستجابة مختلف.

​العمليات المدعومة

​اكتشاف النموذج

​إنشاء الطلب

​المدخلات والحقول المحددة للنموذج

​PixVerse و HappyHorse

​استعلام النتائج

​الأخطاء الشائعة

​مرجع API

​واجهات فيديو بأسلوب OpenAI ومتوافقة مع Volc