![]()
HeyGen Avatar 6 API dapat membuat video presenter hanya dari sebuah skrip. Dalam mode avatar publik, Anda menyebut salah satu dari 1,248 tampilan siap pakai HeyGen, mengirim text hingga 1,000 karakter, memilih salah satu dari 102 suara, dan heygen-avatar-6 (atau heygen-avatar-6-turbo) mengembalikan MP4 dengan lip-sync. Tanpa foto, tanpa rekaman, tanpa langkah text-to-speech di sisi Anda. Panduan ini membahas cara memilih tampilan dan suara dari katalog, mengarahkan gestur dengan prompt, memilih bentuk frame, dan berapa biaya request teks. Anda juga bisa menjelajahi tampilan di halaman model HeyGen Avatar 6.
Request teks ke avatar
Ini body yang terdokumentasi untuk mode avatar publik dengan teks:
{
"model": "heygen-avatar-6-turbo",
"input": {
"avatar": "Abigail Office Front",
"text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
"voice": "Warm Pro Narrator",
"prompt": "Speak with calm confidence and nod slightly at the end.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
| Field | Wajib | Aturan |
|---|---|---|
avatar | Ya | Salah satu dari 1,248 nama tampilan |
text | Ya (sebagai pengganti audio_url) | 1–1,000 karakter |
voice | Tidak | Salah satu dari 102 nama; default Warm Pro Narrator |
prompt | Tidak | Hingga 1,200 karakter arahan |
aspect_ratio | Tidak | 16:9 (default), 9:16, 1:1, 4:5, 5:4 |
resolution | Tidak | 1080p (default) atau 2K |
Keberadaan avatar adalah yang memilih mode ini. Jangan kirim juga image_urls atau video_url; gunakan input dari satu mode per request. Submit ke POST https://api.poyo.ai/api/generate/submit dan lakukan polling ke /api/generate/status/{task_id} seperti di panduan HeyGen Avatar 6 API.
Pilih tampilan avatar dari katalog
PoYo memublikasikan setiap nama di halaman Avatars and Voices dan sebagai katalog JSON. Katalog memiliki lima key:
| Key | Isi |
|---|---|
models | heygen-avatar-6, heygen-avatar-6-turbo (nama yang sama berlaku di keduanya) |
default_voice | Warm Pro Narrator |
avatars | Semua 1,248 nama tampilan, dalam daftar datar |
avatars_by_person | Tampilan yang sama dikelompokkan per 156 orang |
voices | Semua 102 nama suara |
Setiap orang punya satu atau lebih tampilan, dan setiap tampilan adalah nilai avatar tersendiri. Abigail punya lima (Abigail (Upper Body), Abigail Office Front, Abigail Office Side, Abigail Sofa Front, Abigail Sofa Side); Annie punya 54; delapan orang hanya punya satu tampilan. Nama-namanya menggambarkan latar, pakaian, dan sudut kamera, yang biasanya cukup untuk memilih tanpa pratinjau:
| Yang Anda inginkan | Cari nama seperti | Contoh |
|---|---|---|
| Presenter menghadap kamera | Front | Abigail Office Front, Bryan Suit Front |
| Sudut tiga perempat | Side | Abigail Office Side |
| Duduk, santai | Sofa, Sitting, Lounge | Annie Sofa Sitting Front |
| Peran atau latar tertentu | Doctor, Nurse, Yoga, Tech Expert | Ann Doctor Standing, Adriana Nurse Front, Amelia Yoga Front, Bryan Tech Expert |
Sekitar 480 nama mengandung Front dan sekitar 430 mengandung Side. Untuk seri video penjelasan, pilih satu orang dan gunakan tampilan Front miliknya, agar presenter tetap sama di semua video. Gunakan tampilan Side yang sepadan untuk cutaway.
Nama dicocokkan tanpa memedulikan huruf besar-kecil dan spasi berlebih, jadi abigail office front memilih Abigail Office Front. PoYo memeriksa avatar terhadap daftar saat submit, sehingga salah ketik langsung mengembalikan 400, bukan task yang gagal. Validasi dulu di kode Anda sendiri:
import requests
catalog = requests.get(
"https://docs.poyo.ai/api-manual/video-series/heygen-avatar-6-catalog.json", timeout=30
).json()
def norm(name: str) -> str:
return " ".join(name.split()).lower()
AVATARS = {norm(a): a for a in catalog["avatars"]}
VOICES = set(catalog["voices"])
def build_request(model, avatar, text, voice=None, prompt=None, aspect_ratio="16:9", resolution="1080p"):
if norm(avatar) not in AVATARS:
raise ValueError(f"unknown avatar: {avatar!r}")
if not 1 <= len(text) <= 1000:
raise ValueError("text must be 1-1,000 characters")
if voice is not None and voice not in VOICES:
raise ValueError(f"unknown voice: {voice!r} (copy the exact name from the catalog)")
if prompt is not None and len(prompt) > 1200:
raise ValueError("prompt must be at most 1,200 characters")
body = {"avatar": AVATARS[norm(avatar)], "text": text,
"aspect_ratio": aspect_ratio, "resolution": resolution}
if voice:
body["voice"] = voice
if prompt:
body["prompt"] = prompt
return {"model": model, "input": body}
Pemeriksaan suara sengaja memakai nama persis; bagian berikutnya menjelaskan alasannya.
Pilih suara
voice menentukan siapa yang membacakan text. Jika dihilangkan, Anda mendapat Warm Pro Narrator. Ke-102 suara mencakup nama biasa (Andrew, Ivy, Jessica Anne Bogart), nama deskriptif (Calm Chloe, Professor Dean, Radio Rick, Chill Brian), dan beberapa dengan tag gaya di namanya.
Tiga hal yang sering menjebak:
- Spasi di akhir bisa berpengaruh. Dokumentasi menyebutkan bahwa
HopedanHope(dengan spasi di akhir) adalah dua suara yang berbeda.Archer,Cassidy,Adam Stone,Spuds Oxley, danAndrew Rizzjuga diakhiri spasi di katalog. Salin nama dari JSON alih-alih mengetik ulang. - Beberapa nama mengandung emoji atau akhiran mirip nama file, seperti
Cute Chloe - Friendly 😊atauBrenda - UGC - 1.mp4. Karakter tersebut adalah bagian dari nama. Kirim body request sebagai JSON UTF-8 dan nama akan diteruskan tanpa perubahan. - Suara tidak terikat pada avatar. Salah satu dari 102 suara dapat membacakan untuk salah satu dari 1,248 tampilan. Pilih suara yang cocok dengan orang di layar; uji hari peluncuran kami memasangkan
Bryan Tech ExpertdenganAndrewdanAbigail Office FrontdenganJessica Anne Bogart.
voice hanya berlaku saat Anda mengirim text. Jika Anda mengirim audio_url, avatar mengucapkan rekaman Anda dan voice tidak dipakai.
Arahkan gestur dengan prompt
prompt menerima hingga 1,200 karakter arahan untuk gestur, ekspresi, dan postur. Laporan teknis HeyGen menjelaskan tekniknya: "Tulis aksinya di samping kata-katanya. Avatar 6 memeragakannya tepat pada saatnya." Contohnya: "Apoteker yang ramah. Pada 'Hello', acungkan jempol. Pada 'the counter on the left', tunjuk ke samping dengan jari telunjuk."
Pola yang mengikuti format tersebut:
{
"model": "heygen-avatar-6",
"input": {
"avatar": "Bryan Tech Expert",
"text": "Hello! Today I will show you three settings that make your dashboard faster. First, open the menu on the left.",
"voice": "Andrew",
"prompt": "Friendly product expert. On 'Hello', wave once. On 'three settings', hold up three fingers. On 'the menu on the left', point to his left side. Keep a relaxed posture and smile between sentences.",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
Tips agar prompt tetap berguna:
- Kutip kata persis dari
texttempat setiap aksi harus jatuh, agar isyaratnya tidak ambigu. - Jelaskan satu peran atau suasana terlebih dahulu ("Friendly product expert"), lalu isyaratnya.
- Hilangkan
promptjika Anda tidak punya isyarat spesifik. Halaman peluncuran Avatar 6 HeyGen menyebutkan bahwa model ini "menyesuaikan gestur, emosi, dan ekspresi dengan skrip Anda" dengan sendirinya.
Pilih rasio aspek sesuai penempatan
aspect_ratio hanya ada di mode avatar publik; mode foto dan video referensi mempertahankan bentuk input.
| Penempatan | aspect_ratio |
|---|---|
| Situs web, YouTube, pelajaran LMS | 16:9 (default) |
| Shorts, Reels, TikTok, stories | 9:16 |
| Postingan feed persegi, kartu dalam aplikasi | 1:1 |
| Postingan feed potret | 4:5 |
| Postingan feed lanskap | 5:4 |
resolution terpisah: 1080p atau 2K di rasio apa pun. 2K lebih mahal per detik, jadi render draf di 1080p.
Berapa durasi video dan berapa biayanya
Dengan teks, video berjalan sepanjang waktu yang dibutuhkan avatar untuk membacanya, hingga 1,000 karakter. Anda ditagih untuk durasi video jadi, dibulatkan ke atas ke detik penuh. Kredit dicadangkan saat Anda submit dan diselesaikan sesuai detik aktual saat task selesai.
Uji hari peluncuran kami di API produksi, 19 November 2026 (16:9, 1080p):
| Model | Avatar / suara | Skrip | Output | Biaya dengan harga saat ini | Waktu tempuh |
|---|---|---|---|---|---|
heygen-avatar-6-turbo | Abigail Office Front / Jessica Anne Bogart | 27 kata | 10.16 dtk | 110 kredit ($0.55) | Sekitar 2.4 menit |
heygen-avatar-6 | Bryan Tech Expert / Andrew | 21 kata | 6.88 dtk | 140 kredit ($0.70) | Sekitar 2 menit |
Itu setara kira-kira 2.7 dan 3.1 kata per detik pada kedua jalan ini, berguna untuk anggaran kasar tetapi bukan jaminan, karena tempo bervariasi menurut suara dan skrip. Tarif per detik: Turbo 10 kredit ($0.05) di 1080p atau 18 ($0.09) di 2K; Avatar 6 20 kredit ($0.10) atau 29 ($0.145). Lihat harga HeyGen Avatar 6 API untuk selengkapnya.
Karena task teks menahan pencadangan selama berjalan, mengirim banyak sekaligus dapat mengembalikan HTTP 200 dengan code 402 di body (insufficient_credits_error). Dalam uji kami, request ketiga ditolak dengan: "this request needs at least 252 credits, and 344 credits are already reserved by your unfinished HeyGen Avatar 6 text tasks." Masukkan job teks ke antrean, atau jaga saldo yang menutupi pencadangan yang sedang berjalan. Gunakan Turbo selama iterasi; perbandingan Avatar 6 vs Turbo menunjukkan kapan harus beralih.
Pertanyaan yang sering diajukan
Bisakah HeyGen Avatar 6 API mengubah teks menjadi video avatar berbicara?
Ya. Dalam mode avatar publik, kirim avatar, text hingga 1,000 karakter, dan voice secara opsional. Tidak perlu file audio.
Di mana daftar avatar dan suara HeyGen Avatar 6 API?
Di halaman dokumentasi PoYo Avatars and Voices, dan sebagai katalog JSON yang dapat diunduh dengan key avatars, avatars_by_person, dan voices.
Apa suara default di HeyGen Avatar 6 API?
Warm Pro Narrator, dipakai saat voice dihilangkan.
Bisakah saya memakai foto sendiri dengan teks alih-alih avatar siap pakai?
Tidak. text hanya berfungsi di mode avatar publik. Untuk foto Anda sendiri, gunakan mode foto dengan image_urls dan audio_url; buat audionya terlebih dahulu dengan model TTS jika perlu.
Rasio aspek apa yang didukung teks ke avatar HeyGen Avatar 6?
16:9, 9:16, 1:1, 4:5, dan 5:4, di 1080p atau 2K.
Bagaimana request teks HeyGen Avatar 6 API ditagih?
Berdasarkan durasi video jadi, dibulatkan ke atas ke detik penuh, dengan tarif per detik model tersebut. Kredit dicadangkan saat submit dan diselesaikan saat task berakhir.