AI Character Consistency API — حافظ على تناسق الأحرف

ما هي واجهة برمجة تطبيقات تناسق الأحرف؟

تستخدم واجهة برمجة التطبيقات الخاصة بتناسق الأحرف صورة مرجعية واحدة أو أكثر لإعادة إنتاج نفس الموضوع في مشاهد وأوضاع وأزياء وزوايا الكاميرا الجديدة. تُعد نماذج الصور المرجعية مفيدة لأوراق الأحرف واللقطات الثابتة؛ نماذج الإشارة إلى الفيديو تحمل هذه الهوية إلى الحركة.

يعرض Muapi كلا العائلتين من خلال نفس تدفق الإرسال والاستطلاع REST. اختر نموذجًا حسب حجم الحزمة المرجعية، أو طريقة الإدخال، أو السعر، أو ما إذا كان الإخراج يجب أن يكون صورة أو مقطع فيديو.

القدرات الرئيسية

مقارنة نموذج تناسق الشخصية التمثيلية

تختلف الحدود المرجعية والطرائق المدعومة والأسعار حسب الطراز. تحقق من مخطط Playground الخاص بكل نموذج قبل إرسال طلبات الإنتاج.

كيفية استدعاء واجهة برمجة تطبيقات تناسق الأحرف

1. اختر نموذج صورة أو فيديو. حدد نموذجًا بناءً على نوع الإخراج وحجم الحزمة المرجعية والطريقة والميزانية.
2. استضافة المراجع الخاصة بك. قم بتحميل الصور المصدر من خلال POST /api/v1/upload_file، أو استخدم عناوين URL التي يمكن الوصول إليها بشكل عام والتي تقبلها نقطة النهاية المحددة.
3. إرسال حقول نوع المهمة. اتصل بـ POST /api/v1/{model-slug} باستخدام Images_list والمطالبة وأي مرجع خاص بالنموذج أو حقول نوع المهمة.
4. الاستطلاع والاستمرار في النتيجة. تحقق من GET /api/v1/predictions/{request_id}/result حتى تكتمل الحالة، ثم قم بتخزين الصورة أو الفيديو الذي تم إرجاعه.

curl -X POST https://api.muapi.ai/api/v1/seedance-2.5-omni-reference \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "images_list": [
      "https://example.com/character-front.jpg",
      "https://example.com/character-side.jpg"
    ],
    "prompt": "the character walking through a neon-lit city street at night",
    "omni_reference_task_type": "reference",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/seedance-2.5-omni-reference",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "images_list": [
            "https://example.com/character-front.jpg",
            "https://example.com/character-side.jpg",
        ],
        "prompt": "the character walking through a neon-lit city street at night",
        "omni_reference_task_type": "reference",
        "duration": 5,
        "aspect_ratio": "16:9",
    },
)
request_id = response.json()["request_id"]

result = requests.get(
    f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())

الأسئلة المتداولة