Přejít na obsah

Mirage Avatar X

Integrace

ID modelu 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"

Soubory jako v příkladu: 3,00 $ 3 000 kreditů API vaše soubory se před spuštěním změří Spustit na této stránce

Získat API klíč
Mirage Synchronizace rtů a avataři Referenční vstupySynchronizace rtů #avatar#lipsync#talking-head

Mluvící video avatara Avatar X řízené vaším zvukem a obrázkem, videem nebo referencí stock avatara

Mirage · Video

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné audio_url
Přetáhněte soubor nebo

Veřejně dostupná HTTPS adresa zvuku, který řídí vygenerované video, přístupná bez autorizačních hlaviček nebo cookies. Přijímané formáty zvuku jsou FLAC, Opus nebo Vorbis, AAC nebo ALAC, PCM WAV nebo AIFF a MP3. Soubor musí obsahovat jediný mono nebo stereo stream, trvat 3–180 sekund, mít nejvýše 64 MiB a vzorkovací frekvenci 8–48 kHz.

Pokročilé video_reference_url · avatar · image_reference_url

Veřejně dostupná HTTPS URL referenčního videa bez autorizačních hlaviček nebo cookies. Soubor musí obsahovat přesně jeden video stream a alespoň jeden vhodný 1sekundový úsek pro použití jako reference; zvuk se ignoruje. Přijímané soubory jsou .mp4, .mov nebo .m4v s H.264, H.265/HEVC nebo ProRes, případně .webm s VP8 nebo VP9; délka musí být 1 až 120 sekund, velikost nejvýše 1 GiB a poměr stran zobrazení musí být v rozmezí 5 % od 9:16 nebo 16:9. Pokud je zadán také image_reference_url, přednost má video.

Výběr vizuálu z nabídky použitý pouze tehdy, když není zadána reference obrázku ani videa; None i výchozí hodnota jej ponechají nenastavený. Tento vizuál nikdy nedodává zvuk, který vždy pochází z audio_url. Vizuál vyberete tak, že zobrazíte možnosti v [katalogu avatarů](https://captions.ai/help/docs/api/actor-catalog) a zkopírujete přesnou hodnotu Avatar.

Veřejně dostupná HTTPS URL referenčního obrázku bez cookies nebo autorizačních hlaviček; zadání video_reference_url způsobí její ignorování. Přijímá jeden statický obrázek ve formátu .jpg, .jpeg, .png nebo .webp, s velikostí nejvýše 25 MiB a 25 megapixelů. Kratší strana musí mít alespoň 512 px a žádná strana nesmí překročit 8192 px; poměr stran musí být v rozmezí 5 % od 9:16 nebo 16:9.

POST /run/mirage-api/avatar-x/reference-to-video?wait=20 cena → 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"

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu Mirage Avatar X

Vytváří video avatara se synchronizací rtů z `audio_url` (3 až 180 sekund). Vizuální podobu poskytuje `video_reference_url`, `image_reference_url` nebo stock `avatar`; pokud jsou zadány obě reference, přednost má video. Volba avatara poskytuje pouze obraz, nikoli zvuk. Referenční adresy URL musí být veřejně dostupné přes HTTPS.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
audio_urlpovinné audio
Typurl · audio
Veřejně dostupná HTTPS adresa zvuku, který řídí vygenerované video, přístupná bez autorizačních hlaviček nebo cookies. Přijímané formáty zvuku jsou FLAC, Opus nebo Vorbis, AAC nebo ALAC, PCM WAV nebo AIFF a MP3. Soubor musí obsahovat jediný mono nebo stereo stream, trvat 3–180 sekund, mít nejvýše 64 MiB a vzorkovací frekvenci 8–48 kHz.
video_reference_urlvolitelné
Typstring | null
Veřejně dostupná HTTPS URL referenčního videa bez autorizačních hlaviček nebo cookies. Soubor musí obsahovat přesně jeden video stream a alespoň jeden vhodný 1sekundový úsek pro použití jako reference; zvuk se ignoruje. Přijímané soubory jsou .mp4, .mov nebo .m4v s H.264, H.265/HEVC nebo ProRes, případně .webm s VP8 nebo VP9; délka musí být 1 až 120 sekund, velikost nejvýše 1 GiB a poměr stran zobrazení musí být v rozmezí 5 % od 9:16 nebo 16:9. Pokud je zadán také image_reference_url, přednost má video.
avatarvolitelné
Typenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 dalšíchNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Výběr vizuálu z nabídky použitý pouze tehdy, když není zadána reference obrázku ani videa; None i výchozí hodnota jej ponechají nenastavený. Tento vizuál nikdy nedodává zvuk, který vždy pochází z audio_url. Vizuál vyberete tak, že zobrazíte možnosti v [katalogu avatarů](https://captions.ai/help/docs/api/actor-catalog) a zkopírujete přesnou hodnotu Avatar.
image_reference_urlvolitelné
Typstring | null
Veřejně dostupná HTTPS URL referenčního obrázku bez cookies nebo autorizačních hlaviček; zadání video_reference_url způsobí její ignorování. Přijímá jeden statický obrázek ve formátu .jpg, .jpeg, .png nebo .webp, s velikostí nejvýše 25 MiB a 25 megapixelů. Kratší strana musí mít alespoň 512 px a žádná strana nesmí překročit 8192 px; poměr stran musí být v rozmezí 5 % od 9:16 nebo 16:9.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
video
object {url, content_type, file_name, file_size}

Další modely: Synchronizace rtů a avataři

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/mirage-api/avatar-x/reference-to-video.md. Všechny modely a návody: https://doitong.com/developers/llms.txt