Gå til indhold

Mirage Avatar X

Integrer

Model-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 eksemplet: 3,00 $ 3.000 API-kreditter dine filer måles før kørslen Kør den på denne side

Hent API-nøgle
Mirage Lipsync og avatarer ReferenceinputsLipsync #avatar#talking-head

Avatar X-video med talende hoved, drevet af din lyd og en reference til et billede, en video eller en standardavatar

Mirage · Video

Dit første resultat kommer her

Opret en anmodning nedenfor, og kør den med din API-nøgle. Output kopieres til vores lagring, gemt for altid eller 7 dage gratis.

Opret en anmodning

Kontrollerne genereres fra modellens skema. Koden og prisen opdateres, når du ændrer dem.

•påkrævet audio_url
Slip en fil, eller

Offentlig HTTPS-adresse til den lyd, der driver den genererede video, tilgængelig uden autorisationsheadere eller cookies. Accepterede lydformater er FLAC, Opus eller Vorbis, AAC eller ALAC, PCM WAV eller AIFF samt MP3. Filen skal indeholde én mono- eller stereostream, vare 3–180 sekunder, fylde højst 64 MiB og have en samplingsfrekvens på 8–48 kHz.

Avanceret video_reference_url · avatar · image_reference_url

Offentlig reference-video-HTTPS-URL uden autorisationsheadere eller cookies til en fil med præcis én videostream og mindst ét egnet 1-sekundssegment til reference; lyd ignoreres. Accepterede filer kombinerer .mp4, .mov eller .m4v med H.264, H.265/HEVC eller ProRes, eller .webm med VP8 eller VP9; varigheden skal være 1 til 120 sekunder, størrelsen højst 1 GiB, og billedformatet skal ligge inden for 5 % af enten 9:16 eller 16:9. Hvis image_reference_url også angives, prioriteres videoen.

Valg af stockvisualisering, der kun bruges, når der ikke leveres en billede- eller videoreference; None og standard lader den være uindstillet. Lyd leveres aldrig af denne visualisering og kommer altid fra audio_url. For at vælge en visualisering skal du se mulighederne i [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) og kopiere den nøjagtige Avatar-værdi.

HTTPS-URL til referencebillede, offentligt tilgængelig uden cookies eller autorisationsheadere; hvis video_reference_url angives, ignoreres den. Accepterer ét statisk billede i .jpg-, .jpeg-, .png- eller .webp-format, højst 25 MiB og 25 megapixel. Den korte kant skal være mindst 512 px, ingen kant må overstige 8192 px, og billedformatet skal ligge inden for 5 % af 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 denne anmodning

Din nøgle forbliver i denne browser: Den sendes kun til Doitong API og gemmes kun i localStorage, hvis du markerer Husk. Hent en API-nøgle

Om Mirage Avatar X

Opretter en læbesynkroniseret avatarvideo fra `audio_url` (3 til 180 sekunder). Det visuelle kommer fra `video_reference_url`, `image_reference_url` eller en standard-`avatar`; videoreferencen har forrang frem for billedet, når begge angives. Avatarindstillingen leverer kun det visuelle, ikke lyd. Reference-URL'er skal kunne hentes offentligt via HTTPS.

Parametre

Send enten det kanoniske navn eller det oprindelige navn, ikke begge. Kanoniske navne

NavnType StandardTilladt Beskrivelse
audio_urlpåkrævet audio
Typeurl · audio
Offentlig HTTPS-adresse til den lyd, der driver den genererede video, tilgængelig uden autorisationsheadere eller cookies. Accepterede lydformater er FLAC, Opus eller Vorbis, AAC eller ALAC, PCM WAV eller AIFF samt MP3. Filen skal indeholde én mono- eller stereostream, vare 3–180 sekunder, fylde højst 64 MiB og have en samplingsfrekvens på 8–48 kHz.
video_reference_urlvalgfri
Typestring | null
Offentlig reference-video-HTTPS-URL uden autorisationsheadere eller cookies til en fil med præcis én videostream og mindst ét egnet 1-sekundssegment til reference; lyd ignoreres. Accepterede filer kombinerer .mp4, .mov eller .m4v med H.264, H.265/HEVC eller ProRes, eller .webm med VP8 eller VP9; varigheden skal være 1 til 120 sekunder, størrelsen højst 1 GiB, og billedformatet skal ligge inden for 5 % af enten 9:16 eller 16:9. Hvis image_reference_url også angives, prioriteres videoen.
avatarvalgfri
Typeenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 flereNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Valg af stockvisualisering, der kun bruges, når der ikke leveres en billede- eller videoreference; None og standard lader den være uindstillet. Lyd leveres aldrig af denne visualisering og kommer altid fra audio_url. For at vælge en visualisering skal du se mulighederne i [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) og kopiere den nøjagtige Avatar-værdi.
image_reference_urlvalgfri
Typestring | null
HTTPS-URL til referencebillede, offentligt tilgængelig uden cookies eller autorisationsheadere; hvis video_reference_url angives, ignoreres den. Accepterer ét statisk billede i .jpg-, .jpeg-, .png- eller .webp-format, højst 25 MiB og 25 megapixel. Den korte kant skal være mindst 512 px, ingen kant må overstige 8192 px, og billedformatet skal ligge inden for 5 % af 9:16 eller 16:9.
påkrævet Kanonisk navn, også accepteret

Filparametre accepterer en offentlig https://-URL, en data:-URI på op til 10 MB eller file_url fra en upload. Filer

Output

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"
  }
}
Dine filer, dit valgHver outputs[].url er en kopi på vores lagring: gemt for altid (betales pr. GB-måned) eller 7 dage gratis, afhængigt af din kontoindstilling eller ?storage=.
Samme struktur for alle modellertype, url, content_type, width, height og duration for billeder, video og lyd. output er modellens eget resultatobjekt.
Outputfelter
video
object {url, content_type, file_name, file_size}

Flere modeller: Lipsync og avatarer

Til AI-agenter: Denne side som Markdown findes på https://doitong.com/da/developers/models/mirage-api/avatar-x/reference-to-video.md. Alle modeller og vejledninger: https://doitong.com/developers/llms.txt