![]()
HeyGen Avatar 6 API w PoYo ma dwa ID modeli: heygen-avatar-6, czyli wariant Avatar 6 Quality od HeyGen, oraz heygen-avatar-6-turbo. Dzielą jeden endpoint, jeden format żądania i wszystkie limity, więc wybór to decyzja o kierowaniu każdego żądania pod kątem kosztu i jakości, a nie projekt integracyjny. Ta strona pokazuje, co jest takie samo, co się różni, co zmierzyliśmy, oraz regułę wyboru. Oba modele są na stronie modelu HeyGen Avatar 6.
Co jest identyczne w obu wariantach HeyGen Avatar 6 API
Dokumentacja HeyGen Avatar 6 w PoYo opisuje Turbo jako "wariant Turbo modelu Avatar 6 z tymi samymi danymi wejściowymi i trybami". Własna dokumentacja deweloperska HeyGen mówi to samo: oba modele "przyjmują te same dane wejściowe".
| Pozycja | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Endpoint | POST /api/generate/submit | Ten sam |
Tryb zdjęcia (image_urls + audio_url) | Tak | Tak |
Tryb wideo referencyjnego (video_url + audio_url) | Tak | Tak |
Tryb publicznego awatara (avatar + text/voice lub audio_url) | Tak | Tak |
| Awatary i głosy | 1,248 wyglądów, 102 głosy | Ta sama lista |
| Audio | 2–60 s, do 15 MB | To samo |
| Tekst | Do 1,000 znaków | To samo |
prompt | Do 1,200 znaków | To samo |
resolution | 1080p (domyślnie), 2K | To samo |
aspect_ratio (publiczny awatar) | 16:9, 9:16, 1:1, 4:5, 5:4 | To samo |
| Zasady rozliczeń | Sekundy zaokrąglane w górę; audio pobierane przy wysłaniu, tekst rezerwowany, a potem rozliczany | To samo |
Ponieważ w input nic się nie zmienia, treść żądania działająca na jednym modelu działa też na drugim. Zmienia się tylko ciąg model.
Co się różni: cena
1 kredyt = $0.005, za sekundę wyjścia:
| Rozdzielczość | heygen-avatar-6 | heygen-avatar-6-turbo | Oszczędność z Turbo |
|---|---|---|---|
| 1080p | 20 kredytów ($0.10) | 10 kredytów ($0.05) | 50% |
| 2K | 29 kredytów ($0.145) | 18 kredytów ($0.09) | 38% |
Cena za ten sam klip, przy zmianie tylko ID modelu:
| Klip | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| 10 s, 1080p | 200 kredytów ($1.00) | 100 kredytów ($0.50) |
| 10 s, 2K | 290 kredytów ($1.45) | 180 kredytów ($0.90) |
| 30 s, 1080p | 600 kredytów ($3.00) | 300 kredytów ($1.50) |
| 60 s, 1080p | 1,200 kredytów ($6.00) | 600 kredytów ($3.00) |
| 60 s, 2K | 1,740 kredytów ($8.70) | 1,080 kredytów ($5.40) |
Jeszcze jedno porównanie, które wpływa na kierowanie: Turbo w 2K (18 kredytów za sekundę) jest tańsze niż Avatar 6 w 1080p (20). Jeśli bardziej potrzebujesz liczby pikseli niż wariantu Quality, Turbo 2K jest tańszą drogą.
Szczegóły w artykule Cennik HeyGen Avatar 6 API.
Co się różni: jakość i szybkość według HeyGen
HeyGen nazywa warianty "Avatar 6 Quality" i "Avatar 6 Turbo" w swoim raporcie technicznym, ale nie definiuje różnicy między nimi i nie publikuje danych o opóźnieniach dla Turbo. Publikuje natomiast porównanie każdego wariantu z jego poprzednikiem: 69.7% z 879 głosów wybrało Avatar 6 Quality zamiast Avatar V, a 64.3% z 863 głosów Avatar 6 Turbo zamiast Avatar V Turbo. HeyGen nie opublikował głosowania Quality vs Turbo, więc nie ma oficjalnej liczby mówiącej, ile tracisz, wybierając Turbo.
Co zmierzyliśmy w dniu premiery
Zespół PoYo uruchomił po jednym żądaniu tekstowym na każdym modelu na produkcyjnym API 19 listopada 2026 roku. Czas to okres od wysłania do wyniku dla klienta odpytującego co kilka sekund, więc traktuj go jako przybliżony.
heygen-avatar-6-turbo | heygen-avatar-6 | |
|---|---|---|
| Awatar / głos | Abigail Office Front / Jessica Anne Bogart | Bryan Tech Expert / Andrew |
| Skrypt | 27 słów | 21 słów |
| Ustawienia | 16:9, 1080p | 16:9, 1080p |
| Długość wyniku | 10.16 s | 6.88 s |
| Koszt według obecnych cen | 110 kredytów (11 s × 10) | 140 kredytów (7 s × 20) |
| Czas | Około 2.4 min | Około 2 min |
To dwa pojedyncze przebiegi z różnymi skryptami i awatarami, więc nie pokazują, że Turbo jest szybsze lub wolniejsze. Pokazują za to różnicę kosztów w praktyce: dłuższy klip z Turbo nadal kosztował mniej niż krótszy klip z Avatar 6. Pokazują też, że oba warianty potrzebują minut, więc żaden z nich nie jest synchronicznym API, w którym czeka się na odpowiedź. W obu przypadkach zaplanuj odpytywanie lub callback_url.
Które ID modelu HeyGen Avatar 6 API wywołać
| Sytuacja | ID modelu | Dlaczego |
|---|---|---|
| Wersje robocze, przegląd skryptu i tempa | heygen-avatar-6-turbo | Połowa ceny w 1080p; te same pola, więc zatwierdzona treść żądania działa bez zmian na Avatar 6 |
| Spersonalizowane klipy w dużej skali | heygen-avatar-6-turbo | W dużej skali dominuje koszt za sekundę |
| Podglądy dla użytkowników w Twojej aplikacji | heygen-avatar-6-turbo | Tanie iteracje, gdy użytkownik próbuje awatarów i skryptów |
| Finalne wideo z prezenterem lub wideo marki | heygen-avatar-6 | Wariant Quality od HeyGen |
| Potrzebne 2K przy ograniczonym budżecie | heygen-avatar-6-turbo + 2K | 18 kredytów za sekundę, mniej niż Avatar 6 w 1080p |
| Finalny master w 2K | heygen-avatar-6 + 2K | Najwyższy wariant w najwyższej rozdzielczości |
Naturalnym rozwiązaniem jest dwuetapowy pipeline: renderuj każdą wersję roboczą na Turbo, zapisz dokładną treść żądania i wyślij zatwierdzoną treść ponownie z "model": "heygen-avatar-6". Oba żądania poniżej są identyczne poza modelem:
{
"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"
}
}
Przy wejściu tekstowym finalny render to nowa generacja, więc jego długość może nieco różnić się od wersji roboczej. Przy pliku audio oba rendery trwają tyle, co to samo audio, i kosztują dokładnie tyle, ile przewiduje tabela. Pełny przepływ żądań opisuje przewodnik po HeyGen Avatar 6 API.
Błędy i ponowienia są takie same w obu wariantach
Kierowanie między dwoma ID nie zmienia obsługi błędów. Oba zwracają te same wartości code w treści: 400 dla problemu z danymi wejściowymi (audio poza zakresem 2–60 s, nieznana nazwa awatara, pola z dwóch trybów), 402 insufficient_credits_error, gdy brakuje środków, 429 dla limitów żądań i 5xx dla przejściowych awarii. 400 na Turbo będzie też 400 na Avatar 6, więc nigdy nie "ponawiaj na drugim wariancie", żeby naprawić błąd walidacji. Zamiast tego popraw dane wejściowe.
Rezerwacje obejmują oba warianty. Zadania tekstowe na każdym z modeli blokują kredyty od wysłania do rozliczenia, a komunikat 402 sumuje je wszystkie. W naszym teście w dniu premiery, po wysłaniu zadania tekstowego na Turbo i zadania tekstowego na Avatar 6, trzecie żądanie tekstowe (Turbo, 2K) zostało odrzucone z HTTP 200 i code 402 w treści: "this request needs at least 252 credits, and 344 credits are already reserved by your unfinished HeyGen Avatar 6 text tasks." Dobieraj saldo do wszystkich trwających zadań tekstowych, niezależnie od modelu, na którym działają.
Funkcja kierowania
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 jest dokładne dla żądań z audio, które są rozliczane według zaokrąglonej w górę długości audio. Dla żądań tekstowych to tylko szacunek, bo rozliczana długość to długość gotowego wideo.
Najczęściej zadawane pytania
Czym różni się HeyGen Avatar 6 API od HeyGen Avatar 6 Turbo?
Ceną i wariantem HeyGen. Pola, tryby, limity, awatary i głosy są takie same. Turbo kosztuje 10 kredytów ($0.05) za sekundę w 1080p wobec 20 ($0.10) oraz 18 ($0.09) w 2K wobec 29 ($0.145).
Czy HeyGen Avatar 6 Turbo jest szybsze?
Raport techniczny i dokumentacja deweloperska HeyGen nie podają danych o opóźnieniach dla żadnego wariantu. W naszych dwóch przebiegach w dniu premiery oba zajęły około 2 do 2.4 minuty na krótki klip, z różnymi skryptami, więc szybkość warto zmierzyć na własnych żądaniach.
Czy mogę przejść z Turbo na Avatar 6 bez zmiany żądania?
Tak. Zmień model z heygen-avatar-6-turbo na heygen-avatar-6; wszystko w input pozostaje poprawne.
Czy HeyGen Avatar 6 Turbo obsługuje 2K?
Tak, przez "resolution": "2K", za 18 kredytów ($0.09) za sekundę.
Od którego wariantu HeyGen Avatar 6 API zacząć?
Zacznij od Turbo, dopracowując skrypty, prompty i wybór awatara, a finalne rendery wysyłaj do heygen-avatar-6. Poradnik text-to-avatar to tani punkt startowy.