שפּרינגען צו אינהאַלט

Mirage Avatar X

אינטעגרירן

מאָדעל־id 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 אַדרעס פֿאַר דעם אַודיאָ וואָס דרײַבט דעם גענערירטן ווידעא, צוטריטלעך אָן דערלויבעניש־העדערס אָדער קיכלעך. אנגענומענע אַודיאָ־פֿאָרמאַטן זענען FLAC, Opus אָדער Vorbis, AAC אָדער ALAC, PCM WAV אָדער AIFF, און MP3. דער פֿײַל מוז אַנטהאַלטן איין מאָנאָ־ אָדער סטערעאָ־סטרים, געדויערן 3–180 סעקונדעס, פֿאַרנעמען נישט מער ווי 64 MiB, און האָבן אַ סאַמפּל־קורס פֿון 8–48 kHz.

פֿאָרגעשריטן video_reference_url · avatar · image_reference_url

HTTPS URL פֿון אַ רעפֿערענץ־ווידעא, פּובליק צוטריטלעך אָן דערלויבעניש־העדערס אָדער קיכלעך, פֿאַר אַ פֿײַל מיט פּונקט איין ווידעא־סטרים און לכל הפּחות איין פּאַסיקן 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. צו אויסקלײַבן אַ וויסועל, פּריוויוען די אָפּציעס אין דעם [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) און קאַפּירן דעם פּינקטלעכן Avatar־ווערט.

HTTPS URL פֿון אַ רעפֿערענץ־בילד, פּובליק צוטריטלעך אָן קיכלעך אָדער דערלויבעניש־העדערס; צושטעלן 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"

לויפֿן דעם ריקוועסט

אײַער 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 URL פֿון אַ רעפֿערענץ־ווידעא, פּובליק צוטריטלעך אָן דערלויבעניש־העדערס אָדער קיכלעך, פֿאַר אַ פֿײַל מיט פּונקט איין ווידעא־סטרים און לכל הפּחות איין פּאַסיקן 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
+5 נאָךNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
סטאַק־וויסועל־אויסקלייבונג, גענוצט נאָר ווען קיין בילד־ אָדער ווידעא־רעפֿערענץ ווערט נישט צוגעשטעלט; None און דער סטאַנדאַרט לאָזן עס ביידע ניט־באַשטימט. אַודיאָ ווערט קיינמאָל נישט צוגעשטעלט דורך דעם וויסועל און קומט שטענדיק פֿון audio_url. צו אויסקלײַבן אַ וויסועל, פּריוויוען די אָפּציעס אין דעם [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) און קאַפּירן דעם פּינקטלעכן Avatar־ווערט.
image_reference_urlאָפּציאָנעל
טיפּstring | null
HTTPS URL פֿון אַ רעפֿערענץ־בילד, פּובליק צוטריטלעך אָן קיכלעך אָדער דערלויבעניש־העדערס; צושטעלן video_reference_url מאַכט עס איגנאָרירט. אָננעמט איין סטאַטישן בילד אין .jpg, .jpeg, .png אָדער .webp פֿאָרמאַט, באַגרענעצט צו 25 MiB און 25 מעגאַפּיקסעל. דער קירצערער ראַנד מוז זײַן לכל הפּחות 512 px און קיין ראַנד טאָר נישט איבערגיין 8192 px; דער אַספּעקט־פֿאַרהעלטעניש מוז זײַן אין 5% פֿון 9:16 אָדער 16:9.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 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/yi/developers/models/mirage-api/avatar-x/reference-to-video.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt