واجهة برمجة تطبيقات Seedance 2.0 المرجعية: فيديو متعدد الوسائط برمجياً

الوصول البرمجي إلى فيديو الذكاء الاصطناعي متعدد الوسائط يغيّر حدود الممكن. المقاطع الفردية رائعة للتسويق وإنشاء المحتوى، لكن سير العمل الآلي - توليد فيديو الكتالوج، والتخصيص لكل مستخدم، وعمليات المحتوى الدفعية - يتطلب الوصول عبر API.

تكشف Reference API الخاصة بـ Seedance 2.0 عن القدرة الكاملة متعددة الوسائط: ما يصل إلى 9 صور و3 مقاطع فيديو و3 مقاطع صوتية لكل طلب، بشكل برمجي، بنفس تسعير الثانية المعمول به في واجهة الويب.

ملخص سريع

• نقطة النهاية: bytedance/seedance-2.0/reference-to-video
• المدخلات: نص توجيهي + ما يصل إلى 9 صور + 3 مقاطع فيديو + 3 مقاطع صوتية
• التسعير: $0.3024 في الثانية من الإخراج، مطابق لواجهة الويب
• الإخراج: فيديو 720p، من 4 إلى 15 ثانية، مزامنة صوتية أصلية
• وقت التوليد: 60-180 ثانية لكل طلب
• مثالي لأتمتة الكتالوج وسير العمل الدفعي والمحتوى البرمجي
• جرّب الـ API مجاناً مع 10 رصيد

متى تلجأ إلى API

واجهة الويب رائعة للعمل الإبداعي اليدوي الفردي. أما API فهي لكل شيء آخر.

API مناسبة عندما تحتاج إلى:

• التوليد الدفعي عبر مئات الأصول
• التكامل مع خطوط أنابيب المحتوى أو المنتجات الحالية
• فيديو مخصص لكل مستخدم داخل تطبيق
• اختبار A/B آلي لمتغيرات الإعلانات الإبداعية
• توليد محتوى مجدول للنشر اليومي
• سير عمل الفهرسة المرتبطة بسجلات قاعدة البيانات

استخدم واجهة الويب عندما:

• تعمل بشكل إبداعي تكراري وتحتاج إلى رؤية كل مخرج وتعديله
• الحجم منخفض (أقل من 10-20 مقطعاً لكل جلسة)
• تستكشف الأداة للمرة الأولى

نقطة النهاية

نقطة نهاية Reference-to-video هي:

bytedance/seedance-2.0/reference-to-video

هذه هي نقطة النهاية الوحيدة التي تحتاجها لتوليدات وضع Reference متعدد الوسائط. يعالج طلب واحد النص وما يصل إلى 9 صور وما يصل إلى 3 مقاطع فيديو وما يصل إلى 3 مقاطع صوتية. يدمج النموذج جميع المدخلات ويعيد فيديو مولَّداً.

بالنسبة لسير عمل النص إلى فيديو أو الصورة الواحدة، استخدم نقاط نهاية Seedance 2.0 API القياسي بدلاً من ذلك.

هيكل الطلب

يتضمن طلب Reference-to-video النموذجي:

• prompt: وصف نصي للموضوع والحركة (مطلوب)
• reference_images: مصفوفة من ما يصل إلى 9 روابط صور أو مراجع ملفات
• reference_videos: مصفوفة من ما يصل إلى 3 روابط فيديو (اختياري)
• reference_audio: مصفوفة من ما يصل إلى 3 روابط صوتية (اختياري)
• duration: مدة الإخراج بالثواني، من 4 إلى 15 (مطلوب)
• aspect_ratio: أحد الخيارات 16:9 أو 9:16 أو 1:1 (مطلوب)

يمكن توفير ملفات الإدخال كروابط URL (يمكن الوصول إليها علناً) أو رفعها مباشرة حسب نمط التكامل الخاص بك.

التسعير عبر API

تسعير API مطابق تماماً لتسعير واجهة الويب:

لا توجد رسوم وصول لـ API ولا رسوم إضافية على رفع المراجع. تدفع فقط مقابل ثواني الإخراج المولَّدة.

تعمل الاعتمادات بنفس الطريقة عبر API وواجهة الويب. أضف رصيداً عبر صفحة الأسعار ويستخدم كلا الواجهتين نفس مجموعة الاعتمادات. للاستخدام المكثف لـ API، تقدم خطة Studio بـ $120 (1,800 اعتماد شهرياً) أفضل سعر لكل اعتماد، وأي رصيد إضافي تضيفه لا تنتهي صلاحيته أبداً.

ابدأ البناء باستخدام API. احصل على وصول API مع 10 اعتمادات مجانية عند التسجيل. ابدأ مجاناً.

أمثلة على حالات الاستخدام

أتمتة فيديو الكتالوج

بالنسبة لمنصات التجارة الإلكترونية التي تضم مئات أو آلاف وحدات SKU، تتيح لك API توليد مقطع فيديو قصير لكل منتج بناءً على صور المنتج الحالية.

سير العمل:

1. استعلم عن قاعدة بيانات منتجاتك
2. لكل منتج، اجلب 5-7 صور للمنتج
3. ادمجها مع حزمة مرجعية على مستوى العلامة التجارية (2-3 صور)
4. استدعِ API مع قالب توجيهي للكشف عن المنتج
5. خزّن رابط الفيديو المُعاد في سجل منتجك
6. اعرضه على صفحات تفاصيل المنتج

الاقتصاديات: كتالوج من 500 وحدة SKU بمقاطع فيديو مدتها 5 ثوانٍ = 500 × 303 اعتماد = 151,500 اعتماد = ~$1,515. بالنسبة لطرح فيديو على مستوى الكتالوج بأكمله، هذه قيمة استثنائية.

توليد فيديو مخصص

بالنسبة للتطبيقات التي تقدم فيديو مخصصاً لكل مستخدم - بطاقات التهنئة، ومحتوى الاحتفالات، ومقدمات الإعداد - تتيح لك API توليد مقاطع فيديو عند الطلب بمراجع خاصة بالمستخدم.

سير العمل:

1. يرفع المستخدم 3-5 صور شخصية (بموافقته)
2. يدمجها تطبيقك مع حزمة مرجعية للأسلوب
3. يولّد استدعاء API مقطع فيديو مخصصاً
4. يُسلَّم إلى المستخدم عبر تطبيقك

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

توليد متغيرات الإعلانات الإبداعية

تحتاج فرق التسويق التي تدير الإعلانات المدفوعة على وسائل التواصل الاجتماعي إلى متغيرات إبداعية مستمرة. تتيح لك API توليد متغيرات اختبار A/B بشكل برمجي.

سير العمل:

1. حدّد حزمة مرجعية للعلامة التجارية (6-8 صور)
2. اكتب قوالب توجيهية لزوايا إعلانية مختلفة
3. كرّر عبر المتغيرات، واستدعِ API لكل منها
4. سلّم المقاطع المولَّدة إلى منصة إعلاناتك
5. تتبع الأداء وولّد الفائزين على نطاق واسع

يمكنك إنتاج 50 متغيراً إعلانياً في تشغيل آلي بتكلفة API تبلغ ~$150، مقارنةً بالإنتاج التقليدي الذي يكلف آلاف الدولارات لكل متغير.

معالجة الاستجابات

تتضمن استجابات API عادةً:

• معرّف التوليد: تتبع حالة الطلب
• الحالة: pending أو processing أو complete أو failed
• رابط الإخراج: متاح بمجرد اكتمال الحالة
• البيانات الوصفية: المدة والدقة وحجم الملف

تستغرق توليدات وضع Reference 60-180 ثانية، لذا يجب أن يتعامل تكاملك مع الاستجابات غير المتزامنة. استطلع نقطة نهاية الحالة أو استخدم webhooks (إن كانت متاحة في حسابك) للحصول على إشعار عند الاكتمال.

لا تعيق تدفقات المستخدم بانتظار اكتمال التوليد. ضع الطلب في قائمة الانتظار، وأخطر المستخدم عند الجاهزية، وسلّم بشكل غير متزامن.

حدود المعدل والتزامن

بالنسبة لمعظم مستويات الحسابات، تنطبق حدود التوليد المتزامن. خطّط لسير عمل الدفعات لاحترام هذه الحدود - ضع الطلبات في قائمة انتظار وعالجها بالتزامن المسموح به.

للحصول على سير عمل إنتاجي بحجم كبير، تواصل مع دعم المنصة بشأن حدود التزامن للمؤسسات. يمكن لمعظم الحسابات القياسية التعامل مع العمل الدفعي المعتدل (10-30 توليداً متزامناً) دون مشاكل.

المصادقة والمفاتيح

يستخدم وصول API المصادقة القياسية المستندة إلى المفاتيح. أنشئ مفتاح API الخاص بك في إعدادات حسابك بعد التسجيل. احتفظ بالمفاتيح على جانب الخادم فقط - لا تكشف عنها أبداً في كود العميل.

الأمانة والمحاولات المتكررة

توليدات API ليست أمينة بطبيعتها لأن كل استدعاء يكلف اعتمادات. إذا فشل توليد في منتصف العملية، يجب أن يتحقق منطق إعادة المحاولة من حالة التوليد الفاشل قبل إعادة الطلب. عادةً لا يستهلك التوليد الفاشل اعتمادات، لكن تحقق دائماً من لوحة تحكم حسابك.

لسير العمل الإنتاجي، نفّذ:

• منطق إعادة المحاولة مع تراجع أسي عند الأعطال العابرة
• استطلاع الحالة أو معالجة webhook للاكتمال غير المتزامن
• تسجيل الأخطاء لرصد المشكلات المنهجية
• مراقبة رصيد الاعتمادات للتنبيه قبل نفادها

أفضل الممارسات لسير العمل البرمجي

1. استخدم حزم مرجعية متسقة. لعمل الكتالوج أو السلاسل، قم بتجزئة حزمك المرجعية حتى تنتج الحزم المتطابقة عبر الطلبات أسلوباً أكثر اتساقاً.

2. اجعل قوالب التوجيه بسيطة. يجب أن تُولَّد التوجيهات البرمجية من بيانات منظمة، لا أن تُكتب يدوياً لكل استدعاء. القالب مع حقول البيانات هو النمط الصحيح.

3. خزّن روابط ملفات المراجع مؤقتاً. إذا كنت تستخدم مراجع مستندة إلى URL، تأكد من أن الروابط مستقرة ويمكن الوصول إليها. روابط S3 المنتهية الصلاحية أو الملفات المنقولة ستفشل في التوليد.

4. تعامل مع سلامة المحتوى بشكل مناسب. تمتلك المنصة مرشحات لسلامة المحتوى. ابنِ معالجة سلسة للطلبات المرفوضة بواسطة المرشح في سير عملك.

5. سجّل بيانات التوليد الوصفية. تتبع كل توليد - التوجيه، ومجموعة المراجع، والمدة، والاعتمادات المستهلكة، ورابط الإخراج - في قاعدة بيانات تطبيقك. هذا يجعل التصحيح وإعداد التقارير أسهل بكثير.

مثال على سير العمل الدفعي

كود شبه برمجي لسير عمل توليد فيديو المنتجات دفعةً واحدة:

for product in product_catalog:
    references = build_reference_bundle(
        brand_images,
        product.photo_urls[:4]
    )
    prompt = f"{product.name} product rotates slowly on a clean surface, soft studio lighting, 5 seconds"

    response = seedance_api.generate(
        endpoint="bytedance/seedance-2.0/reference-to-video",
        prompt=prompt,
        reference_images=references,
        duration=5,
        aspect_ratio="16:9"
    )

    generation_id = response.id
    queue_poll_task(generation_id, product.id)

يتولى مستطلع متابعة معالجة الاكتمال وتخزين رابط الإخراج مقابل سجل المنتج.

المراقبة والتحكم في التكاليف

لاستخدام API الإنتاجي، أعدّ مراقبة التكاليف:

• تنبيهات الميزانية اليومية: تنبيه عند تجاوز الإنفاق اليومي على API حداً معيناً
• حدود لكل سير عمل: قيّد المهام الدفعية بحد أقصى من الاعتمادات لمنع الأتمتة الجامحة
• لوحات متابعة الاستخدام: تتبع سير العمل الذي يستهلك أكثر الاعتمادات
• تنبيهات رصيد الاعتمادات: أضف رصيداً قبل نفاده

تمنع هذه الضمانات المفاجآت عند توسيع نطاق الأتمتة.

تكافؤ التسعير بين API وواجهة الويب

سؤال شائع: هل هناك خصم لاستخدام API؟ لا - تفرض كل من API وواجهة الويب نفس الرسوم البالغة $0.3024 في الثانية. تسعير API مبني على العمل الذي تؤديه، لا على الواجهة التي تستخدمها.

حيث يوفر المستخدمون ذوو الحجم الكبير هو في اختيار مستواهم. يجب على مستخدمي API المكثفين العمل على خطة $120 Studio للحصول على أفضل قيمة مقابل الدولار.

البدء مع API

1. سجّل في arteza.ai (10 اعتمادات مجانية)
2. أنشئ مفتاح API الخاص بك في إعدادات الحساب
3. أضف حزمة اعتمادات تتناسب مع حجمك المتوقع
4. ادمج نقطة النهاية في تطبيقك
5. ابدأ بدفعات اختبار صغيرة للتحقق من صحة سير عملك
6. توسّع إلى الإنتاج بعد الاختبار

يمكن أن يكون أول استدعاء API مباشراً في غضون ساعة من التسجيل لمعظم عمليات التكامل.

قراءات تالية

للاطلاع على مجموعة ميزات Reference الكاملة، اقرأ الدليل الكامل لـ Seedance 2.0 Reference. لسير عمل واجهة الويب، راجع درس تناسق الأسلوب. لتفاصيل Seedance 2.0 API القياسية، تحقق من دليل Seedance 2.0 API.

الفيديو متعدد الوسائط البرمجي موجود الآن. ابنِ شيئاً جديداً به.