تخطّي إلى المحتوى

Mirage Avatar X

التكامل

معرّف النموذج mirage-api/avatar-x/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/mirage-api/avatar-x/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏3.00 $⁩ 3,000 رصيد API · ≈ ⁨‏314.07 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Mirage مزامنة الشفاه والصور الرمزية مدخلات مرجعيةمزامنة الشفاه #avatar#lipsync#talking-head

فيديو رأس ناطق من صورة رمزية X مدفوع بصوتك وبصورة أو فيديو أو مرجع صورة رمزية جاهز

Mirage · فيديو

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب audio_url
أفلت ملفًا، أو

عنوان HTTPS عام للصوت الذي يقود الفيديو المُولّد، ويمكن الوصول إليه دون ترويسات تفويض أو ملفات تعريف ارتباط. تنسيقات الصوت المقبولة هي FLAC وOpus أو Vorbis وAAC أو ALAC وPCM WAV أو AIFF وMP3. يجب أن يحتوي الملف على دفق أحادي أو استريو واحد، وأن تتراوح مدته من 3 إلى 180 ثانية، وألا يتجاوز حجمه 64 MiB، وأن يكون معدل أخذ العينات من 8 إلى 48 kHz.

متقدم video_reference_url · avatar · image_reference_url

عنوان HTTPS لفيديو مرجعي، متاح للعامة دون ترويسات تفويض أو ملفات تعريف ارتباط، لملف يحتوي على دفق فيديو واحد بالضبط ومقطع مناسب مدته ثانية واحدة على الأقل لاستخدامه كمرجع؛ يُتجاهل الصوت. الملفات المقبولة هي .mp4 أو .mov أو .m4v مع H.264 أو H.265/HEVC أو ProRes، أو .webm مع VP8 أو VP9؛ يجب أن تتراوح المدة من 1 إلى 120 ثانية، وألا يتجاوز الحجم 1 GiB، وأن تكون نسبة العرض إلى الارتفاع ضمن 5% من 9:16 أو 16:9. إذا تم توفير image_reference_url أيضًا، فستكون الأولوية للفيديو.

اختيار مرئي جاهز يُستخدم فقط عند عدم توفير مرجع صورة أو فيديو؛ يترك كل من None والقيمة الافتراضية هذا الحقل غير معيّن. لا يوفّر هذا المرئي صوتًا مطلقًا، ويأتي الصوت دائمًا من audio_url. لاختيار مرئي، عاين الخيارات في [كتالوج الصور الرمزية](https://captions.ai/help/docs/api/actor-catalog) وانسخ قيمة Avatar المطابقة تمامًا.

عنوان HTTPS لصورة مرجعية، متاح للعامة دون ملفات تعريف ارتباط أو ترويسات تفويض؛ يؤدي توفير video_reference_url إلى تجاهلها. يقبل صورة ثابتة واحدة بتنسيق .jpg أو .jpeg أو .png أو .webp، بحجم لا يتجاوز 25 MiB و25 ميغابكسل. يجب ألا يقل طول الحافة الأقصر عن 512 px وألا تتجاوز أي حافة 8192 px؛ ويجب أن تكون نسبة العرض إلى الارتفاع ضمن 5% من 9:16 أو 16:9.

POST /run/mirage-api/avatar-x/reference-to-video?wait=20 عرض السعر → ⁨‏3.00 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/mirage-api/avatar-x/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Mirage Avatar X

ينشئ فيديو أفاتار متزامنًا مع حركة الشفاه من `audio_url` (من 3 إلى 180 ثانية). تأتي العناصر المرئية من `video_reference_url` أو `image_reference_url` أو `avatar` جاهز؛ ويُعطى مرجع الفيديو الأولوية على الصورة عند تقديم كليهما. يوفّر خيار الأفاتار العناصر المرئية فقط، وليس الصوت. يجب أن تكون عناوين URL المرجعية قابلة للوصول علنًا عبر HTTPS.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
audio_urlمطلوب audio
النوعurl · audio
عنوان HTTPS عام للصوت الذي يقود الفيديو المُولّد، ويمكن الوصول إليه دون ترويسات تفويض أو ملفات تعريف ارتباط. تنسيقات الصوت المقبولة هي FLAC وOpus أو Vorbis وAAC أو ALAC وPCM WAV أو AIFF وMP3. يجب أن يحتوي الملف على دفق أحادي أو استريو واحد، وأن تتراوح مدته من 3 إلى 180 ثانية، وألا يتجاوز حجمه 64 MiB، وأن يكون معدل أخذ العينات من 8 إلى 48 kHz.
video_reference_urlاختياري
النوعstring | null
عنوان HTTPS لفيديو مرجعي، متاح للعامة دون ترويسات تفويض أو ملفات تعريف ارتباط، لملف يحتوي على دفق فيديو واحد بالضبط ومقطع مناسب مدته ثانية واحدة على الأقل لاستخدامه كمرجع؛ يُتجاهل الصوت. الملفات المقبولة هي .mp4 أو .mov أو .m4v مع H.264 أو H.265/HEVC أو ProRes، أو .webm مع VP8 أو VP9؛ يجب أن تتراوح المدة من 1 إلى 120 ثانية، وألا يتجاوز الحجم 1 GiB، وأن تكون نسبة العرض إلى الارتفاع ضمن 5% من 9:16 أو 16:9. إذا تم توفير image_reference_url أيضًا، فستكون الأولوية للفيديو.
avatarاختياري
النوعenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 أخرىNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
اختيار مرئي جاهز يُستخدم فقط عند عدم توفير مرجع صورة أو فيديو؛ يترك كل من None والقيمة الافتراضية هذا الحقل غير معيّن. لا يوفّر هذا المرئي صوتًا مطلقًا، ويأتي الصوت دائمًا من audio_url. لاختيار مرئي، عاين الخيارات في [كتالوج الصور الرمزية](https://captions.ai/help/docs/api/actor-catalog) وانسخ قيمة Avatar المطابقة تمامًا.
image_reference_urlاختياري
النوعstring | null
عنوان HTTPS لصورة مرجعية، متاح للعامة دون ملفات تعريف ارتباط أو ترويسات تفويض؛ يؤدي توفير video_reference_url إلى تجاهلها. يقبل صورة ثابتة واحدة بتنسيق .jpg أو .jpeg أو .png أو .webp، بحجم لا يتجاوز 25 MiB و25 ميغابكسل. يجب ألا يقل طول الحافة الأقصر عن 512 px وألا تتجاوز أي حافة 8192 px؛ ويجب أن تكون نسبة العرض إلى الارتفاع ضمن 5% من 9:16 أو 16:9.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "mirage-api/avatar-x/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 3000,
    "usd": "3.00",
    "charged": 3000,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size}

مزيد من النماذج: مزامنة الشفاه والصور الرمزية

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/mirage-api/avatar-x/reference-to-video.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt