Lompat ke konten

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"

File seperti contoh: $3,00 3.000 kredit API file Anda diukur sebelum dijalankan Jalankan di halaman ini

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

Video avatar talking-head Avatar X yang digerakkan oleh audio dan referensi gambar, video, atau avatar stok

Mirage · Video

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib audio_url
Jatuhkan file, atau

Alamat HTTPS publik untuk audio yang menggerakkan video yang dibuat, dapat diakses tanpa header otorisasi atau cookie. Format audio yang diterima adalah FLAC, Opus atau Vorbis, AAC atau ALAC, PCM WAV atau AIFF, dan MP3. File harus berisi satu stream mono atau stereo, berdurasi 3–180 detik, berukuran tidak lebih dari 64 MiB, dan memiliki laju sampel 8–48 kHz.

Lanjutan video_reference_url · avatar · image_reference_url

URL HTTPS video referensi yang dapat diakses publik tanpa header otorisasi atau cookie, untuk file yang berisi tepat satu stream video dan setidaknya satu segmen 1 detik yang sesuai sebagai referensi; audio diabaikan. File yang diterima adalah .mp4, .mov, atau .m4v dengan H.264, H.265/HEVC, atau ProRes, atau .webm dengan VP8 atau VP9; durasi harus 1 hingga 120 detik, ukuran tidak boleh melebihi 1 GiB, dan rasio aspek tampilan harus berada dalam rentang 5% dari 9:16 atau 16:9. Jika image_reference_url juga diberikan, video diprioritaskan.

Pilihan visual stok yang hanya digunakan saat tidak ada referensi gambar atau video; None dan bawaan sama-sama membiarkannya tidak disetel. Audio tidak pernah disediakan oleh visual ini dan selalu berasal dari audio_url. Untuk memilih visual, pratinjau opsi di [katalog avatar](https://captions.ai/help/docs/api/actor-catalog) dan salin nilai Avatar yang tepat.

URL HTTPS gambar referensi, dapat diakses publik tanpa cookie atau header otorisasi; pemberian video_reference_url menyebabkan URL ini diabaikan. Menerima satu gambar statis dalam format .jpg, .jpeg, .png, atau .webp, dengan batas 25 MiB dan 25 megapiksel. Sisi yang lebih pendek harus berukuran setidaknya 512 px dan tidak ada sisi yang boleh melebihi 8192 px; rasio aspek harus berada dalam rentang 5% dari 9:16 atau 16:9.

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

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Mirage Avatar X

Membuat video avatar dengan sinkronisasi bibir dari `audio_url` (3 hingga 180 detik). Visual berasal dari `video_reference_url`, `image_reference_url`, atau `avatar` stok; referensi video diprioritaskan daripada gambar jika keduanya diberikan. Opsi avatar hanya menyediakan visual, bukan audio. URL referensi harus dapat diakses publik melalui HTTPS.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
audio_urlwajib audio
Tipeurl · audio
Alamat HTTPS publik untuk audio yang menggerakkan video yang dibuat, dapat diakses tanpa header otorisasi atau cookie. Format audio yang diterima adalah FLAC, Opus atau Vorbis, AAC atau ALAC, PCM WAV atau AIFF, dan MP3. File harus berisi satu stream mono atau stereo, berdurasi 3–180 detik, berukuran tidak lebih dari 64 MiB, dan memiliki laju sampel 8–48 kHz.
video_reference_urlopsional
Tipestring | null
URL HTTPS video referensi yang dapat diakses publik tanpa header otorisasi atau cookie, untuk file yang berisi tepat satu stream video dan setidaknya satu segmen 1 detik yang sesuai sebagai referensi; audio diabaikan. File yang diterima adalah .mp4, .mov, atau .m4v dengan H.264, H.265/HEVC, atau ProRes, atau .webm dengan VP8 atau VP9; durasi harus 1 hingga 120 detik, ukuran tidak boleh melebihi 1 GiB, dan rasio aspek tampilan harus berada dalam rentang 5% dari 9:16 atau 16:9. Jika image_reference_url juga diberikan, video diprioritaskan.
avataropsional
Tipeenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 lainnyaNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Pilihan visual stok yang hanya digunakan saat tidak ada referensi gambar atau video; None dan bawaan sama-sama membiarkannya tidak disetel. Audio tidak pernah disediakan oleh visual ini dan selalu berasal dari audio_url. Untuk memilih visual, pratinjau opsi di [katalog avatar](https://captions.ai/help/docs/api/actor-catalog) dan salin nilai Avatar yang tepat.
image_reference_urlopsional
Tipestring | null
URL HTTPS gambar referensi, dapat diakses publik tanpa cookie atau header otorisasi; pemberian video_reference_url menyebabkan URL ini diabaikan. Menerima satu gambar statis dalam format .jpg, .jpeg, .png, atau .webp, dengan batas 25 MiB dan 25 megapiksel. Sisi yang lebih pendek harus berukuran setidaknya 512 px dan tidak ada sisi yang boleh melebihi 8192 px; rasio aspek harus berada dalam rentang 5% dari 9:16 atau 16:9.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
video
object {url, content_type, file_name, file_size}

Model lainnya: Lip sync & Avatar

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