Hoppa till innehåll

Mirage Avatar X

Integrera

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

Filer som exemplet: 3,00 $ 3 000 API-krediter dina filer mäts innan körningen Kör den på den här sidan

Hämta API-nyckel
Mirage Läppsynkning och avatarer ReferensinmatningarLäppsynkning #avatar#lipsync#talking-head

Avatar X-video med talande ansikte, driven av ditt ljud och en bild-, video- eller lageravatarreferens

Mirage · Video

Ditt första resultat visas här

Skapa en begäran nedan och kör den med din API-nyckel. Utdata kopieras till vår lagring och sparas för alltid eller 7 dagar kostnadsfritt.

Skapa en begäran

Kontrollerna genereras från modellschemat. Koden och priset uppdateras när du ändrar dem.

•obligatoriskt audio_url
Släpp en fil eller

Offentlig HTTPS-adress till ljudet som styr den genererade videon, tillgänglig utan auktoriseringsheaders eller cookies. Godkända ljudformat är FLAC, Opus eller Vorbis, AAC eller ALAC, PCM WAV eller AIFF samt MP3. Filen måste innehålla exakt en mono- eller stereoström, vara 3–180 sekunder lång, vara högst 64 MiB och ha en samplingsfrekvens på 8–48 kHz.

Avancerat video_reference_url · avatar · image_reference_url

HTTPS-URL till referensvideo, offentligt tillgänglig utan auktoriseringsheaders eller cookies, för en fil som innehåller exakt en videoström och minst ett lämpligt segment på 1 sekund som referens; ljud ignoreras. Godkända filer kombinerar .mp4, .mov eller .m4v med H.264, H.265/HEVC eller ProRes, eller .webm med VP8 eller VP9; längden måste vara 1 till 120 sekunder, storleken får inte överstiga 1 GiB och bildformatet måste ligga inom 5 % från antingen 9:16 eller 16:9. Om image_reference_url också anges prioriteras videon.

Val av lagrat visuellt innehåll som används endast när ingen bild- eller videoreferens anges; None och standardvärdet lämnar det ej inställt. Ljud tillhandahålls aldrig av detta visuella innehåll och kommer alltid från audio_url. För att välja visuellt innehåll, förhandsvisa alternativen i [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) och kopiera dess exakta Avatar-värde.

HTTPS-URL till referensbild, offentligt tillgänglig utan cookies eller auktoriseringsheaders; om video_reference_url anges ignoreras denna. Accepterar en enda statisk bild i formatet .jpg, .jpeg, .png eller .webp, begränsad till 25 MiB och 25 megapixel. Den kortare kanten måste vara minst 512 px och ingen kant får överstiga 8192 px; bildformatet måste ligga inom 5 % från 9:16 eller 16:9.

POST /run/mirage-api/avatar-x/reference-to-video?wait=20 pris → 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 den här begäran

Din nyckel stannar i den här webbläsaren: den skickas endast till Doitong API och sparas endast i localStorage om du markerar Kom ihåg. Hämta en API-nyckel

Om Mirage Avatar X

Skapar en läppsynkroniserad avatarvideo från `audio_url` (3 till 180 sekunder). Bildmaterialet kommer från `video_reference_url`, `image_reference_url` eller en lager-`avatar`; videoreferensen prioriteras framför bilden när båda anges. Avataralternativet tillhandahåller endast bildmaterial, inte ljud. Referens-URL:er måste vara offentligt åtkomliga via HTTPS.

Parametrar

Skicka antingen det kanoniska namnet eller det inbyggda namnet, inte båda. Kanoniska namn

NamnTyp StandardTillåtna Beskrivning
audio_urlobligatoriskt audio
Typurl · audio
Offentlig HTTPS-adress till ljudet som styr den genererade videon, tillgänglig utan auktoriseringsheaders eller cookies. Godkända ljudformat är FLAC, Opus eller Vorbis, AAC eller ALAC, PCM WAV eller AIFF samt MP3. Filen måste innehålla exakt en mono- eller stereoström, vara 3–180 sekunder lång, vara högst 64 MiB och ha en samplingsfrekvens på 8–48 kHz.
video_reference_urlvalfritt
Typstring | null
HTTPS-URL till referensvideo, offentligt tillgänglig utan auktoriseringsheaders eller cookies, för en fil som innehåller exakt en videoström och minst ett lämpligt segment på 1 sekund som referens; ljud ignoreras. Godkända filer kombinerar .mp4, .mov eller .m4v med H.264, H.265/HEVC eller ProRes, eller .webm med VP8 eller VP9; längden måste vara 1 till 120 sekunder, storleken får inte överstiga 1 GiB och bildformatet måste ligga inom 5 % från antingen 9:16 eller 16:9. Om image_reference_url också anges prioriteras videon.
avatarvalfritt
Typenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 tillNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Val av lagrat visuellt innehåll som används endast när ingen bild- eller videoreferens anges; None och standardvärdet lämnar det ej inställt. Ljud tillhandahålls aldrig av detta visuella innehåll och kommer alltid från audio_url. För att välja visuellt innehåll, förhandsvisa alternativen i [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) och kopiera dess exakta Avatar-värde.
image_reference_urlvalfritt
Typstring | null
HTTPS-URL till referensbild, offentligt tillgänglig utan cookies eller auktoriseringsheaders; om video_reference_url anges ignoreras denna. Accepterar en enda statisk bild i formatet .jpg, .jpeg, .png eller .webp, begränsad till 25 MiB och 25 megapixel. Den kortare kanten måste vara minst 512 px och ingen kant får överstiga 8192 px; bildformatet måste ligga inom 5 % från 9:16 eller 16:9.
obligatoriskt Kanoniskt namn, accepteras också

Filparametrar tar emot en offentlig https://-URL, en data:-URI på upp till 10 MB eller file_url från en uppladdning. Filer

Resultat

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"
  }
}
Dina filer, ditt valVarje outputs[].url är en kopia i vår lagring: sparad för alltid (debiteras per GB-månad) eller 7 dagar kostnadsfritt, enligt din kontoinställning eller ?storage=.
Samma struktur för varje modelltype, url, content_type, width, height och duration, för bilder, video och ljud. output är modellens eget resultatobjekt.
Resultatets fält
video
object {url, content_type, file_name, file_size}

Fler modeller: Läppsynkning och avatarer

För AI-agenter: den här sidan som Markdown finns på https://doitong.com/sv/developers/models/mirage-api/avatar-x/reference-to-video.md. Alla modeller och guider: https://doitong.com/developers/llms.txt