![]()
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.
| Data | Co się wydarzyło |
|---|---|
| 17 listopada 2026 | HeyGen publikuje raport techniczny Avatar 6 |
| 19 listopada 2026 | Oba 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
| Pozycja | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Wariant HeyGen | Avatar 6 Quality | Avatar 6 Turbo |
| Endpoint do wysyłania | POST https://api.poyo.ai/api/generate/submit | Ten sam |
| Wynik | GET /api/generate/status/{task_id} lub callback_url | Ten sam |
| Tryby wejścia | Zdjęcie, wideo referencyjne, publiczny awatar | Te same trzy |
| Wyjście | Jeden plik MP4, 1080p (domyślnie) lub 2K | To samo |
| Wejście mowy | Audio 2–60 s albo tekst do 1,000 znaków (tylko publiczny awatar) | To samo |
| Cena, 1080p | 20 kredytów ($0.10) za sekundę | 10 kredytów ($0.05) za sekundę |
| Cena, 2K | 29 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:
| Tryb | Wybierany, gdy | Dane wejściowe | Proporcje obrazu |
|---|---|---|---|
| Publiczny awatar | Jest avatar | avatar + text (+ opcjonalnie voice) albo avatar + audio_url | aspect_ratio: 16:9 (domyślnie), 9:16, 1:1, 4:5, 5:4 |
| Wideo referencyjne | Jest video_url (i nie ma avatar) | video_url + audio_url, opcjonalnie jedno zdjęcie w image_urls | Zgodne z wideo wejściowym |
| Zdjęcie | Domyślnie | image_urls (dokładnie jedno) + audio_url | Zgodne 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
| Pole | Zasada |
|---|---|
image_urls | Dokładnie jeden URL; używany jest image_urls[0] |
video_url | Co najmniej 2 sekundy, do 50 MB |
audio_url | 2–60 sekund, do 15 MB; wideo trwa tyle, co audio |
text | 1–1,000 znaków (tryb publicznego awatara, zamiast audio_url) |
avatar | Jedna z 1,248 nazw (156 osób); wielkość liter i dodatkowe spacje są ignorowane |
voice | Jedna ze 102 nazw; domyślnie Warm Pro Narrator |
prompt | Do 1,200 znaków |
resolution | 1080p 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):
| Model | 1080p za sekundę | 2K za sekundę | 10 s w 1080p | 60 s w 1080p |
|---|---|---|---|---|
heygen-avatar-6-turbo | 10 kredytów ($0.05) | 18 kredytów ($0.09) | 100 kredytów ($0.50) | 600 kredytów ($3.00) |
heygen-avatar-6 | 20 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.
| Model | Awatar / głos | Skrypt | Wynik | Koszt według obecnych cen | Czas |
|---|---|---|---|---|---|
heygen-avatar-6-turbo | Abigail Office Front / Jessica Anne Bogart | 27 słów, 16:9, 1080p | 10.16 s | 110 kredytów (11 s × 10) | Około 2.4 min |
heygen-avatar-6 | Bryan Tech Expert / Andrew | 21 słów, 16:9, 1080p | 6.88 s | 140 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
| Potrzebujesz | Wywołanie |
|---|---|
| Wideo z prezenterem ze skryptu, bez pliku audio | heygen-avatar-6 lub -turbo w trybie publicznego awatara (poradnik text-to-avatar) |
| Zdjęcie prawdziwej osoby wypowiadającej Twoje audio, w 1080p lub 2K | Tryb zdjęcia |
| Mówiąca maskotka lub postać z kreskówki | Tryb wideo referencyjnego |
| Wersje robocze, podglądy, duży wolumen | heygen-avatar-6-turbo (zobacz Avatar 6 vs Turbo) |
| Najniższa cena za sekundę ze zdjęcia i audio | Porównaj z Kling Avatar 2.0 |
| Audio dłuższe niż 60 sekund | OmniHuman 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.