Gå til innhold

Mirage Avatar X

Integrer

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 eksempelet: 3,00 $ 3 000 API-kreditter filene dine måles før kjøring Kjør den på denne siden

Hent API-nøkkel
Mirage Leppe­synkronisering og avatarer ReferanseinndataLeppe­synkronisering #avatar#lipsync#talking-head

Avatar X-video med snakkende hode, drevet av lyden din og en bilde-, video- eller lageravatarreferanse

Mirage · Video

Det første resultatet ditt kommer her

Bygg en forespørsel nedenfor og kjør den med API-nøkkelen din. Utdata kopieres til lagringen vår, lagret for alltid eller 7 dager gratis.

Bygg en forespørsel

Kontrollene genereres fra modellskjemaet. Koden og prisen oppdateres når du endrer dem.

•obligatorisk audio_url
Slipp en fil, eller

Offentlig HTTPS-adresse for lyden som driver den genererte videoen, tilgjengelig uten autorisasjonsheadere eller informasjonskapsler. Godkjente lydformater er FLAC, Opus eller Vorbis, AAC eller ALAC, PCM WAV eller AIFF, og MP3. Filen må inneholde én mono- eller stereostrøm, vare i 3–180 sekunder, ikke være større enn 64 MiB og ha en samplingsfrekvens på 8–48 kHz.

Avansert video_reference_url · avatar · image_reference_url

Offentlig tilgjengelig HTTPS-URL til referansevideoen, uten autorisasjonsheadere eller informasjonskapsler, for en fil som inneholder nøyaktig én videostrøm og minst ett egnet segment på 1 sekund som referanse; lyd ignoreres. Godkjente filer kombinerer .mp4, .mov eller .m4v med H.264, H.265/HEVC eller ProRes, eller .webm med VP8 eller VP9. Varigheten må være 1 til 120 sekunder, størrelsen kan ikke overstige 1 GiB, og visningsformatet må være innenfor 5 % av enten 9:16 eller 16:9. Hvis image_reference_url også oppgis, prioriteres videoen.

Valg av visuelt arkivinnhold som bare brukes når ingen bilde- eller videoreferanse er oppgitt; None og standardverdien lar det stå urørt. Lyd leveres aldri av dette visuelle innholdet og kommer alltid fra audio_url. For å velge visuelt innhold kan du forhåndsvise alternativene i [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) og kopiere den nøyaktige Avatar-verdien.

HTTPS-URL til referansebilde, offentlig tilgjengelig uten informasjonskapsler eller autorisasjonsheadere; hvis video_reference_url oppgis, ignoreres bildet. Godtar ett statisk bilde i .jpg-, .jpeg-, .png- eller .webp-format, begrenset til 25 MiB og 25 megapiksler. Den korteste kanten må være minst 512 px, ingen kant kan overstige 8192 px, og formatet må være innenfor 5 % av 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"

Kjør denne forespørselen

Nøkkelen din blir i denne nettleseren: Den sendes bare til Doitong API og lagres bare i localStorage hvis du krysser av for Husk. Hent en API-nøkkel

Om Mirage Avatar X

Lager en leppesynkronisert avatarvideo fra `audio_url` (3 til 180 sekunder). Det visuelle kommer fra `video_reference_url`, `image_reference_url` eller en lager-`avatar`; videoreferansen prioriteres fremfor bildet når begge er angitt. Avataralternativet leverer bare visuelt innhold, ikke lyd. Referanse-URL-er må kunne hentes offentlig via HTTPS.

Parametere

Send enten det kanoniske navnet eller det opprinnelige navnet, ikke begge. Kanoniske navn

NavnType StandardTillatt Beskrivelse
audio_urlobligatorisk audio
Typeurl · audio
Offentlig HTTPS-adresse for lyden som driver den genererte videoen, tilgjengelig uten autorisasjonsheadere eller informasjonskapsler. Godkjente lydformater er FLAC, Opus eller Vorbis, AAC eller ALAC, PCM WAV eller AIFF, og MP3. Filen må inneholde én mono- eller stereostrøm, vare i 3–180 sekunder, ikke være større enn 64 MiB og ha en samplingsfrekvens på 8–48 kHz.
video_reference_urlvalgfritt
Typestring | null
Offentlig tilgjengelig HTTPS-URL til referansevideoen, uten autorisasjonsheadere eller informasjonskapsler, for en fil som inneholder nøyaktig én videostrøm og minst ett egnet segment på 1 sekund som referanse; lyd ignoreres. Godkjente filer kombinerer .mp4, .mov eller .m4v med H.264, H.265/HEVC eller ProRes, eller .webm med VP8 eller VP9. Varigheten må være 1 til 120 sekunder, størrelsen kan ikke overstige 1 GiB, og visningsformatet må være innenfor 5 % av enten 9:16 eller 16:9. Hvis image_reference_url også oppgis, prioriteres videoen.
avatarvalgfritt
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 av visuelt arkivinnhold som bare brukes når ingen bilde- eller videoreferanse er oppgitt; None og standardverdien lar det stå urørt. Lyd leveres aldri av dette visuelle innholdet og kommer alltid fra audio_url. For å velge visuelt innhold kan du forhåndsvise alternativene i [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) og kopiere den nøyaktige Avatar-verdien.
image_reference_urlvalgfritt
Typestring | null
HTTPS-URL til referansebilde, offentlig tilgjengelig uten informasjonskapsler eller autorisasjonsheadere; hvis video_reference_url oppgis, ignoreres bildet. Godtar ett statisk bilde i .jpg-, .jpeg-, .png- eller .webp-format, begrenset til 25 MiB og 25 megapiksler. Den korteste kanten må være minst 512 px, ingen kant kan overstige 8192 px, og formatet må være innenfor 5 % av 9:16 eller 16:9.
obligatorisk Kanonisk navn, også godkjent

Filparametere tar imot en offentlig https:// URL, en data: URI på opptil 10 MB eller file_url fra en opplasting. Filer

Utdata

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"
  }
}
Filene dine, ditt valgHver outputs[].url er en kopi på lagringen vår: lagret for alltid (betalt per GB-måned) eller 7 dager gratis, styrt av kontoinnstillingen din eller ?storage=.
Samme struktur for hver modelltype, url, content_type, width, height og duration, for bilder, video og lyd. output er modellens eget resultatobjekt.
Utdatafelt
video
object {url, content_type, file_name, file_size}

Flere modeller: Leppe­synkronisering og avatarer

For AI-agenter: Denne siden som Markdown finnes på https://doitong.com/no/developers/models/mirage-api/avatar-x/reference-to-video.md. Alle modeller og veiledninger: https://doitong.com/developers/llms.txt