يجمع Wan 2.2 Animate بين صورة شخصية وفيديو مصدر يحدد الحركة. في سير عمل Character Swap API الموثق لدى AKOOL، توجه الصورة مظهر الشخصية بينما يوفّر ملف MP4 المصدر الأداء. يحدد مثال استجابة API النموذج الأساسي بأنه wavespeed-ai/wan-2.2/animate.
تتيح AKOOL هذه الإمكانية عبر Character Swap API. ويختلف ذلك عن مجرد اختيار نموذج عام لتحويل النص إلى فيديو من قائمة أدوات الفيديو بالذكاء الاصطناعي.
الخلاصة السريعة
- المظهر من الصورة: ارفع صورة شخصية بصيغة PNG أو JPEG.
- الحركة من الفيديو: قدّم ملف MP4 يتضمن الأداء الذي تريد نقله.
- animate وreplace وضعان مختلفان في API: ينقل
animateالحركة إلى صورة الشخصية، بينما ينفذreplaceسلوك استبدال الوجوه الموثق لنقطة النهاية. - احفظ معرّف المهمة: الإنشاء غير متزامن، لذا استخدم
_idالمسترجع لفحص الحالة وتنزيل الفيديو المكتمل قبل انتهاء صلاحية رابطه بعد سبعة أيام.
المحتويات
- ما هو Wan Animate؟
- ما الفرق بين وضعي animate وreplace؟
- كيف تُحضّر فيديو مرجع الحركة؟
- كيف تستخدم Wan Animate API عبر AKOOL؟
- ما المطالبات التي تساعد على تحريك الشخصيات؟
- لماذا يفشل نقل حركة الشخصيات بالذكاء الاصطناعي؟
- كيف تراجع النتيجة وتحفظها؟
- الأسئلة الشائعة
ما هو Wan Animate؟
Wan Animate سير عمل لتحريك الشخصيات بالاعتماد على المراجع: تحدد صورة واحدة مظهر الشخصية، ويوفر فيديو مصدر الحركة المطلوب تطبيقها. في Character Swap API لدى AKOOL، يجمع وضع animate الموثق بين هذين المدخلين، ويمكنه اختيارياً استخدام مطالبة نصية قصيرة لتوجيه النتيجة.
يسهل فهم سير العمل بوصفه ثلاث مواد:
| Input/output | Role |
|---|---|
| Character image | Defines the character you want to animate |
| Motion reference video | Supplies timing, body motion, and performance |
| Generated video | Combines the character appearance with the referenced motion |
تتطلب نقطة نهاية الإنشاء في AKOOL رابط صورة شخصية بصيغة PNG أو JPEG ورابط فيديو مصدر بصيغة MP4. يحدد مثال استجابة API النموذج بأنه wavespeed-ai/wan-2.2/animate، ما يدعم هذا الاسم كدليل خاص بـ API. ولا يُعد ذلك إثباتاً على وجود خيار بالاسم نفسه في قائمة الموقع العام.
ما الفرق بين وضعي animate وreplace؟
في نقطة النهاية الموثقة لدى AKOOL، يطبق animate حركة الفيديو المصدر على صورة الشخصية. أما replace فهو وضع مختلف يستبدل الوجوه في الفيديو المصدر باستخدام صورة الشخصية المقدمة. تنطبق هذه التعريفات على نقطة نهاية API هذه لدى AKOOL، وليس على كل منتج يستخدم عائلة نماذج Wan.
| Mode | Goal | Required inputs | What to review |
|---|---|---|---|
animate | Animate the supplied character using source-video motion | Character image + motion MP4 | Identity, body motion, clothing, hands, feet |
replace | Replace faces in the source video with the supplied character | Character image + source MP4 | Face match, tracking, pose changes, occlusion |
تستخدم نقطة النهاية animate افتراضياً عند عدم تحديد وضع.
هذا التمييز مهم لأن animate وreplace يصفان تحويلين مختلفين. إذا كان هدفك نقل حركة الشخصية بالذكاء الاصطناعي بالكامل، فابدأ بـ animate.
لسير عمل إنتاج مستقل يعتمد على Kling، راجع دليل AKOOL حول استبدال الشخصيات مع التحكم بالحركة. يستخدم Kling 2.6 الفكرة العامة نفسها التي تجمع صورة شخصية بأداء مرجعي، لكنه نموذج وسير عمل مختلفان.
كيف تُحضّر فيديو مرجع الحركة؟
استخدم أداءً مصدرياً واضحاً يطابق التأطير والأجزاء الظاهرة من الجسم في صورة الشخصية. كلما كان المرجع أوضح، سهل تحديد ما إذا كانت الأخطاء ناتجة عن المادة المصدر أم عن الإنشاء.
طابق التأطير
إذا أظهر فيديو الحركة مشياً بكامل الجسم، فاستخدم صورة شخصية توفر أيضاً معلومات كافية عن الجسم بالكامل.
إن إقران صورة وجه مقربة بالجري أو الرقص أو حركات الساقين الكبيرة يجبر النموذج على اختراع تفاصيل تشريحية لم تظهر في الصورة.
لتحسين اتساق الفيديو الموجّه بالمراجع، توصي AKOOL بموضوعات واضحة وتفاصيل هوية ظاهرة ومواد مرجعية تحدد العناصر التي تريد الحفاظ عليها.
أبقِ المؤدي ظاهراً
اختر مرجع حركة يبقى فيه المؤدي داخل الإطار.
تجنب المقاطع المصدر التي يحدث فيها ما يلي:
- تخرج القدمان من الإطار مراراً،
- تختفي اليدان خلف الجسم،
- يمر شخص آخر أمام الموضوع،
- تغير الكاميرا التأطير فجأة،
- يصبح المؤدي صغيراً جداً.
قلل الحجب
تجعل الذراعان المتقاطعتان واليدان المخفيتان والأدوات التي تغطي الجذع والالتفافات السريعة مراجعة نقل الأداء أصعب.
مرجع أفضل: الجسم بالكامل ظاهر، وحركة معتدلة، وكاميرا ثابتة.
مرجع أصعب: أقدام مقصوصة، ودوران متكرر، وأيدٍ مخفية خلف الأدوات، وقطعات مونتاج متعددة.
كيف تستخدم Wan Animate API عبر AKOOL؟
أرسل رابط صورة الشخصية ورابط MP4 المصدر إلى نقطة نهاية إنشاء Character Swap لدى AKOOL، واضبط mode على animate، وأضف مطالبة اختيارية، ثم احفظ _id المسترجع. استخدم المعرّف مع نقطة نهاية النتائج حتى تصل المهمة إلى completed.
نقطة نهاية الإنشاء الموثقة هي:
POST https://openapi.akool.com/api/open/v4/characterSwap/create
تقبل AKOOL رأس طلب x-api-key أو تفويض Bearer.
استخدم تعليمات Character Swap API الرسمية للحصول على تفاصيل المصادقة ونقطة النهاية الحالية.
مثال طلب مع إخفاء البيانات الحساسة
curl --location 'https://openapi.akool.com/api/open/v4/characterSwap/create' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"image": "https://example.com/approved-character.png",
"video": "https://example.com/reference-motion.mp4",
"resolution": "720p",
"mode": "animate",
"prompt": "Follow the reference performance with smooth motion. Keep the character appearance and clothing consistent."
}'
الحقول المهمة هي:
| Field | Purpose |
|---|---|
image | PNG/JPEG character-image URL |
video | MP4 motion-reference URL |
duration | Optional, 1 to 120 seconds; otherwise detected from source |
resolution | 480p, 720p, or 1080p |
mode | animate or replace |
prompt | Optional guidance, maximum 500 characters |
webhookurl | Optional completion callback |
هذه القيم معلمات موثقة لنقطة النهاية، وليست حدوداً عامة لـ Wan عبر جميع المنصات. تتضمن الاستجابة _id. احفظه.
لفحص المهمة:
GET https://openapi.akool.com/api/open/v3/content/video/infobymodelid?video_model_id=YOUR_TASK_ID
حالات المهمة هي:
1: في قائمة الانتظار2: قيد المعالجة3: مكتملة4: فاشلة
عندما تصل الحالة إلى 3، يظهر رابط الفيديو الناتج في الحقل video.
ما المطالبات التي تساعد على تحريك الشخصيات؟
تعامل مع النص كإرشاد، لا كمصدر للأداء. يجب أن يحدد مرجع الحركة الفعل. ينبغي أن تعزز المطالبة الهوية والتأطير والبساطة بدلاً من طلب حركة تتعارض مع الفيديو المصدر.
1. إيماءة بسيطة
طبق إيماءة التحية البطيئة من الفيديو المرجعي على الشخصية المقدمة. حافظ على الملابس والشعر نفسيهما. استخدم حركة سلسة.
2. مقدم
اتبع حركة يدي المؤدي المرجعي وإيقاعه. أبقِ الشخصية مواجهة للكاميرا. تجنب إضافة إيماءات إضافية.
3. المشي
اتبع دورة المشي المقدمة. حافظ على نسب الشخصية وملابسها. أبقِ القدمين ظاهرتين.
4. شخصية بأسلوب فني
حرك الشخصية المرسومة المقدمة باستخدام التوقيت المرجعي. حافظ على ألوانها المسطحة وحوافها المرسومة.
5. مطالبة للإصلاح
استخدم الشخصية نفسها ومقطعاً مرجعياً أبطأ وغير مقصوص. اجعل الحركة بسيطة وأبقِ الجسم كاملاً داخل الإطار.
لا تتعامل مع هذه المطالبات كصياغة سحرية. إنها قيود اختيارية على نطاق أداء يوفّره الفيديو بالفعل.
لماذا يفشل نقل حركة الشخصيات بالذكاء الاصطناعي؟
تنتج معظم الإخفاقات المرئية عن ضعف توافق المدخلات أو عن حركة تجبر النموذج على إعادة بناء معلومات غير موجودة في صورة الشخصية. أصلح زوج المواد المصدر قبل إضافة مزيد من النص إلى المطالبة.
| Symptom | Likely cause | First correction |
|---|---|---|
| Feet deform or disappear | Feet cropped in image/reference | Use full-body inputs |
| Hands look unstable | Hands hidden or crossing | Choose clearer hand motion |
| Body proportions drift | Image and performer builds differ strongly | Use a closer body/proportion match |
| Fast turn breaks identity | Large rotation or face occlusion | Slow the reference movement |
| Background shifts | Reference camera/background changes | Use a steadier source clip |
| Illustrated style softens | Motion reconstruction changes edges/textures | Simplify motion and inspect style drift |
يمكن لمرجع الحركة تقليل التخمين، لكنه لا يضمن الحفاظ المثالي على الشخصية. لهذا فإن تحضير المدخلات مهم بقدر أهمية المطالبة.
كيف تراجع النتيجة وتحفظها؟
اكتمال مهمة API يعني انتهاء الإنشاء فقط. ولا يعني اجتياز النتيجة المرئية فحص الجودة. راجع بداية المقطع ووسطه ونهايته قبل اعتماده.
تحقق من:
- الوجه: هل تظل الهوية قابلة للتعرف؟
- اليدان: هل تبقى الأصابع سليمة أثناء الإيماءات والتقاطعات؟
- القدمان: هل تظلان ثابتتين أثناء المشي أو حركة الجسم بالكامل؟
- الملابس: هل تبقى الألوان والنقوش والأشكال الخارجية متسقة؟
- الخلفية: هل تبقى متماسكة مع الحركة؟
تعيد نقطة نهاية النتائج لدى AKOOL المدة الفعلية والدقة والرصيد المخصوم ورابط الفيديو النهائي وسبب الإخفاق عند الاقتضاء.
تظل المواد الناتجة صالحة لمدة سبعة أيام، لذا نزّل النتائج المعتمدة وأرشفها سريعاً.
جرّب سير العمل
إذا كنت تحتاج إلى خيارات إنشاء أوسع تتجاوز سير عمل API هذا، فاستكشف أدوات الفيديو بالذكاء الاصطناعي لدى AKOOL.
لنهج آخر موجّه بالمراجع، اقرأ استبدال الشخصيات مع التحكم بالحركة. ولإرشادات الحفاظ على الشخصيات والهوية البصرية عبر المقاطع المرتبطة، راجع اتساق الفيديو الموجّه بالمراجع.
