![]()
HeyGen Avatar 6 API, yalnızca bir metinden sunucu videosu üretebilir. Herkese açık avatar modunda HeyGen'in 1,248 hazır görünümünden birini belirtir, en fazla 1,000 karakter text gönderir, 102 sesten birini seçersiniz ve heygen-avatar-6 (veya heygen-avatar-6-turbo) dudak senkronlu bir MP4 döndürür. Fotoğraf yok, kayıt yok, sizin tarafınızda metinden sese dönüştürme adımı yok. Bu rehber; katalogdan bir görünüm ve ses seçmeyi, jestleri prompt ile yönlendirmeyi, kadraj biçimini seçmeyi ve bir metin isteğinin maliyetini ele alıyor. Görünümlere HeyGen Avatar 6 model sayfasından da göz atabilirsiniz.
Text-to-avatar isteği
Bu, metinle herkese açık avatar modu için belgelenmiş gövdedir:
{
"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"
}
}
| Alan | Zorunlu | Kural |
|---|---|---|
avatar | Evet | 1,248 görünüm adından biri |
text | Evet (audio_url yerine) | 1–1,000 karakter |
voice | Hayır | 102 addan biri; varsayılan Warm Pro Narrator |
prompt | Hayır | En fazla 1,200 karakter yönlendirme |
aspect_ratio | Hayır | 16:9 (varsayılan), 9:16, 1:1, 4:5, 5:4 |
resolution | Hayır | 1080p (varsayılan) veya 2K |
Bu modu seçen şey avatar alanının varlığıdır. Ayrıca image_urls veya video_url göndermeyin; her istekte tek bir modun girdilerini kullanın. HeyGen Avatar 6 API rehberindeki gibi POST https://api.poyo.ai/api/generate/submit adresine gönderin ve /api/generate/status/{task_id} sorgulayın.
Katalogdan bir avatar görünümü seçin
PoYo tüm adları Avatars and Voices sayfasında ve bir JSON kataloğu olarak yayımlar. Katalogda beş anahtar vardır:
| Anahtar | İçerik |
|---|---|
models | heygen-avatar-6, heygen-avatar-6-turbo (aynı adlar ikisinde de çalışır) |
default_voice | Warm Pro Narrator |
avatars | 1,248 görünüm adının tamamı, düz liste |
avatars_by_person | Aynı görünümler, 156 kişi altında gruplanmış |
voices | 102 ses adının tamamı |
Her kişinin bir veya daha fazla görünümü vardır ve her görünüm ayrı bir avatar değeridir. Abigail'in beş görünümü var (Abigail (Upper Body), Abigail Office Front, Abigail Office Side, Abigail Sofa Front, Abigail Sofa Side); Annie'nin 54; sekiz kişinin ise tek görünümü var. Adlar ortamı, kıyafeti ve kamera açısını tanımlar; bu da genellikle önizleme yapmadan seçim için yeterlidir:
| İstediğiniz | Şunu içeren adlara bakın | Örnekler |
|---|---|---|
| Kameraya bakan sunucu | Front | Abigail Office Front, Bryan Suit Front |
| Dörtte üç açı | Side | Abigail Office Side |
| Oturarak, gündelik | Sofa, Sitting, Lounge | Annie Sofa Sitting Front |
| Bir rol veya ortam | Doctor, Nurse, Yoga, Tech Expert | Ann Doctor Standing, Adriana Nurse Front, Amelia Yoga Front, Bryan Tech Expert |
Yaklaşık 480 ad Front, yaklaşık 430 ad Side içerir. Bir açıklayıcı video serisi için tek bir kişi seçin ve onun Front görünümlerine bağlı kalın; böylece sunucu videolar boyunca aynı kalır. Ara çekimler için eşleşen Side görünümünü kullanın.
Adlar büyük/küçük harf ve fazladan boşluklardan bağımsız eşleşir; yani abigail office front, Abigail Office Front görünümünü seçer. PoYo avatar değerini gönderimde listeyle karşılaştırır; bu yüzden bir yazım hatası başarısız bir görev yerine anında 400 döndürür. Önce kendi kodunuzda doğrulayın:
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}
Ses kontrolü bilerek tam adları kullanır; nedenini bir sonraki bölüm açıklıyor.
Bir ses seçin
voice, text alanını kimin okuyacağını belirler. Belirtmezseniz Warm Pro Narrator kullanılır. 102 ses arasında düz adlar (Andrew, Ivy, Jessica Anne Bogart), betimleyici adlar (Calm Chloe, Professor Dean, Radio Rick, Chill Brian) ve adında stil etiketi bulunan bazı sesler yer alır.
Üç nokta sık sorun çıkarır:
- Sondaki boşluklar önemli olabilir. Belgeler,
HopeileHope(sonunda boşluk olan) sesinin iki farklı ses olduğunu vurguluyor.Archer,Cassidy,Adam Stone,Spuds OxleyveAndrew Rizzda katalogda boşlukla bitiyor. Adları yeniden yazmak yerine JSON'dan kopyalayın. - Bazı adlar emoji veya dosya adına benzeyen ekler içerir, örneğin
Cute Chloe - Friendly 😊veyaBrenda - UGC - 1.mp4. Bu karakterler adın parçasıdır. İstek gövdesini UTF-8 JSON olarak gönderin; ad değişmeden iletilir. - Ses avatara bağlı değildir. 102 sesin herhangi biri 1,248 görünümün herhangi biri için okuyabilir. Ekrandaki kişiye uyan bir ses seçin; lansman günü testlerimizde
Bryan Tech ExpertileAndrew,Abigail Office FrontileJessica Anne Bogarteşleştirdik.
voice yalnızca text gönderdiğinizde geçerlidir. Bunun yerine audio_url gönderirseniz avatar sizin kaydınızı konuşur ve voice kullanılmaz.
Jestleri prompt ile yönlendirin
prompt, jestler, ifade ve duruş için en fazla 1,200 karakter yönlendirme alır. HeyGen'in teknik raporu tekniği şöyle anlatıyor: "Eylemi kelimelerin yanına yazın. Avatar 6 onu tam zamanında yapar." Rapordaki örnek: "Friendly pharmacist. On 'Hello', give a thumbs up. On 'the counter on the left', point to the side with your index finger."
Bu biçimi izleyen bir kalıp:
{
"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"
}
}
Prompt'ları işe yarar tutan ipuçları:
- Her eylemin denk gelmesi gereken
textiçindeki kelimeleri birebir alıntılayın; böylece işaret belirsiz olmaz. - Önce tek bir rol veya ruh hâli tanımlayın ("Friendly product expert"), sonra işaretleri yazın.
- Belirli işaretleriniz yoksa
promptalanını boş bırakın. HeyGen'in Avatar 6 lansman sayfası, modelin kendi başına "jest, duygu ve ifadeyi metninize uydurduğunu" söylüyor.
Yayın yerine göre en-boy oranını seçin
aspect_ratio yalnızca herkese açık avatar modunda vardır; fotoğraf ve referans video modları girdinin biçimini korur.
| Yayın yeri | aspect_ratio |
|---|---|
| Web sitesi, YouTube, LMS dersi | 16:9 (varsayılan) |
| Shorts, Reels, TikTok, hikâyeler | 9:16 |
| Kare akış gönderisi, uygulama içi kart | 1:1 |
| Dikey akış gönderisi | 4:5 |
| Yatay akış gönderisi | 5:4 |
resolution ayrıdır: her oranda 1080p veya 2K. 2K saniye başına daha pahalıdır; bu yüzden taslakları 1080p'de üretin.
Video ne kadar sürer ve ne kadar tutar
Metinle video, avatarın metni okuması ne kadar sürüyorsa o kadar sürer; en fazla 1,000 karakter. Bitmiş videonun tam saniyeye yukarı yuvarlanmış süresi için ödeme yaparsınız. Krediler gönderimde ayrılır ve görev bittiğinde gerçek saniyelere göre hesaplaşılır.
Üretim API'sinde lansman günü testlerimiz, 19 Kasım 2026 (16:9, 1080p):
| Model | Avatar / ses | Metin | Çıktı | Güncel fiyatlarla maliyet | Süre |
|---|---|---|---|---|---|
heygen-avatar-6-turbo | Abigail Office Front / Jessica Anne Bogart | 27 kelime | 10.16 s | 110 kredi ($0.55) | Yaklaşık 2.4 min |
heygen-avatar-6 | Bryan Tech Expert / Andrew | 21 kelime | 6.88 s | 140 kredi ($0.70) | Yaklaşık 2 min |
Bu iki çalıştırmada bu, saniyede yaklaşık 2.7 ve 3.1 kelimeye denk geliyor; kaba bir bütçe için faydalı ama bir garanti değil, çünkü tempo sese ve metne göre değişir. Saniye başı ücretler: Turbo 1080p'de 10 kredi ($0.05) veya 2K'da 18 ($0.09); Avatar 6 20 kredi ($0.10) veya 29 ($0.145). Daha fazlası için HeyGen Avatar 6 API fiyatlandırması yazısına bakın.
Metin görevleri çalışırken bir ayırma tuttuğu için çok sayıda görevi aynı anda göndermek, gövdede code 402 (insufficient_credits_error) ile HTTP 200 döndürebilir. Testimizde üçüncü bir istek şu mesajla reddedildi: "this request needs at least 252 credits, and 344 credits are already reserved by your unfinished HeyGen Avatar 6 text tasks." Metin işlerini kuyruğa alın veya çalışan ayırmaları karşılayacak bir bakiye tutun. Denemeler sırasında Turbo kullanın; Avatar 6 vs Turbo karşılaştırması ne zaman geçiş yapacağınızı gösteriyor.
Sıkça sorulan sorular
HeyGen Avatar 6 API metni konuşan bir avatar videosuna dönüştürebilir mi?
Evet. Herkese açık avatar modunda avatar, en fazla 1,000 karakter text ve isteğe bağlı olarak voice gönderin. Ses dosyası gerekmez.
HeyGen Avatar 6 API avatar ve ses listesi nerede?
PoYo'nun Avatars and Voices belge sayfasında ve avatars, avatars_by_person ile voices anahtarlarını içeren indirilebilir bir JSON kataloğunda.
HeyGen Avatar 6 API'de varsayılan ses nedir?
voice belirtilmediğinde kullanılan Warm Pro Narrator.
Hazır bir avatar yerine kendi fotoğrafımı metinle kullanabilir miyim?
Hayır. text yalnızca herkese açık avatar modunda çalışır. Kendi fotoğrafınız için image_urls ve bir audio_url ile fotoğraf modunu kullanın; gerekirse sesi önce bir TTS modeliyle üretin.
HeyGen Avatar 6 text to avatar hangi en-boy oranlarını destekler?
16:9, 9:16, 1:1, 4:5 ve 5:4; 1080p veya 2K çözünürlükte.
HeyGen Avatar 6 API metin isteği nasıl ücretlendirilir?
Bitmiş videonun tam saniyeye yukarı yuvarlanmış süresine göre, modelin saniye başı ücretiyle. Krediler gönderimde ayrılır ve görev bittiğinde hesaplaşılır.