Zum Inhalt springen

Mirage Avatar X

Integrieren

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"

Dateien wie das Beispiel: 3,00 $ 3.000 API-Credits Deine Dateien werden vor der Ausführung gemessen Auf dieser Seite ausführen

API-Schlüssel abrufen
Mirage Lipsync & Avatare ReferenzeingabenLipsync #avatar#talking-head

Avatar-X-Sprechkopfvideo, gesteuert durch Ihr Audio und ein Bild, Video oder eine Referenz für einen Stock-Avatar

Mirage · Video

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich audio_url
Datei ablegen oder

Öffentliche HTTPS-Adresse des Audios, das das generierte Video steuert, ohne Autorisierungsheader oder Cookies zugänglich. Akzeptierte Audioformate sind FLAC, Opus oder Vorbis, AAC oder ALAC, PCM WAV oder AIFF sowie MP3. Die Datei muss genau einen Mono- oder Stereostream enthalten, 3–180 Sekunden lang sein, höchstens 64 MiB belegen und eine Abtastrate von 8–48 kHz haben.

Erweitert video_reference_url · avatar · image_reference_url

Öffentlich zugängliche HTTPS-URL eines Referenzvideos ohne Autorisierungsheader oder Cookies. Die Datei muss genau einen Videostream und mindestens ein geeignetes 1-Sekunden-Segment als Referenz enthalten; Audio wird ignoriert. Akzeptiert werden .mp4, .mov oder .m4v mit H.264, H.265/HEVC oder ProRes sowie .webm mit VP8 oder VP9. Die Dauer muss 1 bis 120 Sekunden betragen, die Größe darf 1 GiB nicht überschreiten und das Seitenverhältnis muss innerhalb von 5% von 9:16 oder 16:9 liegen. Wenn image_reference_url ebenfalls angegeben wird, hat das Video Vorrang.

Auswahl eines Stock-Visuals, die nur verwendet wird, wenn keine Bild- oder Videoreferenz angegeben ist; None und der Standardwert lassen es deaktiviert. Dieses Visual liefert niemals Audio; es stammt immer von audio_url. Zur Auswahl eines Visuals die Optionen im [Avatar-Katalog](https://captions.ai/help/docs/api/actor-catalog) anzeigen und den exakten Avatar-Wert kopieren.

Öffentlich zugängliche HTTPS-URL eines Referenzbilds ohne Cookies oder Autorisierungsheader; bei Angabe von video_reference_url wird sie ignoriert. Akzeptiert wird ein einzelnes statisches Bild im Format .jpg, .jpeg, .png oder .webp mit maximal 25 MiB und 25 Megapixeln. Die kürzere Seite muss mindestens 512 px messen, keine Seite darf 8192 px überschreiten und das Seitenverhältnis muss innerhalb von 5% von 9:16 oder 16:9 liegen.

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

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Mirage Avatar X

Erstellt aus `audio_url` (3 bis 180 Sekunden) ein lippensynchrones Avatarvideo. Das Bildmaterial stammt aus `video_reference_url`, `image_reference_url` oder einem Stock-`avatar`; wenn beide angegeben sind, hat die Videoreferenz Vorrang vor dem Bild. Die Avataroption liefert nur Bildmaterial, kein Audio. Referenz-URLs müssen öffentlich über HTTPS abrufbar sein.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
audio_urlerforderlich audio
Typurl · audio
Öffentliche HTTPS-Adresse des Audios, das das generierte Video steuert, ohne Autorisierungsheader oder Cookies zugänglich. Akzeptierte Audioformate sind FLAC, Opus oder Vorbis, AAC oder ALAC, PCM WAV oder AIFF sowie MP3. Die Datei muss genau einen Mono- oder Stereostream enthalten, 3–180 Sekunden lang sein, höchstens 64 MiB belegen und eine Abtastrate von 8–48 kHz haben.
video_reference_urloptional
Typstring | null
Öffentlich zugängliche HTTPS-URL eines Referenzvideos ohne Autorisierungsheader oder Cookies. Die Datei muss genau einen Videostream und mindestens ein geeignetes 1-Sekunden-Segment als Referenz enthalten; Audio wird ignoriert. Akzeptiert werden .mp4, .mov oder .m4v mit H.264, H.265/HEVC oder ProRes sowie .webm mit VP8 oder VP9. Die Dauer muss 1 bis 120 Sekunden betragen, die Größe darf 1 GiB nicht überschreiten und das Seitenverhältnis muss innerhalb von 5% von 9:16 oder 16:9 liegen. Wenn image_reference_url ebenfalls angegeben wird, hat das Video Vorrang.
avataroptional
Typenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 weitereNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Auswahl eines Stock-Visuals, die nur verwendet wird, wenn keine Bild- oder Videoreferenz angegeben ist; None und der Standardwert lassen es deaktiviert. Dieses Visual liefert niemals Audio; es stammt immer von audio_url. Zur Auswahl eines Visuals die Optionen im [Avatar-Katalog](https://captions.ai/help/docs/api/actor-catalog) anzeigen und den exakten Avatar-Wert kopieren.
image_reference_urloptional
Typstring | null
Öffentlich zugängliche HTTPS-URL eines Referenzbilds ohne Cookies oder Autorisierungsheader; bei Angabe von video_reference_url wird sie ignoriert. Akzeptiert wird ein einzelnes statisches Bild im Format .jpg, .jpeg, .png oder .webp mit maximal 25 MiB und 25 Megapixeln. Die kürzere Seite muss mindestens 512 px messen, keine Seite darf 8192 px überschreiten und das Seitenverhältnis muss innerhalb von 5% von 9:16 oder 16:9 liegen.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
video
object {url, content_type, file_name, file_size}

Weitere Modelle: Lipsync & Avatare

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/mirage-api/avatar-x/reference-to-video.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt