HeyGen: Avatar IV
Avatar IV menganimasikan foto menjadi video berbicara dengan sinkronisasi bibir, serta ekspresi wajah dan waktu gestur yang dipandu suara. HeyGen mendokumentasikan alur kerja naskah atau audio rekaman dan kendali gerak Photo Avatar untuk presenter realistis atau bergaya.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Avatar IV adalah mesin avatar HeyGen untuk mengubah gambar diam menjadi video berbicara yang ekspresif. Desain audio ke ekspresi yang terinspirasi difusi menggunakan nada vokal, irama, dan emosi untuk memandu gerak wajah, kemiringan kepala, jeda, serta ekspresi mikro. Tujuannya adalah presenter atau karakter yang menyampaikan konten lisan dengan sinkronisasi bibir dan gestur, bukan generator adegan umum yang menciptakan seluruh latar serta trek bunyi dari prompt sinematik.
Produsen menjelaskan dukungan untuk karakter realistis dan bergaya, termasuk gambar menyudut atau profil, wajah bergaya anime, serta hewan peliharaan. Karakter berbasis foto bekerja paling baik ketika mata, mulut, dan struktur wajahnya mudah diidentifikasi. HeyGen menyarankan gambar jelas dengan pencahayaan baik, postur alami, dan tangan terlihat ketika gestur penting. Wajah sangat kecil, bibir tersembunyi, masker berat, paruh menonjol, atau proporsi yang sangat berlebihan dapat melemahkan gerak wajah serta sinkronisasi bibir. Sesuaikan pembingkaian sumber dengan penampilan yang dimaksud.
Produsen menyediakan dua jalur masukan ucapan. Naskah tertulis dipasangkan dengan suara pilihan; trek audio prarekaman menyediakan suara dan waktu secara langsung. Gunakan jalur audio rekaman ketika penyampaian sudah ditentukan, dan jalur naskah ketika ucapan perlu disintesis. Masukan ini merupakan alternatif dalam antarmuka yang didokumentasikan. Siapkan susunan kata akhir, nama, dan pelafalan sebelum animasi, lalu simpan audio atau naskah bersama video yang dikembalikan agar hasil lisan dapat diperiksa.
Profil model Avatar IV HeyGen mencakup avatar studio, Digital Twins, Photo Avatars, gambar langsung, dan subjek yang dibuat melalui prompt. Photo Avatar yang dapat digunakan kembali menyediakan subjek stabil untuk video berikutnya, sedangkan alur kerja gambar langsung dimulai dari gambar yang diberikan. Profil Photo Avatar produsen menawarkan instruksi gerak teks bebas dan pilihan ekspresivitas high, medium, atau low, dengan low sebagai bawaan. Pertahankan tampilan avatar serta mesin pilihan ketika membuat seri agar perubahan gambar sumber atau model render tidak menjadi perubahan presenter yang luput disadari.
Untuk arahan gerak, jelaskan tindakan tubuh yang terlihat dan kualitas emosionalnya. “Mengangguk lembut dengan senyum hangat” memberikan satu gestur dan satu ekspresi; salam singkat dapat menggunakan lambaian ramah. Pembuatnya menyarankan satu gestur utama, yang secara opsional dipasangkan dengan ekspresi wajah, dan tidak lebih dari dua klausa singkat untuk suatu urutan. Avatar IV menangani tempo dari penampilan, sehingga panduan Studio tidak mewajibkan jadwal gestur detik demi detik. Susunan kata yang spesifik dan ringkas lebih mudah diperiksa daripada beberapa tindakan yang bersaing dalam satu prompt.
Profil audio ke video produsen merender hingga tiga puluh menit audio yang diberikan per permintaan, dan aset MP3 atau WAV yang diunggah memiliki batas 32 MB. Untuk pelajaran atau rekaman yang lebih panjang, bagi materi pada batas ucapan yang koheren dan pertahankan urutan aslinya. Waktu ucapan video akhir seharusnya mengikuti audio pilihan, bukan perkiraan durasi klip yang tidak berkaitan.
Pengaturan keluaran produsen yang didokumentasikan mencakup 720p atau 1080p dan bentuk 16:9, 9:16, 4:5, 5:4, atau 1:1, dengan pilihan otomatis yang mengikuti proporsi sumber. Penyesuaian cover dapat memangkas subjek; contain memuat seluruh subjek dan mungkin membiarkan latar di sekelilingnya terlihat. Alur kerja audio ke video secara bawaan mengembalikan MP4. Untuk avatar video, keluaran WebM transparan memerlukan dukungan matting, dan produsen menerapkan penghapusan latar untuk keluaran tersebut, alih-alih menggabungkannya dengan latar baru. Periksa pembingkaian dan berkas sebenarnya sebelum menempatkan presenter dalam komposisi yang lebih besar.
Pengantar pelatihan dapat menggunakan gambar presenter yang jelas, penjelasan ringkas, dan satu gestur terkendali pada instruksi utama. Penjelasan produk dapat mempertahankan tampilan avatar yang sama sambil mengubah naskah lisan untuk fitur berbeda. Produsen juga mendokumentasikan berkas subtitel opsional dan teks keterangan yang ditanam dalam video; tinjau susunan kata serta waktunya bersama ucapan. Render bersifat asinkron dalam antarmuka pembuatnya, sehingga respons pembuatan dan video lengkap adalah artefak berbeda. Simpan rekaman akhir dan status penyelesaiannya bersama hasil tugas.
Avatar IV tetap berbeda dari gerak berbasis referensi Avatar V dan kendali prasetel Studio-nya yang terpisah. Avatar IV juga berbeda dari generasi adegan serbaguna HeyGen Video dan percakapan avatar langsung interaktif. Tinjau gerak mulut yang dirender, tangan yang terlihat, ekspresi wajah, jeda, serta kata-kata yang diucapkan terhadap materi sumber dan nada yang dimaksud. Gambar, pose, pencahayaan, dan instruksi gerak memengaruhi hasil; animasi berbasis foto perlu diperiksa sebagai penampilan hasil generasi, dengan masukan pilihan disimpan untuk revisi berikutnya.
Ailoot Ultra · Pemrosesan video POST /v1/videos heygen/avatar-iv
heygen/avatar-ivMulai
Avatar IV menganimasikan foto menjadi video berbicara dengan sinkronisasi bibir, serta ekspresi wajah dan waktu gestur yang dipandu suara. HeyGen mendokumentasikan alur kerja naskah atau audio rekaman dan kendali gerak Photo Avatar untuk presenter realistis atau bergaya.
- Masukan yang diterima
- Teks · Gambar · Audio · Video
- Hasil
- Video
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Pemrosesan video POST /v1/videos
- Masukan
text,image,audio,video- Keluaran
video
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan heygen/avatar-iv | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanWajib | Nilai & batasan Item minimum: 2 Item maksimum: 2 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, input_references |
Parametermaterial_types | Kontraktext, image, audio, video |
Parametermaterial_conditions | KontrakGunakan URL konten aset media aktual yang telah selesai dan dimiliki Ailoot beserta tanda tangan yang dikembalikan: satu sumber video untuk BFL, atau satu sumber gambar dan satu sumber audio untuk avatar. Bukti pemilik/tipe/byte pada Source diperlukan., Berikan tepat satu aset gambar PNG/JPEG dan satu aset audio WAV/MP3. Ukuran audio paling banyak 32000000 byte, dengan durasi lebih dari 0 dan paling banyak 1800 detik. |
Siklus hidup: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · id atau polling_url aktual yang dikembalikan
GET /v1/videos/{request_id}/content
Paket
Cara menghitung biaya akhir
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Perkiraan tarif untuk perbandingan
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Satuan penagihan | Kondisi penagihan | Biaya |
|---|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Satuan penagihan— | Kondisi penagihan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiHarga video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper detik video | Kondisi penagihanTidak ada kondisi tambahan yang dinyatakan dalam kunci harga ini. | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.1 per detik video |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Satuan penagihan— | Kondisi penagihan— | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.1 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Pemrosesan video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'heygen/avatar-iv', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Terima dan simpan hasil
Ailoot Ultra · Pemrosesan video
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Simpan semua aset yang selesai
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Simpan semua hasil yang selesai
Simpan setiap video yang selesai atau berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.
Jika respons asli perlu diperiksa
Simpan X-Client-Request-ID, X-Ailoot-Task-Id, dan id/polling_url aktual yang dikembalikan. Lanjutkan tugas awal; jangan kirim ulang permintaan pembuatan.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomid | Jenis |
Kolomstatus | Jenis |
Kolomdata[] | Jenis |
Kolomoutputs[] | Jenis |
Alias
Alias model
Ailoot Ultra heygen/avatar-iv
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · HeyGen: Avatar IV
- Input dan hasil apa yang tersedia?
POST /v1/videos·heygen/avatar-iv:text,image,audio,video→video- Kolom apa yang digunakan permintaan?
POST /v1/videos·heygen/avatar-iv:model,input_references,prompt