إن لم تكن بحاجة إلى دمج أي شيء وتريد الفيديوهات فقط، فيمكنك تخطّي العمل الهندسي: استوديو موقعنا يغلّف النموذج نفسه مع التحقق من الملفات المرفوعة، والتسجيل من المتصفح، والتخزين، والتنزيل.
ما الذي يحتويه طلب OmniHuman 2 API
يتضمن الطلب حقلين إلزاميين وحقلًا اختياريًّا. رابط الصورة يشير إلى الشخص (أو الأشخاص) المراد تحريكهم؛ ورابط الصوت يشير إلى الكلام أو الأغنية التي تقود الأداء؛ والبرومبت الاختياري يصف الحركة والمزاج وتفاصيل المشهد وحركة الكاميرا. وتُسلَّم النتائج عادةً بشكل غير متزامن عبر قائمة انتظار: ترسل الطلب، فتتلقى معرّفًا له، ثم تستعلم عن حالته دوريًّا أو تتلقى webhook عندما يصبح الفيديو جاهزًا.
- image_url: إلزامي؛ الصورة الثابتة المراد تحريكها.
- audio_url: إلزامي؛ ملف MP3 أو WAV يحدد المدة ومزامنة الشفاه.
- prompt: اختياري؛ مدعوم بالإنجليزية والصينية واليابانية والكورية والإسبانية (المكسيك) والإندونيسية.
حدود المدخلات التي يجب التحقق منها أولًا
الطلبات المرفوضة تهدر الوقت وأحيانًا المال، لذا تحقق من جهتك قبل استدعاء النموذج. يجب أن تكون الصورة بصيغة شائعة مثل JPEG أو PNG أو WEBP أو BMP أو TIFF أو GIF أو HEIC، بحجم لا يتجاوز 30 ميغابايت، وبين 300 و6000 بكسل لكل ضلع، بنسبة عرض إلى ارتفاع من 0.4 إلى 2.5. ويجب أن يكون الصوت WAV أو MP3، بحجم أقصاه 15 ميغابايت، ومدة بين 4 و300 ثانية.
تسجيلات المتصفح تكون عادةً بصيغة WebM أو Opus، وهي صيغ لا يقبلها النموذج. حوّلها إلى WAV أو MP3 قبل الرفع؛ فاستوديو موقعنا يعيد ترميز التسجيلات إلى WAV أحادي القناة بتردد 22.05 كيلوهرتز، ما يُبقي مقطعًا مدته خمس دقائق ضمن حد الحجم.
الإخراج والفوترة
المهمة المكتملة تُرجع رابط ملف الفيديو والمدة المستخدمة للفوترة، وهي تطابق طول الصوت المُدخل. والإخراج ملف MP4 بدقة 720p أصلية. قد تنتهي صلاحية روابط المزوّد، لذا يجب أن تنسخ الأنظمة الإنتاجية الملف إلى تخزينها الخاص فور انتهاء المهمة بدلًا من الربط بالمزوّد مباشرة.
ولأن التكلفة تتناسب مع الثواني المولَّدة، قِس مدة الصوت على الخادم، ولا تثق أبدًا بمدة يرسلها المتصفح، واحجز التكلفة قبل الإرسال حتى لا تتجاوز المهام المتزامنة الرصيد المتاح.
تدفّق جاهز للإنتاج
النمط الذي نتبعه في كل عملية توليد على هذا الموقع:
- 1الرفع إلى تخزين خاصأصدر روابط رفع موقّعة قصيرة الأجل؛ ولا تكشف أبدًا روابط عامة طويلة الأجل لصور المستخدمين.
- 2التحقق على الخادمأعد قياس مدة الصوت وتأكد من وجود الملفين قبل أي خصم.
- 3الحجز ثم الإرسالاحجز النقاط بعملية ذرّية، وأرسل المهمة، واستردّها تلقائيًّا إن فشل الإرسال.
- 4إنهاء آمن من التكرارعند وصول الـ webhook أو الاستعلام، اجلب النتيجة، وخزّن ملف MP4، وعلّم المهمة كمكتملة مرة واحدة فقط.
متى يكون الاستوديو بلا كود هو الخيار الأفضل
بناء المنظومة أعلاه يستغرق أيامًا من العمل: التخزين، والتحقق، وقوائم الانتظار، والـ webhooks، وإعادة المحاولة، والفوترة. إن كان هدفك المحتوى لا ميزة في منتج، فاستوديو موقعنا يمنحك مخرجات OmniHuman 2.0 نفسها مع كل ذلك منجزًا مسبقًا. نحن لا نقدّم API عامة؛ فهذا الموقع مصمم لصنّاع المحتوى والمسوّقين الذين يريدون فيديوهات جاهزة.
التعامل مع حالات الفشل وإعادة المحاولة
تعامل مع كل مهمة على أنها قابلة للفشل: قد يرفض المزوّد مُدخلًا، أو تنتهي المهلة تحت الضغط، أو تُرجَع نتيجة لا يمكن تنزيلها. احتفظ بعمود حالة (في الانتظار، قيد التنفيذ، مكتملة، فاشلة) لكل مهمة، واجعل خطوة الإنهاء آمنة من التكرار (idempotent) حتى لا يُعالَج webhook مكرر مرتين، واستردّ أي رصيد محجوز عند الفشل.
استخدم الاستعلام الدوري احتياطيًّا حتى عند استخدام الـ webhooks. فأجهزة التطوير المحلية لا تستطيع استقبالها، والـ webhooks في بيئة الإنتاج تتأخر أحيانًا.
- خزّن معرّف طلب المزوّد قبل الرد على المستخدم.
- أعد توقيع روابط المدخلات بفترة صلاحية أطول من وقت الانتظار المتوقع في القائمة.
- سجّل أخطاء المزوّد كما هي حرفيًّا؛ فهي عادةً تسمّي الحد الذي تم تجاوزه بالضبط.
الأسئلة الشائعة
هل يقدّم omnihuman2.ai واجهة API عامة؟
لا. نشغّل النموذج لصنّاع المحتوى عبر استوديو الويب. ويمكن للمطورين الوصول إلى OmniHuman 2 عبر مزوّدي النماذج الرسميين.
ما أقصى مدة للصوت في OmniHuman 2 API؟
300 ثانية. والحد الأدنى 4 ثوانٍ، ويجب أن يكون الملف MP3 أو WAV بحجم أقل من 15 ميغابايت.
ما الدقة التي تُرجعها الـ API؟
يولّد الإصدار 2.0 بدقة 720p أصلية ويُرجع ملف MP4.
هل الـ API متزامنة؟
في الغالب لا. المهام تستغرق دقائق، لذا يستخدم المزوّدون قائمة انتظار مع استعلام دوري أو webhooks.
هل يمكنني إرسال تسجيل بصيغة WebM؟
ليس مباشرة. حوّله أولًا إلى WAV أو MP3؛ فمعظم تسجيلات المتصفح تحتاج إلى إعادة ترميز.
كيف تُحتسب تكلفة الاستخدام؟
بعدد ثواني الإخراج، وهو يساوي طول الصوت المُدخل.
هل يجب أن أنسخ فيديو الإخراج إلى تخزيني الخاص؟
نعم. قد تنتهي صلاحية روابط نتائج المزوّد، لذا نزّل ملف MP4 إلى تخزينك فور اكتمال المهمة.
كم تستغرق المهمة عادةً؟
يعتمد ذلك على طول المقطع وضغط قائمة الانتظار. في اختبارنا، اكتمل مقطع مدته نحو خمس ثوانٍ في حوالي دقيقتين من البداية إلى النهاية، لذا صمّم واجهتك على أساس دقائق لا ثوانٍ.