Мазмұнға өту

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
Файлды тастаңыз немесе

Генерацияланған бейнені дыбыстайтын, авторизация тақырыптары немесе cookie файлдарынсыз қолжетімді жалпыға ашық HTTPS мекенжайы. Қабылданатын аудио пішімдері: FLAC, Opus немесе Vorbis, AAC немесе ALAC, PCM WAV немесе AIFF және MP3. Файлда бір моно немесе стерео ағын болуы, ұзақтығы 3–180 секунд, өлшемі 64 MiB-тан аспауы және дискреттеу жиілігі 8–48 kHz болуы тиіс.

Қосымша video_reference_url · avatar · image_reference_url

Анықтамалық бейне ретінде пайдаланылатын, авторизация тақырыптары немесе cookie файлдарынсыз жалпыға ашық қолжетімді HTTPS URL. Файлда дәл бір бейне ағыны және анықтама ретінде қолданылатын кемінде бір жарамды 1 секундтық сегмент болуы тиіс; аудио ескерілмейді. Қабылданатын файл жұптары: .mp4, .mov немесе .m4v пішімдері H.264, H.265/HEVC немесе ProRes кодектерімен, не .webm пішімі VP8 немесе VP9 кодектерімен; ұзақтығы 1–120 секунд, өлшемі 1 GiB-тан аспауы, ал кадр өлшемдерінің арақатынасы 9:16 немесе 16:9 мәндерінің бірінен 5%-дан артық ауытқымауы тиіс. image_reference_url де берілсе, бейне басымдыққа ие болады.

Кескін немесе бейне анықтамасы берілмегенде ғана қолданылатын дайын көрнекі нысанды таңдау; None және әдепкі мән екеуі де оны орнатылмаған күйде қалдырады. Бұл көрнекі нысан аудио бермейді, аудио әрқашан audio_url арқылы алынады. Көрнекі нысанды таңдау үшін опцияларды [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) ішінен алдын ала қарап, оның дәл Avatar мәнін көшіріңіз.

Cookie файлдарын немесе авторизация тақырыптарынсыз жалпыға қолжетімді анықтамалық кескіннің HTTPS URL мекенжайы; video_reference_url берілсе, бұл мән еленбейді. .jpg, .jpeg, .png немесе .webp пішіміндегі бір статикалық кескін қабылданады, өлшемі 25 MiB және 25 мегапиксельмен шектеледі. Қысқа қыры кемінде 512 px, екі қырының ешқайсысы 8192 px-тан аспауы, ал арақатынасы 9:16 немесе 16:9 мәндерінің бірінен 5%-дан артық ауытқымауы тиіс.

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-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Mirage Avatar X туралы

`audio_url` (3–180 секунд) арқылы ерін қимылы синхрондалған аватар бейнесін жасайды. Көрініс `video_reference_url`, `image_reference_url` немесе дайын `avatar` арқылы беріледі; екеуі де көрсетілсе, бейне анықтамасы кескіннен басым болады. Аватар опциясы тек көріністі береді, аудио бермейді. Анықтамалық URL мекенжайлары HTTPS арқылы жалпыға қолжетімді болуы керек.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
audio_urlміндетті audio
Түріurl · audio
Генерацияланған бейнені дыбыстайтын, авторизация тақырыптары немесе cookie файлдарынсыз қолжетімді жалпыға ашық HTTPS мекенжайы. Қабылданатын аудио пішімдері: FLAC, Opus немесе Vorbis, AAC немесе ALAC, PCM WAV немесе AIFF және MP3. Файлда бір моно немесе стерео ағын болуы, ұзақтығы 3–180 секунд, өлшемі 64 MiB-тан аспауы және дискреттеу жиілігі 8–48 kHz болуы тиіс.
video_reference_urlміндетті емес
Түріstring | null
Анықтамалық бейне ретінде пайдаланылатын, авторизация тақырыптары немесе cookie файлдарынсыз жалпыға ашық қолжетімді HTTPS URL. Файлда дәл бір бейне ағыны және анықтама ретінде қолданылатын кемінде бір жарамды 1 секундтық сегмент болуы тиіс; аудио ескерілмейді. Қабылданатын файл жұптары: .mp4, .mov немесе .m4v пішімдері H.264, H.265/HEVC немесе ProRes кодектерімен, не .webm пішімі VP8 немесе VP9 кодектерімен; ұзақтығы 1–120 секунд, өлшемі 1 GiB-тан аспауы, ал кадр өлшемдерінің арақатынасы 9:16 немесе 16:9 мәндерінің бірінен 5%-дан артық ауытқымауы тиіс. 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 арқылы алынады. Көрнекі нысанды таңдау үшін опцияларды [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) ішінен алдын ала қарап, оның дәл Avatar мәнін көшіріңіз.
image_reference_urlміндетті емес
Түріstring | null
Cookie файлдарын немесе авторизация тақырыптарынсыз жалпыға қолжетімді анықтамалық кескіннің HTTPS URL мекенжайы; video_reference_url берілсе, бұл мән еленбейді. .jpg, .jpeg, .png немесе .webp пішіміндегі бір статикалық кескін қабылданады, өлшемі 25 MiB және 25 мегапиксельмен шектеледі. Қысқа қыры кемінде 512 px, екі қырының ешқайсысы 8192 px-тан аспауы, ал арақатынасы 9:16 немесе 16:9 мәндерінің бірінен 5%-дан артық ауытқымауы тиіс.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың 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-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
video
object {url, content_type, file_name, file_size}

Қосымша модельдер: Ерін синхрондауы және аватарлар

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/mirage-api/avatar-x/reference-to-video.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt