Перейти к содержимому

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-кредитов · ≈ 314,17 ₽ ваши файлы измеряются перед запуском Запустить на этой странице

Получить 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 URL эталонного видео без заголовков авторизации и файлов 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 URL эталонного изображения без файлов 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 URL эталонного видео без заголовков авторизации и файлов 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 URL эталонного изображения без файлов cookie и заголовков авторизации; при указании 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"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
video
object {url, content_type, file_name, file_size}

Другие модели: Синхронизация губ и аватары

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/ru/developers/models/mirage-api/avatar-x/reference-to-video.md. Все модели и руководства: https://doitong.com/developers/llms.txt