غالبًا ما يبدأ تكامل وسائط الذكاء الاصطناعي بميزة واحدة ثم يتوسع سريعًا: تحتاج خدمة العملاء إلى صورة رمزية فورية، والحملة العالمية إلى فيديو مترجم، وقد يحتاج الإنتاج المخصص إلى تحويل وجه أو شخصية، لكن بعد موافقة صاحبها فقط.
تجمع AKOOL هذه المهام في حزمة API واحدة. لا يعني ذلك استخدام endpoint واحد لكل شيء، بل إدارة عدة مسارات عمل ضمن منصة ونموذج مصادقة وخطة حوكمة مشتركة.
الإجابة المختصرة: استخدم AKOOL OpenAPI عندما يحتاج تطبيقك إلى Streaming Avatar فوري أو Video Translation غير متزامن أو Face Swap وCharacter Swap مصرح بهما. اختر عائلة endpoints حسب النتيجة، ثم أضف قواعد الموافقة والوصول والمراجعة والتخزين والحذف.
ابدأ بالنتيجة لا بالنموذج
- إنسان رقمي مباشر: استخدم Streaming Avatar API وSDK، وراجع جودة الإجابات وتبادل الأدوار وزمن الاستجابة والتحويل إلى موظف.
- فيديو معتمد ومترجم: استخدم Video Translation كمهمة غير متزامنة، وراجع الترجمة والصوت والترجمة النصية ومزامنة الشفاه والتوقيت.
- تحويل مصرح به للوجه أو الشخصية: استخدم Face Swap أو Character Swap أو الأداة المناسبة، وراجع الموافقة ودقة الشبه والسياق والإفصاح.
لجلسة البث دورة حياة تشمل الإنشاء والانضمام والتفاعل والمقاطعة والإغلاق. أما مهمة الوسائط فتُرسل وتُراقب وتُراجع وتُنزل ثم تُقبل أو تُرفض. معاملتهما كطلب «generate» واحد يضعف معالجة الأخطاء ويشوّش توقعات المستخدم.
1. استخدام Streaming Avatar للإنسان الرقمي المباشر
تدير Streaming Avatar API الصور الرمزية والجلسات الفورية. ينشئ backend الجلسة باستخدام avatar_id وvoice_id واللغة ووضع التفاعل ومصدر معرفة اختياري، ثم ينضم المتصفح أو التطبيق إلى القناة عبر AKOOL SDK.
استخدم وضع الحوار للمحادثة، وأضف knowledge_id عندما يجب أن تستند الإجابات إلى مستندات أو روابط معتمدة. وفّر المقاطعة وأغلق الجلسة عند الانتهاء. تشمل الاستخدامات إرشاد المنتجات وتهيئة المستخدم والتدريب وخدمة الاستقبال والدعم الأولي. لا ينبغي للصورة الرمزية اختلاق سياسات أو أسعار أو تعليمات سلامة أو نصائح منظمة خارج المصادر المعتمدة.
مسؤوليات الجلسة الأساسية
- إنشاء الجلسات في backend وعدم إرسال إلا بيانات انضمام مؤقتة.
- تحديد ما يمكن الإجابة عنه ومتى يجب التصعيد.
- اختبار الميكروفون والنص والمقاطعة وإعادة الاتصال والإغلاق.
- التأكد من حداثة مصدر المعرفة.
مرجع Create Session هو المصدر المعتمد للحقول وخيارات البث الحالية.
2. استخدام Video Translation للوسائط المترجمة
تستقبل Video Translation API فيديو مصدرًا معتمدًا وتنتج نسخًا مترجمة كمهام غير متزامنة. وتدعم اكتشاف لغة المصدر وعدة لغات مستهدفة ومزامنة شفاه اختيارية والترجمة النصية وإزالة الموسيقى واختيار الصوت والمصطلحات والمدة الديناميكية.
- اقرأ قائمة اللغات الحالية.
- أرسل المهمة باستخدام رابط ثابت للفيديو المصدر.
- احفظ معرّف المهمة.
- استعلم عن النتيجة أو استخدم webhook.
- انسخ الملفات المكتملة إلى مساحة تخزين معتمدة تملكها.
- راجع كل لغة قبل النشر.
لا تعني حالة الاكتمال موافقة تحريرية. راجع أسماء المنتجات والأرقام والوحدات والادعاءات القانونية والترجمة النصية والصوت وحركة الفم والأفعال الظاهرة. موارد API مؤقتة، لذلك انقل الملفات المعتمدة إلى تخزين دائم.
3. تحويل الهوية بعد الحصول على تصريح فقط
«تحويل الهوية المصرح به» فئة حوكمة، وليس اسم API واحدًا. توفر AKOOL أدوات مثل Face Swap وCharacter Swap وHead Swap. يُنصح بـ Face Swap Plus للصور والفيديو ويمكنه دعم عدة وجوه، بينما يطبق Character Swap مظهر صورة شخصية على حركة فيديو مصدر. يتوقف الاختيار على العنصر المطلوب تثبيته: الوجه أو الشخصية أو الأداء أو المشهد.
يركز إطار AKOOL Trust & Safety على الموافقة وتحكم المستخدم والإشراف البشري ومراجعة المحتوى. أدمج هذه المبادئ في المنتج.
الحد الأدنى لمسار التصريح
- تأكيد الملكية أو وجود إذن موثق.
- تسجيل الغرض والقنوات والأسواق والفترة المسموح بها.
- منع ظهور بيانات API في العميل العام.
- مراجعة المدخلات والسياق المقصود.
- فرض مراجعة بشرية قبل النشر الخارجي.
- حفظ بيانات الإفصاح أو المصدر المطلوبة.
- دعم سحب الموافقة والحذف وتصعيد الحوادث.
لا تستخدم أدوات الهوية لانتحال شخص أو تجاوز التحقق أو إنشاء تأييد مضلل أو استعمال الصورة خارج نطاق الإذن.
بنية إنتاج مشتركة
- تطبيق العميل: يجمع المدخلات ويشرح العملية ويعرض التقدم والنتيجة المعتمدة.
- Backend: يصادق الطلبات ويطبق الصلاحيات وينشئ الجلسات أو المهام ويحمي المفاتيح.
- AKOOL API: تنفذ مسار الصورة الرمزية أو الترجمة أو التحويل.
- مخزن المهام/الجلسات: يتابع المعرّفات والمالكين والحالة ونطاق الموافقة والانتهاء.
- قائمة المراجعة: تفحص الجودة والسياسة والترجمة والعلامة.
- التخزين الدائم: يحتفظ فقط بالمخرجات المعتمدة للمدة اللازمة.
توصي AKOOL حاليًا بطريقة x-api-key. احتفظ بالمفتاح في متغيرات backend أو مدير أسرار، ولا تضعه في المتصفح أو حزمة الهاتف أو مستودع عام أو مثال قابل للتنزيل. راجع إرشادات المصادقة.
قائمة التحقق قبل الإطلاق
☐ كل رحلة مستخدم مرتبطة بعائلة endpoints الصحيحة.
☐ مفاتيح API محفوظة في backend.
☐ التطبيق يميز بين الجلسات المباشرة والمهام غير المتزامنة.
☐ webhook أو الاستعلام يغطي الانتظار والمعالجة والنجاح والفشل.
☐ المخرجات المعتمدة منسوخة إلى تخزين خاضع للتحكم.
☐ وسائط الهوية لها تصريح موثق ومسار للسحب.
☐ الترجمة والتحويل خضعا لمراجعة بشرية.
☐ للصورة الرمزية حدود وتصعيد ومقاطعة وإغلاق.
أين تفيد واجهة وسائط موحدة؟
يمكن ربط صورة رمزية تستند إلى المعرفة بفيديوهات تهيئة مترجمة، أو توطين حملات معتمدة، أو الجمع بين مقدمي محتوى تفاعليين ودورات متعددة اللغات، أو تقديم التحويل مع فرض الموافقة والمراجعة. تأتي القيمة من التنسيق المشترك لا من زر واحد.
الخلاصة
تدعم AKOOL التفاعل المباشر عبر Streaming Avatar، والوسائط متعددة اللغات عبر Video Translation، وتحويل الهوية المصرح به عبر Face Swap أو Character Swap. ويتطلب الإنتاج أيضًا مصادقة آمنة في backend، وإذنًا صريحًا، وإدارة حالة، ومراجعة بشرية، وتخزينًا دائمًا، وضوابط حذف.
راجع وثائق AKOOL API وابدأ بحالة استخدام ضيقة يمكن مراجعتها بالكامل.
الأسئلة الشائعة
هل توجد نقطة AKOOL واحدة لكل مهام الوسائط؟
لا. يستخدم Streaming Avatar جلسات فورية، بينما تنشئ أدوات الترجمة والتحويل عادة مهام غير متزامنة تحتاج إلى متابعة ومراجعة.
هل يمكن للمتصفح استدعاء AKOOL مباشرة؟
في بيئة الإنتاج، مرّر الطلبات المصادق عليها عبر backend لحماية المفتاح وتطبيق الصلاحيات والحدود والسجلات وقواعد الموافقة.
ما API المناسب لإنسان رقمي يحاور المستخدم؟
Streaming Avatar. وإذا كانت الإجابات مبنية على مستندات أو روابط الشركة، أنشئ AKOOL Knowledge Base وأرسل knowledge_id عند إنشاء الجلسة.
هل نجاح Face Swap يعني أن الأصل جاهز للنشر؟
لا. يجب أيضًا فحص التصريح والسياق والشبه والجودة وأي إفصاح مطلوب.
الموارد
- وثائق AKOOL OpenAPI
- Streaming Avatar API
- Video Translation API
- Face Swap API
- المصادقة
- AKOOL Trust & Safety
