Naar inhoud springen

Mirage Avatar X

Integreren

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"

Bestanden zoals het voorbeeld: $ 3,00 3.000 API-tegoed je bestanden worden vóór de uitvoering gemeten Op deze pagina uitvoeren

API-sleutel ophalen
Mirage Lipsync en avatars Referentie-inputsLipsync #avatar#talking-head

Avatar X-video met pratend hoofd, aangestuurd door je audio en een afbeelding-, video- of stockavatarreferentie

Mirage · Video

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht audio_url
Sleep een bestand hierheen of

Openbaar HTTPS-adres voor de audio die de gegenereerde video aanstuurt, toegankelijk zonder autorisatieheaders of cookies. Geaccepteerde audioformaten zijn FLAC, Opus of Vorbis, AAC of ALAC, PCM WAV of AIFF en MP3. Het bestand moet één mono- of stereostream bevatten, 3–180 seconden duren, maximaal 64 MiB groot zijn en een samplefrequentie van 8–48 kHz hebben.

Geavanceerd video_reference_url · avatar · image_reference_url

Openbare HTTPS-URL van de referentievideo, zonder autorisatieheaders of cookies, naar een bestand met precies één videostream en ten minste één geschikte segment van 1 seconde als referentie; audio wordt genegeerd. Geaccepteerd zijn .mp4, .mov of .m4v met H.264, H.265/HEVC of ProRes, of .webm met VP8 of VP9; de duur moet 1 tot 120 seconden zijn, de grootte maximaal 1 GiB en de beeldverhouding binnen 5% van 9:16 of 16:9 vallen. Als image_reference_url ook is opgegeven, heeft de video voorrang.

Selectie van stockbeelden, alleen gebruikt wanneer geen afbeelding- of videoreferentie wordt opgegeven; None en de standaardwaarde laten dit niet ingesteld. Deze visual levert nooit audio; die komt altijd van audio_url. Bekijk de opties in de [avatarcatalogus](https://captions.ai/help/docs/api/actor-catalog) en kopieer de exacte Avatar-waarde om een visual te kiezen.

HTTPS-URL van een referentieafbeelding, openbaar toegankelijk zonder cookies of autorisatieheaders; door video_reference_url op te geven wordt deze genegeerd. Accepteert één statische afbeelding in .jpg-, .jpeg-, .png- of .webp-formaat, maximaal 25 MiB en 25 megapixel. De kortste zijde moet minstens 512 px zijn en geen zijde mag groter zijn dan 8192 px; de beeldverhouding moet binnen 5% van 9:16 of 16:9 vallen.

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

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Mirage Avatar X

Maakt een lipsynchroon avatarvideo vanuit `audio_url` (3 tot 180 seconden). De beelden komen uit `video_reference_url`, `image_reference_url` of een stock-`avatar`; de videoreferentie heeft voorrang op de afbeelding wanneer beide zijn opgegeven. De avataroptie levert alleen beelden, geen audio. Referentie-URL's moeten publiek toegankelijk zijn via HTTPS.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
audio_urlverplicht audio
Typeurl · audio
Openbaar HTTPS-adres voor de audio die de gegenereerde video aanstuurt, toegankelijk zonder autorisatieheaders of cookies. Geaccepteerde audioformaten zijn FLAC, Opus of Vorbis, AAC of ALAC, PCM WAV of AIFF en MP3. Het bestand moet één mono- of stereostream bevatten, 3–180 seconden duren, maximaal 64 MiB groot zijn en een samplefrequentie van 8–48 kHz hebben.
video_reference_urloptioneel
Typestring | null
Openbare HTTPS-URL van de referentievideo, zonder autorisatieheaders of cookies, naar een bestand met precies één videostream en ten minste één geschikte segment van 1 seconde als referentie; audio wordt genegeerd. Geaccepteerd zijn .mp4, .mov of .m4v met H.264, H.265/HEVC of ProRes, of .webm met VP8 of VP9; de duur moet 1 tot 120 seconden zijn, de grootte maximaal 1 GiB en de beeldverhouding binnen 5% van 9:16 of 16:9 vallen. Als image_reference_url ook is opgegeven, heeft de video voorrang.
avataroptioneel
Typeenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 meerNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Selectie van stockbeelden, alleen gebruikt wanneer geen afbeelding- of videoreferentie wordt opgegeven; None en de standaardwaarde laten dit niet ingesteld. Deze visual levert nooit audio; die komt altijd van audio_url. Bekijk de opties in de [avatarcatalogus](https://captions.ai/help/docs/api/actor-catalog) en kopieer de exacte Avatar-waarde om een visual te kiezen.
image_reference_urloptioneel
Typestring | null
HTTPS-URL van een referentieafbeelding, openbaar toegankelijk zonder cookies of autorisatieheaders; door video_reference_url op te geven wordt deze genegeerd. Accepteert één statische afbeelding in .jpg-, .jpeg-, .png- of .webp-formaat, maximaal 25 MiB en 25 megapixel. De kortste zijde moet minstens 512 px zijn en geen zijde mag groter zijn dan 8192 px; de beeldverhouding moet binnen 5% van 9:16 of 16:9 vallen.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
video
object {url, content_type, file_name, file_size}

Meer modellen: Lipsync en avatars

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/mirage-api/avatar-x/reference-to-video.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt