Ugrás a tartalomhoz

Mirage Avatar X

Integráció

Modellazonosító 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"

A példához hasonló fájlok: 3,00 $ 3000 API-jóváírás a fájljaidat a futtatás előtt megmérjük Futtatás ezen az oldalon

API-kulcs beszerzése
Mirage Lipsync és avatarok Referencia-bemenetekLipsync #avatar#talking-head

avatár X beszélőfejes videó, amelyet az Ön hangja és egy kép-, videó- vagy készavatár-referencia vezérel

Mirage · Videó

Az első eredményed itt jelenik meg

Állíts össze egy kérést alább, majd futtasd az API-kulcsoddal. A kimeneteket a tárhelyünkre másoljuk, és örökre vagy 7 nap ideig ingyenesen őrizzük meg.

Kérés összeállítása

A vezérlők a modell sémájából jönnek létre. A kód és az ár a módosításokkal együtt frissül.

•kötelező audio_url
Húzz egy fájlt ide, vagy

A generált videó hangját biztosító nyilvános HTTPS-cím, amely engedélyezési fejlécek és cookie-k nélkül is elérhető. Az elfogadott hangformátumok: FLAC, Opus vagy Vorbis, AAC vagy ALAC, PCM WAV vagy AIFF, illetve MP3. A fájlnak egyetlen mono- vagy sztereófolyamot kell tartalmaznia, 3–180 másodperc hosszúnak, legfeljebb 64 MiB méretűnek és 8–48 kHz mintavételi frekvenciájúnak kell lennie.

Speciális video_reference_url · avatar · image_reference_url

Nyilvánosan, engedélyezési fejlécek és cookie-k nélkül elérhető referenciavideó-HTTPS-URL, amely pontosan egy videófolyamot és legalább egy megfelelő, 1 másodperces referenciaként használható szegmenst tartalmaz; a hang figyelmen kívül marad. Az elfogadott fájlkombinációk: .mp4, .mov vagy .m4v H.264, H.265/HEVC vagy ProRes kodekkel, illetve .webm VP8 vagy VP9 kodekkel; az időtartamnak 1–120 másodperc, a méretnek legfeljebb 1 GiB értékűnek, a képaránynak pedig 9:16 vagy 16:9 érték 5%-án belülinek kell lennie. Ha az image_reference_url is meg van adva, a videó élvez elsőbbséget.

Csak akkor használt készletvizuál, ha nincs megadva kép- vagy videóreferencia; a None és az alapértelmezett érték egyaránt üresen hagyja. Ehhez a vizuálhoz soha nem tartozik hang, az mindig az audio_url értékéből származik. Vizuál választásához tekintse meg a lehetőségeket az [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) oldalon, majd másolja ki a pontos Avatar értéket.

Referenciakép HTTPS-URL-je, amely cookie-k és engedélyezési fejlécek nélkül nyilvánosan elérhető; a video_reference_url megadása figyelmen kívül hagyja. Egyetlen statikus, .jpg, .jpeg, .png vagy .webp formátumú, legfeljebb 25 MiB méretű és 25 megapixeles képet fogad el. A rövidebb oldal legalább 512 px, egyik oldal pedig legfeljebb 8192 px lehet; a képaránynak a 9:16 vagy 16:9 érték 5%-án belül kell lennie.

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

Kérés futtatása

A kulcsod ebben a böngészőben marad: csak a Doitong API-nak küldjük el, és csak akkor mentjük a localStorage-ba, ha bejelölöd az Emlékezz rám lehetőséget. API-kulcs igénylése

A(z) Mirage Avatar X bemutatása

Az `audio_url` mezőben megadott, 3–180 másodperces hangból ajakszinkronizált avatárvideót készít. A vizuális tartalom a `video_reference_url`, az `image_reference_url` vagy egy stock `avatar` mezőből származik; ha mindkettő meg van adva, a videóreferencia elsőbbséget élvez a képpel szemben. Az avatárbeállítás csak a vizuális tartalmat adja meg, hangot nem. A referencia-URL-eknek nyilvánosan, HTTPS-en keresztül elérhetőnek kell lenniük.

Paraméterek

Küldd el a kanonikus nevet vagy a natív nevet, de ne mindkettőt. Kanonikus nevek

NévTípus AlapértelmezettEngedélyezett Leírás
audio_urlkötelező audio
Típusurl · audio
A generált videó hangját biztosító nyilvános HTTPS-cím, amely engedélyezési fejlécek és cookie-k nélkül is elérhető. Az elfogadott hangformátumok: FLAC, Opus vagy Vorbis, AAC vagy ALAC, PCM WAV vagy AIFF, illetve MP3. A fájlnak egyetlen mono- vagy sztereófolyamot kell tartalmaznia, 3–180 másodperc hosszúnak, legfeljebb 64 MiB méretűnek és 8–48 kHz mintavételi frekvenciájúnak kell lennie.
video_reference_urlnem kötelező
Típusstring | null
Nyilvánosan, engedélyezési fejlécek és cookie-k nélkül elérhető referenciavideó-HTTPS-URL, amely pontosan egy videófolyamot és legalább egy megfelelő, 1 másodperces referenciaként használható szegmenst tartalmaz; a hang figyelmen kívül marad. Az elfogadott fájlkombinációk: .mp4, .mov vagy .m4v H.264, H.265/HEVC vagy ProRes kodekkel, illetve .webm VP8 vagy VP9 kodekkel; az időtartamnak 1–120 másodperc, a méretnek legfeljebb 1 GiB értékűnek, a képaránynak pedig 9:16 vagy 16:9 érték 5%-án belülinek kell lennie. Ha az image_reference_url is meg van adva, a videó élvez elsőbbséget.
avatarnem kötelező
Típusenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 továbbiNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Csak akkor használt készletvizuál, ha nincs megadva kép- vagy videóreferencia; a None és az alapértelmezett érték egyaránt üresen hagyja. Ehhez a vizuálhoz soha nem tartozik hang, az mindig az audio_url értékéből származik. Vizuál választásához tekintse meg a lehetőségeket az [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) oldalon, majd másolja ki a pontos Avatar értéket.
image_reference_urlnem kötelező
Típusstring | null
Referenciakép HTTPS-URL-je, amely cookie-k és engedélyezési fejlécek nélkül nyilvánosan elérhető; a video_reference_url megadása figyelmen kívül hagyja. Egyetlen statikus, .jpg, .jpeg, .png vagy .webp formátumú, legfeljebb 25 MiB méretű és 25 megapixeles képet fogad el. A rövidebb oldal legalább 512 px, egyik oldal pedig legfeljebb 8192 px lehet; a képaránynak a 9:16 vagy 16:9 érték 5%-án belül kell lennie.
kötelező Kanonikus név, szintén elfogadva

A fájlparaméterek nyilvános https:// URL-t, legfeljebb 10 MB-os data: URI-t vagy egy feltöltés file_url értékét fogadják el. Fájlok

Kimenet

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"
  }
}
Az Ön fájljai, az Ön döntéseMinden outputs[].url a tárhelyünkön lévő másolat: örökre megőrizve (GB-hónaponként fizetve) vagy 7 nap ideig ingyenesen, a fiókbeállításod vagy a ?storage= alapján.
Azonos struktúra minden modellentype, url, content_type, width, height és duration képekhez, videókhoz és hanganyagokhoz egyaránt. Az output a modell saját eredményobjektuma.
A kimenet mezői
video
object {url, content_type, file_name, file_size}

További modellek: Lipsync és avatarok

AI-ügynököknek: ez az oldal Markdown formátumban itt található: https://doitong.com/hu/developers/models/mirage-api/avatar-x/reference-to-video.md. Minden modell és útmutató: https://doitong.com/developers/llms.txt