דילוג לתוכן

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.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

קבצים כמו בדוגמה: ⁨‏3.00 ‏$⁩ 3,000 קרדיטי API הקבצים שלכם נמדדים לפני ההרצה הרצה בדף הזה

קבלת מפתח API
Mirage סנכרון שפתיים ואווטארים קלטים מסוג רפרנססנכרון שפתיים #avatar#lipsync#talking-head

וידאו אווטאר X של ראש מדבר, המונע באמצעות האודיו שלכם ורפרנס של תמונה, וידאו או אווטאר ממאגר

Mirage · ווידאו

התוצאה הראשונה שלך תופיע כאן

בנו בקשה למטה והריצו אותה עם מפתח ה־API שלכם. הפלטים מועתקים לאחסון שלנו ונשמרים לצמיתות או למשך 7 ימים ללא תשלום.

בנה בקשה

הפקדים נוצרים מסכמת המודל. הקוד והמחיר מתעדכנים כשמשנים אותם.

•חובה audio_url
גרור קובץ, או

כתובת HTTPS ציבורית לאודיו שמניע את הווידאו שנוצר, נגישה ללא כותרות הרשאה או קובצי Cookie. פורמטי האודיו המקובלים הם FLAC, Opus או Vorbis, AAC או ALAC, PCM WAV או AIFF ו־MP3. הקובץ חייב להכיל זרם מונו או סטריאו יחיד, להימשך 3–180 שניות, לתפוס לכל היותר 64 MiB ולהיות בעל קצב דגימה של 8–48 kHz.

מתקדם video_reference_url · avatar · image_reference_url

כתובת HTTPS של וידאו ייחוס, נגישה לציבור ללא כותרות הרשאה או קובצי Cookie, עבור קובץ המכיל בדיוק זרם וידאו אחד ולפחות מקטע מתאים אחד באורך 1 שנייה שישמש כייחוס; האודיו מתעלמים ממנו. הקבצים המקובלים הם .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 של תמונת ייחוס, נגישה לציבור ללא קובצי Cookie או כותרות הרשאה; אספקת 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.com/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.com/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 ציבורית לאודיו שמניע את הווידאו שנוצר, נגישה ללא כותרות הרשאה או קובצי Cookie. פורמטי האודיו המקובלים הם FLAC, Opus או Vorbis, AAC או ALAC, PCM WAV או AIFF ו־MP3. הקובץ חייב להכיל זרם מונו או סטריאו יחיד, להימשך 3–180 שניות, לתפוס לכל היותר 64 MiB ולהיות בעל קצב דגימה של 8–48 kHz.
video_reference_urlאופציונלי
סוגstring | null
כתובת HTTPS של וידאו ייחוס, נגישה לציבור ללא כותרות הרשאה או קובצי Cookie, עבור קובץ המכיל בדיוק זרם וידאו אחד ולפחות מקטע מתאים אחד באורך 1 שנייה שישמש כייחוס; האודיו מתעלמים ממנו. הקבצים המקובלים הם .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
עוד 5Neha (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 של תמונת ייחוס, נגישה לציבור ללא קובצי Cookie או כותרות הרשאה; אספקת 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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
הקבצים שלכם, הבחירה שלכםכל outputs[].url הוא עותק באחסון שלנו: נשמר לצמיתות (בתשלום לפי GB-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
video
object {url, content_type, file_name, file_size}

מודלים נוספים: סנכרון שפתיים ואווטארים

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/mirage-api/avatar-x/reference-to-video.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt