Langkau ke kandungan

Mirage Avatar X

Integrasikan

ID model 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"

Fail seperti contoh: $3.00 3,000 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Mirage Lip-sync & Avatar Input rujukanLip-sync #avatar#lipsync#talking-head

Video avatar bercakap Avatar X yang dipacu oleh audio dan imej, video atau rujukan avatar stok anda

Mirage · Video

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan audio_url
Lepaskan fail, atau

Alamat HTTPS awam untuk audio yang memacu video yang dijana, boleh diakses tanpa pengepala kebenaran atau kuki. Format audio yang diterima ialah FLAC, Opus atau Vorbis, AAC atau ALAC, PCM WAV atau AIFF, dan MP3. Fail mesti mengandungi satu aliran mono atau stereo, berdurasi 3–180 saat, berukuran tidak lebih daripada 64 MiB dan mempunyai kadar sampel 8–48 kHz.

Lanjutan video_reference_url · avatar · image_reference_url

URL HTTPS video rujukan, boleh diakses secara awam tanpa pengepala kebenaran atau kuki, untuk fail yang mengandungi tepat satu aliran video dan sekurang-kurangnya satu segmen 1 saat yang sesuai sebagai rujukan; audio diabaikan. Fail yang diterima ialah .mp4, .mov atau .m4v dengan H.264, H.265/HEVC atau ProRes, atau .webm dengan VP8 atau VP9; tempoh mesti 1 hingga 120 saat, saiz tidak boleh melebihi 1 GiB dan nisbah bidang paparan mesti berada dalam lingkungan 5% daripada 9:16 atau 16:9. Jika image_reference_url turut diberikan, video diberi keutamaan.

Pemilihan visual stok yang digunakan hanya apabila tiada rujukan imej atau video dibekalkan; None dan lalai kedua-duanya membiarkannya tidak ditetapkan. Audio tidak pernah dibekalkan oleh visual ini dan sentiasa datang daripada audio_url. Untuk memilih visual, pratonton pilihan dalam [katalog avatar](https://captions.ai/help/docs/api/actor-catalog) dan salin nilai Avatar yang tepat.

URL HTTPS imej rujukan, boleh diakses secara awam tanpa kuki atau pengepala kebenaran; membekalkan video_reference_url menyebabkan URL ini diabaikan. Menerima satu imej statik dalam format .jpg, .jpeg, .png atau .webp, terhad kepada 25 MiB dan 25 megapiksel. Sisi yang lebih pendek mesti berukuran sekurang-kurangnya 512 px dan tiada sisi boleh melebihi 8192 px; nisbah bidang mesti berada dalam lingkungan 5% daripada 9:16 atau 16:9.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Mirage Avatar X

Menghasilkan video avatar dengan penyegerakan bibir daripada `audio_url` (3 hingga 180 saat). Visual datang daripada `video_reference_url`, `image_reference_url` atau `avatar` stok; rujukan video mengatasi imej apabila kedua-duanya diberikan. Pilihan avatar hanya menyediakan visual, bukan audio. URL rujukan mesti boleh dicapai secara umum melalui HTTPS.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
audio_urldiperlukan audio
Jenisurl · audio
Alamat HTTPS awam untuk audio yang memacu video yang dijana, boleh diakses tanpa pengepala kebenaran atau kuki. Format audio yang diterima ialah FLAC, Opus atau Vorbis, AAC atau ALAC, PCM WAV atau AIFF, dan MP3. Fail mesti mengandungi satu aliran mono atau stereo, berdurasi 3–180 saat, berukuran tidak lebih daripada 64 MiB dan mempunyai kadar sampel 8–48 kHz.
video_reference_urlpilihan
Jenisstring | null
URL HTTPS video rujukan, boleh diakses secara awam tanpa pengepala kebenaran atau kuki, untuk fail yang mengandungi tepat satu aliran video dan sekurang-kurangnya satu segmen 1 saat yang sesuai sebagai rujukan; audio diabaikan. Fail yang diterima ialah .mp4, .mov atau .m4v dengan H.264, H.265/HEVC atau ProRes, atau .webm dengan VP8 atau VP9; tempoh mesti 1 hingga 120 saat, saiz tidak boleh melebihi 1 GiB dan nisbah bidang paparan mesti berada dalam lingkungan 5% daripada 9:16 atau 16:9. Jika image_reference_url turut diberikan, video diberi keutamaan.
avatarpilihan
Jenisenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 lagiNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Pemilihan visual stok yang digunakan hanya apabila tiada rujukan imej atau video dibekalkan; None dan lalai kedua-duanya membiarkannya tidak ditetapkan. Audio tidak pernah dibekalkan oleh visual ini dan sentiasa datang daripada audio_url. Untuk memilih visual, pratonton pilihan dalam [katalog avatar](https://captions.ai/help/docs/api/actor-catalog) dan salin nilai Avatar yang tepat.
image_reference_urlpilihan
Jenisstring | null
URL HTTPS imej rujukan, boleh diakses secara awam tanpa kuki atau pengepala kebenaran; membekalkan video_reference_url menyebabkan URL ini diabaikan. Menerima satu imej statik dalam format .jpg, .jpeg, .png atau .webp, terhad kepada 25 MiB dan 25 megapiksel. Sisi yang lebih pendek mesti berukuran sekurang-kurangnya 512 px dan tiada sisi boleh melebihi 8192 px; nisbah bidang mesti berada dalam lingkungan 5% daripada 9:16 atau 16:9.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
video
object {url, content_type, file_name, file_size}

Lebih banyak model: Lip-sync & Avatar

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/mirage-api/avatar-x/reference-to-video.md. Semua model dan panduan: https://doitong.com/developers/llms.txt