![]()
PoYo'daki HeyGen Avatar 6 API'nin iki model kimliği vardır: HeyGen'in Avatar 6 Quality katmanı olan heygen-avatar-6 ve heygen-avatar-6-turbo. Tek bir uç noktayı, tek bir istek biçimini ve tüm limitleri paylaşırlar; bu yüzden seçim bir entegrasyon projesi değil, maliyet ve kaliteye göre istek başına verilen bir yönlendirme kararıdır. Bu sayfa neyin aynı olduğunu, neyin farklı olduğunu, neyi ölçtüğümüzü ve seçim için bir kuralı ortaya koyuyor. İkisi de HeyGen Avatar 6 model sayfasında yer alıyor.
HeyGen Avatar 6 API'nin iki katmanında aynı olanlar
PoYo'nun HeyGen Avatar 6 belgeleri Turbo'yu "aynı girdi ve modlara sahip Avatar 6'nın Turbo katmanı" olarak tanımlıyor. HeyGen'in kendi geliştirici belgeleri de aynısını söylüyor: iki model de "aynı girdileri alır".
| Öğe | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Uç nokta | POST /api/generate/submit | Aynı |
Fotoğraf modu (image_urls + audio_url) | Evet | Evet |
Referans video modu (video_url + audio_url) | Evet | Evet |
Herkese açık avatar modu (avatar + text/voice veya audio_url) | Evet | Evet |
| Avatarlar ve sesler | 1,248 görünüm, 102 ses | Aynı liste |
| Ses | 2–60 s, en fazla 15 MB | Aynı |
| Metin | En fazla 1,000 karakter | Aynı |
prompt | En fazla 1,200 karakter | Aynı |
resolution | 1080p (varsayılan), 2K | Aynı |
aspect_ratio (herkese açık avatar) | 16:9, 9:16, 1:1, 4:5, 5:4 | Aynı |
| Faturalama kuralları | Yukarı yuvarlanmış saniyeler; ses gönderimde tahsil edilir, metin ayrılır ve sonra hesaplaşılır | Aynı |
input içinde hiçbir şey değişmediği için bir modelde çalışan istek gövdesi diğerinde de çalışır. Değişen tek şey model dizesidir.
Farklı olan: fiyat
1 kredi = $0.005, çıktı saniyesi başına:
| Çözünürlük | heygen-avatar-6 | heygen-avatar-6-turbo | Turbo tasarrufu |
|---|---|---|---|
| 1080p | 20 kredi ($0.10) | 10 kredi ($0.05) | %50 |
| 2K | 29 kredi ($0.145) | 18 kredi ($0.09) | %38 |
Yalnızca model kimliği değiştiğinde aynı klip için fiyat:
| Klip | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| 10 s, 1080p | 200 kredi ($1.00) | 100 kredi ($0.50) |
| 10 s, 2K | 290 kredi ($1.45) | 180 kredi ($0.90) |
| 30 s, 1080p | 600 kredi ($3.00) | 300 kredi ($1.50) |
| 60 s, 1080p | 1,200 kredi ($6.00) | 600 kredi ($3.00) |
| 60 s, 2K | 1,740 kredi ($8.70) | 1,080 kredi ($5.40) |
Yönlendirmeyi etkileyen bir karşılaştırma daha: 2K'da Turbo (saniye başına 18 kredi), 1080p'de Avatar 6'dan (20) ucuzdur. Piksel sayısına Quality katmanından daha çok ihtiyacınız varsa, bunu elde etmenin daha ucuz yolu Turbo 2K'dır.
Ayrıntılar HeyGen Avatar 6 API fiyatlandırması yazısında.
Farklı olan: HeyGen'e göre kalite ve hız
HeyGen, teknik raporunda katmanları "Avatar 6 Quality" ve "Avatar 6 Turbo" olarak adlandırıyor ama aralarındaki farkı tanımlamıyor ve Turbo için gecikme rakamı yayımlamıyor. Yayımladığı şey, her katmanın kendi öncülüne karşı sonucudur: 879 oyun %69.7'si Avatar 6 Quality'yi Avatar V'ye, 863 oyun %64.3'ü Avatar 6 Turbo'yu Avatar V Turbo'ya tercih etti. HeyGen bir Quality-Turbo oylaması yayımlamadı; bu yüzden Turbo ile neyden ne kadar vazgeçtiğinize dair resmî bir rakam yok.
Lansman günü ölçtüklerimiz
PoYo ekibi 19 Kasım 2026'da üretim API'sinde her modelde birer metin isteği çalıştırdı. Süre, birkaç saniyede bir sorgulayan bir istemci için gönderimden sonuca kadar geçen süredir; bu yüzden yaklaşık kabul edin.
heygen-avatar-6-turbo | heygen-avatar-6 | |
|---|---|---|
| Avatar / ses | Abigail Office Front / Jessica Anne Bogart | Bryan Tech Expert / Andrew |
| Metin | 27 kelime | 21 kelime |
| Ayarlar | 16:9, 1080p | 16:9, 1080p |
| Çıktı süresi | 10.16 s | 6.88 s |
| Güncel fiyatlarla maliyet | 110 kredi (11 s × 10) | 140 kredi (7 s × 20) |
| Süre | Yaklaşık 2.4 min | Yaklaşık 2 min |
Bunlar farklı metin ve avatarlarla yapılmış iki tekil çalıştırmadır; bu yüzden Turbo'nun daha hızlı ya da daha yavaş olduğunu göstermezler. Ama maliyet farkını pratikte gösterirler: daha uzun Turbo klibi, daha kısa Avatar 6 klibinden yine de daha ucuza geldi. Ayrıca iki katmanın da dakikalar sürdüğünü gösterirler; yani hiçbiri isteğin üzerinde beklenen senkron bir API değildir. Her iki durumda da sorgulama veya bir callback_url planlayın.
Hangi HeyGen Avatar 6 API model kimliğini çağırmalı
| Durum | Model kimliği | Neden |
|---|---|---|
| Taslaklar, metin ve zamanlama incelemeleri | heygen-avatar-6-turbo | 1080p'de yarı fiyat; alanlar aynı, bu yüzden onaylanan gövde Avatar 6'da değişmeden yeniden çalışır |
| Yüksek hacimli kişiselleştirilmiş klipler | heygen-avatar-6-turbo | Ölçekte saniye başı maliyet belirleyicidir |
| Uygulamanızda önizleme yapan kullanıcılar | heygen-avatar-6-turbo | Kullanıcı avatarları ve metinleri denerken ucuz iterasyonlar |
| Nihai sunucu veya marka videosu | heygen-avatar-6 | HeyGen'in Quality katmanı |
| Kısıtlı bütçeyle 2K gerekiyor | heygen-avatar-6-turbo + 2K | Saniye başına 18 kredi, 1080p'deki Avatar 6'nın altında |
| Nihai 2K master | heygen-avatar-6 + 2K | En üst çözünürlükte en üst katman |
Doğal çözüm iki aşamalı bir işlem hattıdır: her taslağı Turbo'da üretin, tam istek gövdesini saklayın ve onaylanan gövdeyi "model": "heygen-avatar-6" ile yeniden gönderin. Aşağıdaki iki istek, model dışında aynıdır:
{
"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",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
{
"model": "heygen-avatar-6",
"input": {
"avatar": "Abigail Office Front",
"text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
"voice": "Warm Pro Narrator",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
Metin girdisinde nihai üretim yeni bir üretimdir; bu yüzden süresi taslaktan biraz farklı olabilir. Ses dosyasıyla iki üretim de aynı sesin süresi kadar sürer ve tam olarak tablonun öngördüğü kadar tutar. Tam istek akışı için HeyGen Avatar 6 API rehberine bakın.
Hatalar ve yeniden denemeler iki katmanda da aynı
İki kimlik arasında yönlendirme yapmak hata yönetimini değiştirmez. İkisi de gövdede aynı code değerlerini döndürür: girdi sorunu için 400 (2–60 s dışında ses, bilinmeyen bir avatar adı, iki moddan alanlar), bakiye yetersiz olduğunda 402 insufficient_credits_error, hız sınırları için 429 ve geçici arızalar için 5xx. Turbo'da 400 alan bir istek Avatar 6'da da 400 alır; bu yüzden bir doğrulama hatasını düzeltmek için asla "diğer katmanda yeniden deneme" yoluna gitmeyin. Bunun yerine girdiyi düzeltin.
Ayırmalar iki katman genelinde geçerlidir. Her iki modeldeki metin görevleri de gönderimden hesaplaşmaya kadar kredi tutar ve 402 mesajı hepsini birlikte sayar. Lansman günü testimizde bir Turbo metin görevi ve bir Avatar 6 metin görevi gönderildikten sonra üçüncü bir metin isteği (Turbo, 2K), HTTP 200 ve gövdede code 402 ile reddedildi: "this request needs at least 252 credits, and 344 credits are already reserved by your unfinished HeyGen Avatar 6 text tasks." Bakiyenizi, hangi modelde çalışırsa çalışsın, çalışan her metin görevine göre boyutlandırın.
Bir yönlendirme fonksiyonu
import math
def pick_model(final: bool) -> str:
"""Route a HeyGen Avatar 6 request. Fields stay identical; only the model changes."""
return "heygen-avatar-6" if final else "heygen-avatar-6-turbo"
PRICE_PER_SECOND = { # credits, 1 credit = $0.005
("heygen-avatar-6-turbo", "1080p"): 10,
("heygen-avatar-6-turbo", "2K"): 18,
("heygen-avatar-6", "1080p"): 20,
("heygen-avatar-6", "2K"): 29,
}
def estimate_credits(model: str, resolution: str, audio_seconds: float) -> float:
return math.ceil(audio_seconds) * PRICE_PER_SECOND[(model, resolution)]
estimate_credits, yukarı yuvarlanmış ses süresine göre ücretlendirilen ses istekleri için kesindir. Metin istekleri için yalnızca bir tahmindir, çünkü ücretlendirilen süre bitmiş videonun süresidir.
Sıkça sorulan sorular
HeyGen Avatar 6 API ile HeyGen Avatar 6 Turbo arasındaki fark nedir?
Fiyat ve HeyGen katmanı. Alanlar, modlar, limitler, avatarlar ve sesler aynıdır. Turbo 1080p'de saniye başına 10 kredi ($0.05) tutarken diğeri 20 ($0.10); 2K'da ise 18 ($0.09) tutarken diğeri 29 ($0.145) tutar.
HeyGen Avatar 6 Turbo daha mı hızlı?
HeyGen'in teknik raporu ve geliştirici belgeleri iki katman için de gecikme rakamı yayımlamıyor. Lansman günündeki iki çalıştırmamızda, farklı metinlerle, kısa bir klip için ikisi de yaklaşık 2 ile 2.4 dakika sürdü; bu yüzden hızı kendi istekleriniz üzerinde ölçülecek bir şey olarak görün.
İsteğimi değiştirmeden Turbo'dan Avatar 6'ya geçebilir miyim?
Evet. model değerini heygen-avatar-6-turbo yerine heygen-avatar-6 yapın; input içindeki her şey geçerli kalır.
HeyGen Avatar 6 Turbo 2K destekliyor mu?
Evet, "resolution": "2K" ile, saniye başına 18 kredi ($0.09).
HeyGen Avatar 6 API'nin hangi katmanıyla başlamalıyım?
Metinleri, prompt'ları ve avatar seçimini ayarlarken Turbo ile başlayın, ardından nihai üretimleri heygen-avatar-6 modeline gönderin. Text-to-avatar rehberi başlamak için ucuz bir yerdir.