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

توليد الفيديو غير متزامن. POST /v1/videos/generations يعيد هوية مهمة عامة وعادةً ما يعيد poll_url؛ يظهر الفيديو النهائي في ردود الحالة اللاحقة.

أرسل روابط HTTP(S) عامة أو روابط data مدعومة في حقول الصور التي يقبلها النموذج المختار. تُعالج كمدخلات وسائط عادية ولا تُنشئ تلقائيًا معرّفات مواد قابلة لإعادة الاستخدام.

إذا كانت المادة المحددة صراحةً لا تزال قيد الإعداد، يعيد POST /v1/videos/generations الخطأ 409 seedance_material_preparing مع inactive_asset_ids. استعلم عنها حتى تصبح ACTIVE ثم أعد المحاولة بالمعرّفات نفسها. عند FAILED راجع error_message وصحح المادة أو أعد استيرادها أولًا.

العمليات المدعومةCopy Anchor Link

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

اكتشاف النموذجCopy Anchor Link

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 وveo3.1 وseedance-2.0؛ لا تستخدم أسماء العمليات الخاصة بالمزوّد كأسماء نماذج في TokenLab.

اقرأ تفاصيل النموذج المحدد قبل الاعتماد على الحقول المتخصصة مثل reference_images, kling_elements, output_audio, duration, resolution, أو aspect_ratio.

إنشاء الطلبCopy Anchor Link

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 من إنشاء المهمة.

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

يعتمد سلوك الصوت على النموذج والعملية. قد يحتوي الفيديو على صوت حتى عندما لا يوجد مفتاح للتحكم فيه. حذف المعامل يختلف عن إرسال false.

• ينشئ veo3.1 وveo3.1-fast الصوت دائمًا وفق عقد Gemini API. كما لا يدعم توليد الفيديو في wan-2.6 وwan-2.7 تعطيل الصوت. احذف output_audio أو استخدم true إذا سمحت تفاصيل النموذج بذلك.
• ينشئ hailuo-h3 ونماذج فيديو Grok صوتًا أصليًا. لا تضف مفتاح صوت غير مدرج في تفاصيل النموذج.
• يكون الصوت مفعّلًا افتراضيًا في Seedance 1.5/2.x وviduq3-pro / viduq3-turbo مع دعم الإخراج الصامت. ويكون معطّلًا افتراضيًا في PixVerse C1/V5.6/V6. استخدم output_audio فقط للعمليات التي تعلنه؛ ويقبل Vidu أيضًا الحقل المنطقي audio المعلن في عقده.
• يوفّر audio_url / audio_urls صوت الإدخال أو المرجع، وليس مفتاحًا لصوت الإخراج. قد يحافظ تحرير الفيديو ونقل الحركة والأسلوب على المسار الصوتي الأصلي. الاحتفاظ بالصوت الأصلي لا يعني كتمه.

راجع تفاصيل النموذج للقيم المسموحة والأسعار المتعلقة بالصوت. يجب أن تتطابق الأسماء البديلة المدعومة outputAudio وgenerate_audio والحقل المنطقي audio مع output_audio عند جمعها. قد تختلف أدوات التحكم بين الإصدارات والعمليات.

• بالنسبة إلى عائلة Seedance 2.0، اقرأ دليل نماذج فيديو Seedance 2.0 قبل استخدام مخرجات 4K أو حدود Fast/Mini أو مدخلات المرجع متعددة الوسائط.
• في video-to-video مع grok-imagine-video، أرسل prompt ورابط HTTPS عامًا لملف .mp4 في video_url. لا تستخدم هذه العملية خيارات duration أو resolution أو aspect_ratio.

PixVerse و HappyHorseCopy Anchor Link

في 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
  }'

استعلام النتائجCopy Anchor Link

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

قد تعيد مهام الفيديو المكتملة video_url أو video أو videos بحسب النموذج وعدد المخرجات. اعتبر billing_transaction_id معرفًا للفوترة، وليس معرفًا للمهمة.

الأخطاء الشائعةCopy Anchor Link

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

مرجع APICopy Anchor Link

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

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

{
  "model": "hailuo-h3-max",
  "operation": "text-to-video",
  "prompt": "A slow camera move through a quiet garden",
  "resolution": "768p",
  "duration": 5,
  "aspect_ratio": "16:9"
}