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

Avatar X

אינטעגרירן

מאָדעל־id mirage-api/avatar-x/text-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/text-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

דער דאָזיקער ריקוועסט: ≈⁨$ 54.00⁩ 54,000 API־קרעדיטן · ≈ ⁨₽ 5,809.30⁩ לויפֿן עס אויף דער דאָזיקער בלאַט

באַקומען אַן API שליסל
Mirage ליפּסינק און אַוואַטאַרן רעפֿערענץ־אײַנגאַבעסליפּסינק #avatar#lipsync#talking-head

רעדנדיקער אַוואַטאַר־ווידעא פֿון אַ סקריפּט, מיט אַ סטאַק־אַוואַטאַר אָדער אײַער אייגענעם רעפֿערענץ־ווידעא און קול

Mirage · ווידעא

דאָ קומט אײַער ערשטער רעזולטאַט

בויט אונטן אַ בקשה און לויפט זי מיט אײַער API שליסל. רעזולטאַטן ווערן קאַפּירט צו אונדזער סטאָרידזש, געהאַלטן אויף אייביק אָדער 7 טעג אומזיסט.

בויען אַ בעטן

קאָנטראָלן ווערן דזשענערירט פֿון דעם מאָדעל־סכעמע. דער קאָד און דער פּרײַז דערהײַנטיקן זיך ווען איר ענדערט זיי.

•פארלאנגט 88 / 1500

סקריפּט באַגרענעצט סײַ דורך צאָל אותיות סײַ דורך גענערירטער געדויער: די רעדע טאָר נישט איבערגיין 180 סעקונדעס, אַפֿילו ווען דער רעדע־קצב מאַכט אַ קירצער סקריפּט לענגער ווי דער שיעור. צושטעלן 50 ביז 1,500 אותיות; דער מינימום פֿון 50 אותיות גיט געוויינטלעך בערך פֿיר סעקונדעס רעדע.

פֿאָרגעשריטן avatar · video_reference_url · audio_reference_url
סטאַנדאַרט Jasmine

סטאַק־אויסזען־און־קול אויסקלייבונג, ניט נייטיק ווען סײַ video_reference_url סײַ audio_reference_url זענען צוגעשטעלט, ווײַל די רעפֿערענצן פֿאַרבייטן עס גאָר. ניצן None צו לאָזן דעם אַוואַטאַר ניט־באַשטימט, אָדער קאַפּירן אַן פּינקטלעכן Avatar־ווערט נאָך אַ פּריוויו פֿון אַלע אָפּציעס אינעם [avatar catalog](https://captions.ai/help/docs/api/actor-catalog).

רעפֿערענץ־ווידעא־URL וואָס פֿאַרבײַט דעם אויסגעקליבענעם אַוואַטאַר און פֿאָדערט audio_reference_url; יעדן אַודיאָ עמבעדירט אינעם ווידעא ווערט איגנאָרירט. דער מעדיע מוז געדויערן 1 ביז 120 סעקונדעס, בלײַבן אין 1 GiB, און האָבן אַן אַרויסווייַז־אַספּעקט־פֿאַרהעלטעניש אין 5% פֿון 9:16 אָדער 16:9; געשטיצטע קאָדעק־קאַנטיינער־קאָמבינאַציעס זענען H.264, H.265/HEVC אָדער ProRes אין .mp4, .mov אָדער .m4v, און VP8 אָדער VP9 אין .webm. די אָפּהאָלונג מוז זײַן פּובליק איבער HTTPS אָן קיכלעך אָדער דערלויבעניש־העדערס.

HTTPS URL פֿון אַ קול־רעפֿערענץ, וואָס פֿאָדערט אַן באַגלייטנדיקן video_reference_url און מאַכט דעם אויסגעקליבענעם אַוואַטאַר איגנאָרירט; די אָפּהאָלונג מוז אַרבעטן פּובליק אָן דערלויבעניש־העדערס אָדער קיכלעך. פּראַסעסינג ניצט נאָר די ערשטע 60 סעקונדעס, אָבער דער פֿײַל מוז געדויערן 10 ביז 180 סעקונדעס, בלײַבן אין 64 MiB, און אַנטהאַלטן איין מאָנאָ־ אָדער סטערעאָ־סטרים בײַ 8 ביז 48 kHz. אנגענומענע פֿאָרמאַטן אַרײַננעמען FLAC, MP3, PCM WAV אָדער AIFF, AAC אָדער ALAC, און Opus אָדער Vorbis.

POST /run/mirage-api/avatar-x/text-to-video?wait=20 פּרײַז → ⁨$ 54.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/text-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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"

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

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Avatar X

מאַכט פֿון אַ `script` מיט 50 ביז 1,500 צייכנס אַ רעדנדיקן אַוואַטאַר־ווידעא, מיט גענערירטער רייד באַגרענעצט צו 180 סעקונדעס. קלײַבט אַ סטאַק `avatar` ווי Jasmine, Luke אָדער Maya, אַרײַנגערעכנט 16:9 וואַריאַנטן. אַנדערש צושטעלט ביידע `video_reference_url` און `audio_reference_url` צו נוצן אײַער אייגענע פֿילמונג און קול־רעפֿערענץ; דעמאָלט ווערט דער סטאַק־אַוואַטאַר איגנאָרירט.

פּאַראַמעטערס

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
scriptפארלאנגט
טיפּstring
≤ 1,500 כאַראַקטערן≥ 50 כאַראַקטערן
סקריפּט באַגרענעצט סײַ דורך צאָל אותיות סײַ דורך גענערירטער געדויער: די רעדע טאָר נישט איבערגיין 180 סעקונדעס, אַפֿילו ווען דער רעדע־קצב מאַכט אַ קירצער סקריפּט לענגער ווי דער שיעור. צושטעלן 50 ביז 1,500 אותיות; דער מינימום פֿון 50 אותיות גיט געוויינטלעך בערך פֿיר סעקונדעס רעדע.
avatarאָפּציאָנעל
טיפּenum
סטאַנדאַרטJasmine
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)
סטאַק־אויסזען־און־קול אויסקלייבונג, ניט נייטיק ווען סײַ video_reference_url סײַ audio_reference_url זענען צוגעשטעלט, ווײַל די רעפֿערענצן פֿאַרבייטן עס גאָר. ניצן None צו לאָזן דעם אַוואַטאַר ניט־באַשטימט, אָדער קאַפּירן אַן פּינקטלעכן Avatar־ווערט נאָך אַ פּריוויו פֿון אַלע אָפּציעס אינעם [avatar catalog](https://captions.ai/help/docs/api/actor-catalog).
video_reference_urlאָפּציאָנעל
טיפּstring | null
רעפֿערענץ־ווידעא־URL וואָס פֿאַרבײַט דעם אויסגעקליבענעם אַוואַטאַר און פֿאָדערט audio_reference_url; יעדן אַודיאָ עמבעדירט אינעם ווידעא ווערט איגנאָרירט. דער מעדיע מוז געדויערן 1 ביז 120 סעקונדעס, בלײַבן אין 1 GiB, און האָבן אַן אַרויסווייַז־אַספּעקט־פֿאַרהעלטעניש אין 5% פֿון 9:16 אָדער 16:9; געשטיצטע קאָדעק־קאַנטיינער־קאָמבינאַציעס זענען H.264, H.265/HEVC אָדער ProRes אין .mp4, .mov אָדער .m4v, און VP8 אָדער VP9 אין .webm. די אָפּהאָלונג מוז זײַן פּובליק איבער HTTPS אָן קיכלעך אָדער דערלויבעניש־העדערס.
audio_reference_urlאָפּציאָנעל
טיפּstring | null
HTTPS URL פֿון אַ קול־רעפֿערענץ, וואָס פֿאָדערט אַן באַגלייטנדיקן video_reference_url און מאַכט דעם אויסגעקליבענעם אַוואַטאַר איגנאָרירט; די אָפּהאָלונג מוז אַרבעטן פּובליק אָן דערלויבעניש־העדערס אָדער קיכלעך. פּראַסעסינג ניצט נאָר די ערשטע 60 סעקונדעס, אָבער דער פֿײַל מוז געדויערן 10 ביז 180 סעקונדעס, בלײַבן אין 64 MiB, און אַנטהאַלטן איין מאָנאָ־ אָדער סטערעאָ־סטרים בײַ 8 ביז 48 kHz. אנגענומענע פֿאָרמאַטן אַרײַננעמען FLAC, MP3, PCM WAV אָדער AIFF, AAC אָדער ALAC, און Opus אָדער Vorbis.
פארלאנגט

אויסגאַבע

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "mirage-api/avatar-x/text-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": 54000,
    "usd": "54.00",
    "charged": 54000,
    "refunded": 0
  },
  "input": {
    "script": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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 איז אַ קאַפּיע אין אונדזער סטאָרידזש: געהאַלטן אויף אייביק (באַצאָלט פּער 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/text-to-video.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt