guides

HeyGen Avatar 6 API: czym jest HeyGen Avatar 6, ID modeli, tryby wejścia, limity i cena

Poyo.ai Team
8 min read
Share:

HeyGen Avatar 6 API w PoYo: ID modeli, tryby wejścia, limity i cena

HeyGen Avatar 6 API jest dostępne w PoYo pod dwoma ID modeli: heygen-avatar-6 oraz heygen-avatar-6-turbo w wariancie Turbo, za połowę ceny w 1080p. Oba zamieniają zdjęcie, wideo referencyjne z animowaną postacią albo jeden z 1,248 publicznych wyglądów awatarów HeyGen w mówiący plik MP4 z synchronizacją ruchu warg, w 1080p lub 2K, sterowany Twoim audio albo, w przypadku publicznych awatarów, tekstem. Oba warianty możesz wypróbować na stronie modelu HeyGen Avatar 6, zanim napiszesz kod.

Ten przegląd opisuje, co wypuścił HeyGen, format żądania w PoYo, limity, które Twój kod musi sprawdzać, cenę za sekundę i to, co zmierzyliśmy w dniu premiery.

Czym jest HeyGen Avatar 6?

HeyGen Avatar 6 to model wideo HeyGen do mówiących awatarów. Raport techniczny HeyGen z 17 listopada 2026 roku mówi, że "Avatar 6 odtwarza, jak osoba wygląda, mówi i się porusza, w rozdzielczości do 2K", oraz że działa "na podstawie jednego zdjęcia". HeyGen opisuje dwa warianty, Avatar 6 Quality i Avatar 6 Turbo; w PoYo to heygen-avatar-6 i heygen-avatar-6-turbo.

DataCo się wydarzyło
17 listopada 2026HeyGen publikuje raport techniczny Avatar 6
19 listopada 2026Oba warianty dostępne w PoYo jako heygen-avatar-6 i heygen-avatar-6-turbo

Trzy deklaracje HeyGen mają znaczenie dla integracji, bo przekładają się na pola żądania:

  • Natywne 2K. HeyGen podaje, że "każda klatka [jest] generowana w 2880×1620". W PoYo wybierasz to przez "resolution": "2K".
  • Prompty ruchu. Raport HeyGen mówi: "Wpisz akcję obok słów. Avatar 6 wykona ją dokładnie we właściwym momencie." W PoYo służy do tego pole prompt, do 1,200 znaków.
  • Przewaga nad Avatar V. W internetowym głosowaniu HeyGen 69.7% z 879 głosów wskazało Avatar 6 Quality zamiast Avatar V, a 64.3% z 863 głosów Avatar 6 Turbo zamiast Avatar V Turbo. To własne dane HeyGen.

HeyGen Avatar 6 API w skrócie

Pozycjaheygen-avatar-6heygen-avatar-6-turbo
Wariant HeyGenAvatar 6 QualityAvatar 6 Turbo
Endpoint do wysyłaniaPOST https://api.poyo.ai/api/generate/submitTen sam
WynikGET /api/generate/status/{task_id} lub callback_urlTen sam
Tryby wejściaZdjęcie, wideo referencyjne, publiczny awatarTe same trzy
WyjścieJeden plik MP4, 1080p (domyślnie) lub 2KTo samo
Wejście mowyAudio 2–60 s albo tekst do 1,000 znaków (tylko publiczny awatar)To samo
Cena, 1080p20 kredytów ($0.10) za sekundę10 kredytów ($0.05) za sekundę
Cena, 2K29 kredytów ($0.145) za sekundę18 kredytów ($0.09) za sekundę

Pola żądania są identyczne, więc zmiana wariantu oznacza tylko zmianę ciągu model. Zasady dla poszczególnych pól są w dokumentacji PoYo dla HeyGen Avatar 6.

Trzy tryby wejścia, jeden endpoint

Nie ma pola mode. Tryb wybierają przesłane dane wejściowe, w tej kolejności:

TrybWybierany, gdyDane wejścioweProporcje obrazu
Publiczny awatarJest avataravatar + text (+ opcjonalnie voice) albo avatar + audio_urlaspect_ratio: 16:9 (domyślnie), 9:16, 1:1, 4:5, 5:4
Wideo referencyjneJest video_url (i nie ma avatar)video_url + audio_url, opcjonalnie jedno zdjęcie w image_urlsZgodne z wideo wejściowym
ZdjęcieDomyślnieimage_urls (dokładnie jedno) + audio_urlZgodne ze zdjęciem wejściowym

prompt i resolution działają w każdym trybie. aspect_ratio i voice należą tylko do trybu publicznego awatara. W jednym żądaniu wysyłaj dane wejściowe jednego trybu. Własna dokumentacja deweloperska HeyGen dzieli tę pracę na dwa osobne API (API modelu dla obrazu lub wideo plus audio oraz API aplikacji dla wyglądów awatarów HeyGen); w PoYo to jeden kształt żądania dla obu.

Tryb wideo referencyjnego jest przeznaczony dla animowanych lub rysowanych postaci. Dla prawdziwej osoby użyj trybu zdjęcia z jednym zdjęciem.

Limity do sprawdzenia przed wysłaniem

PoleZasada
image_urlsDokładnie jeden URL; używany jest image_urls[0]
video_urlCo najmniej 2 sekundy, do 50 MB
audio_url2–60 sekund, do 15 MB; wideo trwa tyle, co audio
text1–1,000 znaków (tryb publicznego awatara, zamiast audio_url)
avatarJedna z 1,248 nazw (156 osób); wielkość liter i dodatkowe spacje są ignorowane
voiceJedna ze 102 nazw; domyślnie Warm Pro Narrator
promptDo 1,200 znaków
resolution1080p lub 2K

Wszystkie adresy URL multimediów muszą być publiczne i bezpośrednio pobieralne przez HTTP lub HTTPS. PoYo sprawdza długość audio, długość wideo referencyjnego i nazwę awatara przy wysyłaniu, więc błędne dane wejściowe kończą się błędem od razu, a nie po czasie oczekiwania. Wynik może być o około jedną dziesiątą sekundy krótszy niż audio. Wszystkie nazwy awatarów i głosów są w Avatars and Voices, razem z katalogiem JSON do pobrania.

Cennik HeyGen Avatar 6 API w PoYo

PoYo nalicza opłaty za każdą sekundę wyjścia w kredytach (1 kredyt = $0.005):

Model1080p za sekundę2K za sekundę10 s w 1080p60 s w 1080p
heygen-avatar-6-turbo10 kredytów ($0.05)18 kredytów ($0.09)100 kredytów ($0.50)600 kredytów ($3.00)
heygen-avatar-620 kredytów ($0.10)29 kredytów ($0.145)200 kredytów ($1.00)1,200 kredytów ($6.00)

Rozliczane sekundy są zaokrąglane w górę do pełnych sekund. Przy audio_url opłata zależy od długości audio i jest pobierana przy wysłaniu. Przy text PoYo rezerwuje kredyty przy wysłaniu i rozlicza je według długości gotowego wideo po zakończeniu zadania. Pełne zestawienie z przykładami obliczeń znajdziesz w artykule Cennik HeyGen Avatar 6 API.

Wyniki testów z dnia premiery

Zespół PoYo przeprowadził te testy na produkcyjnym API 19 listopada 2026 roku, w trybie publicznego awatara z tekstem. Czas to okres od wysłania do wyniku widziany przez klienta odpytującego status, więc traktuj go jako przybliżony.

ModelAwatar / głosSkryptWynikKoszt według obecnych cenCzas
heygen-avatar-6-turboAbigail Office Front / Jessica Anne Bogart27 słów, 16:9, 1080p10.16 s110 kredytów (11 s × 10)Około 2.4 min
heygen-avatar-6Bryan Tech Expert / Andrew21 słów, 16:9, 1080p6.88 s140 kredytów (7 s × 20)Około 2 min

Dwie minuty lub więcej na krótki klip oznaczają, że to API asynchroniczne: wyślij żądanie, zachowaj task_id i odpytuj status albo odbierz callback. Nie trzymaj otwartego żądania HTTP użytkownika, dopóki zadanie trwa.

HeyGen Avatar 6 API: szybki start

To przykład z dokumentacji dla trybu publicznego awatara z tekstem:

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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"
    }
  }'

Sprawdź code w treści odpowiedzi (musi wynosić 200), zapisz data.task_id, a potem wywołuj GET https://api.poyo.ai/api/generate/status/{task_id}, aż status będzie finished, i odczytaj MP4 z data.files[].file_url. Wygenerowane wideo jest dostępne przez 3 dni, więc skopiuj je do własnego magazynu. Tryb zdjęcia, tryb wideo referencyjnego, ograniczoną pętlę w Pythonie i obsługę błędów opisuje przewodnik po HeyGen Avatar 6 API.

Które żądania pasują do HeyGen Avatar 6 API

PotrzebujeszWywołanie
Wideo z prezenterem ze skryptu, bez pliku audioheygen-avatar-6 lub -turbo w trybie publicznego awatara (poradnik text-to-avatar)
Zdjęcie prawdziwej osoby wypowiadającej Twoje audio, w 1080p lub 2KTryb zdjęcia
Mówiąca maskotka lub postać z kreskówkiTryb wideo referencyjnego
Wersje robocze, podglądy, duży wolumenheygen-avatar-6-turbo (zobacz Avatar 6 vs Turbo)
Najniższa cena za sekundę ze zdjęcia i audioPorównaj z Kling Avatar 2.0
Audio dłuższe niż 60 sekundOmniHuman 2.0 przyjmuje 4–300 s audio w 720p, 21 kredytów za sekundę

Najczęściej zadawane pytania

Jakie są ID modeli HeyGen Avatar 6 API?

heygen-avatar-6 (wariant Avatar 6 Quality od HeyGen) i heygen-avatar-6-turbo. Oba używają POST https://api.poyo.ai/api/generate/submit z tymi samymi polami input.

Ile kosztuje HeyGen Avatar 6 API?

W PoYo, za sekundę wyjścia: Turbo 10 kredytów ($0.05) w 1080p i 18 kredytów ($0.09) w 2K; Avatar 6 20 kredytów ($0.10) w 1080p i 29 kredytów ($0.145) w 2K. Sekundy są zaokrąglane w górę.

Czy HeyGen Avatar 6 API może zrobić wideo tylko z tekstu?

Tak, w trybie publicznego awatara. Wyślij avatar i do 1,000 znaków text, plus opcjonalnie voice spośród 102 dostępnych głosów. Tryby zdjęcia i wideo referencyjnego wymagają audio_url.

Jak długie może być wideo z HeyGen Avatar 6 API?

Z audio 2–60 sekund, tyle co audio. Z tekstem wideo trwa tyle, ile awatarowi zajmie przeczytanie do 1,000 znaków.

Jakie rozdzielczości obsługuje HeyGen Avatar 6 API?

1080p (domyślnie) i 2K. Tryb publicznego awatara dodaje aspect_ratio (16:9, 9:16, 1:1, 4:5, 5:4); pozostałe tryby zachowują proporcje danych wejściowych.

Czy HeyGen Avatar 6 API obsługuje webhooki?

Tak. Dodaj callback_url na najwyższym poziomie żądania, a PoYo wyśle wynik zadania, gdy będzie finished lub failed. Możesz też odpytywać endpoint statusu.

Share: