how-tos

HeyGen Avatar 6 API Text to Avatar: Ses Dosyası Olmadan Metinden Sunucu Videoları

Poyo.ai Team
8 min read
Share:

HeyGen Avatar 6 API text to avatar: metinden bir sunucu videosu

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"
  }
}
AlanZorunluKural
avatarEvet1,248 görünüm adından biri
textEvet (audio_url yerine)1–1,000 karakter
voiceHayır102 addan biri; varsayılan Warm Pro Narrator
promptHayırEn fazla 1,200 karakter yönlendirme
aspect_ratioHayır16:9 (varsayılan), 9:16, 1:1, 4:5, 5:4
resolutionHayır1080p (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
modelsheygen-avatar-6, heygen-avatar-6-turbo (aynı adlar ikisinde de çalışır)
default_voiceWarm Pro Narrator
avatars1,248 görünüm adının tamamı, düz liste
avatars_by_personAynı görünümler, 156 kişi altında gruplanmış
voices102 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 sunucuFrontAbigail Office Front, Bryan Suit Front
Dörtte üç açıSideAbigail Office Side
Oturarak, gündelikSofa, Sitting, LoungeAnnie Sofa Sitting Front
Bir rol veya ortamDoctor, Nurse, Yoga, Tech ExpertAnn 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, Hope ile Hope (sonunda boşluk olan) sesinin iki farklı ses olduğunu vurguluyor. Archer , Cassidy , Adam Stone , Spuds Oxley ve Andrew Rizz da 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 😊 veya Brenda - 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 Expert ile Andrew, Abigail Office Front ile Jessica Anne Bogart eş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 text iç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 prompt alanı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 yeriaspect_ratio
Web sitesi, YouTube, LMS dersi16:9 (varsayılan)
Shorts, Reels, TikTok, hikâyeler9:16
Kare akış gönderisi, uygulama içi kart1:1
Dikey akış gönderisi4:5
Yatay akış gönderisi5: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):

ModelAvatar / sesMetinÇıktıGüncel fiyatlarla maliyetSüre
heygen-avatar-6-turboAbigail Office Front / Jessica Anne Bogart27 kelime10.16 s110 kredi ($0.55)Yaklaşık 2.4 min
heygen-avatar-6Bryan Tech Expert / Andrew21 kelime6.88 s140 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.

Share: