İçeriğe geç

Mirage Avatar X

Entegre et

Model kimliği 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"

Örnekteki gibi dosyalar: $3,00 3.000 API kredisi dosyalarınız çalıştırmadan önce ölçülür Bu sayfada çalıştır

API anahtarı al
Mirage Dudak Senkronizasyonu ve Avatarlar Referans girdileriDudak senkronizasyonu #avatar#lipsync#talking-head

Sesiniz ve görüntü, video veya stok avatar referansınızla yönlendirilen Avatar X konuşan kafa videosu

Mirage · Video

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli audio_url
Dosyayı bırakın veya

Üretilen videonun sesini sağlayan, yetkilendirme başlıkları veya çerezler olmadan erişilebilen herkese açık HTTPS adresi. Kabul edilen ses biçimleri FLAC, Opus veya Vorbis, AAC veya ALAC, PCM WAV veya AIFF ve MP3'tür. Dosya tek bir mono veya stereo akış içermeli, 3–180 saniye sürmeli, 64 MiB'den büyük olmamalı ve örnekleme hızı 8–48 kHz olmalıdır.

Gelişmiş video_reference_url · avatar · image_reference_url

Referans olarak kullanılacak, tam olarak bir video akışı ve en az bir uygun 1 saniyelik segment içeren, yetkilendirme başlıkları veya çerezler olmadan herkese açık erişilebilen referans video HTTPS URL'si; ses yok sayılır. Kabul edilen dosya kombinasyonları H.264, H.265/HEVC veya ProRes ile .mp4, .mov ya da .m4v veya VP8 ya da VP9 ile .webm'dir; süre 1 ile 120 saniye arasında, boyut en fazla 1 GiB olmalı ve görüntü en-boy oranı 9:16 veya 16:9 değerlerinden birinin %5'i içinde bulunmalıdır. image_reference_url de sağlanırsa video önceliklidir.

Yalnızca görsel veya video referansı sağlanmadığında kullanılan stok görsel seçimi; None ve varsayılan değer, seçimi boş bırakır. Bu görselden hiçbir zaman ses sağlanmaz; ses her zaman audio_url'den gelir. Görsel seçmek için seçenekleri [avatar kataloğunda](https://captions.ai/help/docs/api/actor-catalog) önizleyin ve tam Avatar değerini kopyalayın.

Çerezler veya yetkilendirme başlıkları olmadan herkese açık erişilebilen referans görsel HTTPS URL'si; video_reference_url sağlanırsa yok sayılır. .jpg, .jpeg, .png veya .webp biçiminde tek bir statik görsel kabul edilir; sınır 25 MiB ve 25 megapikseldir. Kısa kenar en az 512 px, hiçbir kenar 8192 px'den büyük olmamalı; en-boy oranı 9:16 veya 16:9 değerinin %5'i içinde olmalıdır.

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

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

Mirage Avatar X hakkında

`audio_url` (3 ila 180 saniye) ile dudak senkronlu avatar videosu oluşturur. Görsel, `video_reference_url`, `image_reference_url` veya stok `avatar` üzerinden alınır; ikisi birlikte verildiğinde video referansı görüntüye önceliklidir. Avatar seçeneği yalnızca görsel sağlar, ses sağlamaz. Referans URL'leri HTTPS üzerinden herkese açık şekilde alınabilmelidir.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
audio_urlgerekli audio
Türurl · audio
Üretilen videonun sesini sağlayan, yetkilendirme başlıkları veya çerezler olmadan erişilebilen herkese açık HTTPS adresi. Kabul edilen ses biçimleri FLAC, Opus veya Vorbis, AAC veya ALAC, PCM WAV veya AIFF ve MP3'tür. Dosya tek bir mono veya stereo akış içermeli, 3–180 saniye sürmeli, 64 MiB'den büyük olmamalı ve örnekleme hızı 8–48 kHz olmalıdır.
video_reference_urlisteğe bağlı
Türstring | null
Referans olarak kullanılacak, tam olarak bir video akışı ve en az bir uygun 1 saniyelik segment içeren, yetkilendirme başlıkları veya çerezler olmadan herkese açık erişilebilen referans video HTTPS URL'si; ses yok sayılır. Kabul edilen dosya kombinasyonları H.264, H.265/HEVC veya ProRes ile .mp4, .mov ya da .m4v veya VP8 ya da VP9 ile .webm'dir; süre 1 ile 120 saniye arasında, boyut en fazla 1 GiB olmalı ve görüntü en-boy oranı 9:16 veya 16:9 değerlerinden birinin %5'i içinde bulunmalıdır. image_reference_url de sağlanırsa video önceliklidir.
avataristeğe bağlı
Türenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 tane dahaNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Yalnızca görsel veya video referansı sağlanmadığında kullanılan stok görsel seçimi; None ve varsayılan değer, seçimi boş bırakır. Bu görselden hiçbir zaman ses sağlanmaz; ses her zaman audio_url'den gelir. Görsel seçmek için seçenekleri [avatar kataloğunda](https://captions.ai/help/docs/api/actor-catalog) önizleyin ve tam Avatar değerini kopyalayın.
image_reference_urlisteğe bağlı
Türstring | null
Çerezler veya yetkilendirme başlıkları olmadan herkese açık erişilebilen referans görsel HTTPS URL'si; video_reference_url sağlanırsa yok sayılır. .jpg, .jpeg, .png veya .webp biçiminde tek bir statik görsel kabul edilir; sınır 25 MiB ve 25 megapikseldir. Kısa kenar en az 512 px, hiçbir kenar 8192 px'den büyük olmamalı; en-boy oranı 9:16 veya 16:9 değerinin %5'i içinde olmalıdır.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

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"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
video
object {url, content_type, file_name, file_size}

Daha fazla model: Dudak Senkronizasyonu ve Avatarlar

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/mirage-api/avatar-x/reference-to-video.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt