![]()
PoYoのHeyGen Avatar 6 APIには2つのモデルIDがあります。HeyGenのAvatar 6 Qualityティアであるheygen-avatar-6と、heygen-avatar-6-turboです。エンドポイント、リクエスト形式、すべての制限が共通なので、どちらを選ぶかは統合作業ではなく、コストと品質に関するリクエストごとの振り分けの判断です。このページでは、何が同じで何が違うのか、何を計測したのか、そして選び方のルールを示します。どちらもHeyGen Avatar 6モデルページにあります。
HeyGen Avatar 6 APIの2つのティアで同じもの
PoYoのHeyGen Avatar 6ドキュメントはTurboを「同じ入力とモードを持つAvatar 6のTurboティア」と説明しています。HeyGen自身の開発者ドキュメントも同様に、両モデルは「同じ入力を受け付ける」としています。
| 項目 | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| エンドポイント | POST /api/generate/submit | 同じ |
写真モード(image_urls + audio_url) | あり | あり |
参照動画モード(video_url + audio_url) | あり | あり |
パブリックアバターモード(avatar + text/voice または audio_url) | あり | あり |
| アバターとボイス | 1,248ルック、102ボイス | 同じリスト |
| 音声 | 2〜60秒、最大15 MB | 同じ |
| テキスト | 最大1,000文字 | 同じ |
prompt | 最大1,200文字 | 同じ |
resolution | 1080p(デフォルト)、2K | 同じ |
aspect_ratio(パブリックアバター) | 16:9、9:16、1:1、4:5、5:4 | 同じ |
| 課金ルール | 秒数は切り上げ。音声は送信時に課金、テキストは予約後に精算 | 同じ |
inputの中身は何も変わらないので、一方のモデルで動くリクエスト本文はもう一方でも動きます。切り替えはmodel文字列だけです。
違い:料金
1クレジット = $0.005、出力1秒あたり:
| 解像度 | heygen-avatar-6 | heygen-avatar-6-turbo | Turboの節約率 |
|---|---|---|---|
| 1080p | 20クレジット($0.10) | 10クレジット($0.05) | 50% |
| 2K | 29クレジット($0.145) | 18クレジット($0.09) | 38% |
モデルIDだけを変えた場合の、同じクリップでの料金:
| クリップ | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| 10秒、1080p | 200クレジット($1.00) | 100クレジット($0.50) |
| 10秒、2K | 290クレジット($1.45) | 180クレジット($0.90) |
| 30秒、1080p | 600クレジット($3.00) | 300クレジット($1.50) |
| 60秒、1080p | 1,200クレジット($6.00) | 600クレジット($3.00) |
| 60秒、2K | 1,740クレジット($8.70) | 1,080クレジット($5.40) |
振り分けに影響する比較がもう1つあります。2KのTurbo(1秒あたり18クレジット)は1080pのAvatar 6(20)より安価です。Qualityティアよりもピクセル数が必要なら、Turbo 2Kのほうが安く手に入ります。
詳細はHeyGen Avatar 6 API料金をご覧ください。
違い:HeyGenの説明による品質と速度
HeyGenはテクニカルレポートでティアを「Avatar 6 Quality」と「Avatar 6 Turbo」と名付けていますが、両者の違いを定義しておらず、Turboのレイテンシの数値も公開していません。公開されているのは、各ティアをそれぞれの前身と比べた結果です。879票中69.7%がAvatar VよりAvatar 6 Qualityを、863票中64.3%がAvatar V TurboよりAvatar 6 Turboを選びました。HeyGenはQualityとTurboを比べた投票を公開していないため、Turboで何を失うかについての公式な数値はありません。
ローンチ当日に計測したこと
PoYoチームは2026年11月19日、本番APIで各モデルにテキストリクエストを1回ずつ実行しました。所要時間は数秒ごとにポーリングするクライアントから見た送信から結果までの時間なので、目安として扱ってください。
heygen-avatar-6-turbo | heygen-avatar-6 | |
|---|---|---|
| アバター / ボイス | Abigail Office Front / Jessica Anne Bogart | Bryan Tech Expert / Andrew |
| スクリプト | 27語 | 21語 |
| 設定 | 16:9、1080p | 16:9、1080p |
| 出力の長さ | 10.16秒 | 6.88秒 |
| 現行料金での費用 | 110クレジット(11秒 × 10) | 140クレジット(7秒 × 20) |
| 所要時間 | 約2.4分 | 約2分 |
これはスクリプトもアバターも異なる1回ずつの実行なので、Turboが速いか遅いかを示すものではありません。ただし、実際のコスト差は示しています。長いほうのTurboクリップでも、短いほうのAvatar 6クリップより安くなりました。また、どちらのティアも数分かかるので、どちらもリクエスト上で待つ同期型APIではないことがわかります。いずれの場合もポーリングかcallback_urlを前提にしてください。
どのHeyGen Avatar 6 APIモデルIDを呼び出すか
| 状況 | モデルID | 理由 |
|---|---|---|
| 下書き、スクリプトやタイミングの確認 | heygen-avatar-6-turbo | 1080pで半額。フィールドが同じなので、承認済みの本文をそのままAvatar 6で再実行できる |
| 大量のパーソナライズクリップ | heygen-avatar-6-turbo | 規模が大きいと秒単価が支配的になる |
| アプリ内でのユーザーのプレビュー | heygen-avatar-6-turbo | ユーザーがアバターやスクリプトを試す間、安く反復できる |
| 最終的なプレゼンター動画やブランド動画 | heygen-avatar-6 | HeyGenのQualityティア |
| 予算内で2Kが必要 | heygen-avatar-6-turbo + 2K | 1秒あたり18クレジットで、1080pのAvatar 6より安い |
| 最終的な2Kマスター | heygen-avatar-6 + 2K | 最上位ティアで最高解像度 |
自然に合うのは2段階のパイプラインです。すべての下書きをTurboでレンダリングし、正確なリクエスト本文を保存しておき、承認された本文を"model": "heygen-avatar-6"で再送信します。以下の2つのリクエストは、モデル以外は同一です。
{
"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"
}
}
テキスト入力の場合、最終レンダリングは新たな生成なので、長さが下書きとわずかに異なることがあります。音声ファイルの場合は、どちらのレンダリングも同じ音声の長さになり、費用は表の予測どおりになります。リクエストの流れ全体はHeyGen Avatar 6 APIガイドをご覧ください。
エラーと再試行は両ティアで同じ
2つのIDの間で振り分けても、エラー処理は変わりません。どちらも同じ本文codeの値を返します。入力の問題(2〜60秒の範囲外の音声、不明なアバター名、2つのモードのフィールド)には400、残高不足には402 insufficient_credits_error、レート制限には429、一時的な障害には5xxです。Turboで400になるものはAvatar 6でも400になるので、検証エラーを直すために「別のティアで再試行」は決してしないでください。入力を修正してください。
予約は両ティアにまたがって適用されます。どちらのモデルのテキストタスクも送信から精算までクレジットを確保し、402のメッセージはそれらすべてを合算して数えます。ローンチ当日のテストでは、TurboのテキストタスクとAvatar 6のテキストタスクを送信した後、3つ目のテキストリクエスト(Turbo、2K)がHTTP 200、本文code 402で拒否されました。メッセージは「this request needs at least 252 credits, and 344 credits are already reserved by your unfinished HeyGen Avatar 6 text tasks.」です。どちらのモデルで実行されるかにかかわらず、実行中のすべてのテキストタスクを見込んで残高を確保してください。
振り分け関数
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は、切り上げた音声の長さで課金される音声リクエストでは正確です。テキストリクエストでは課金される長さが完成動画で決まるため、あくまで見積もりです。
よくある質問
HeyGen Avatar 6 APIとHeyGen Avatar 6 Turboの違いは何ですか?
料金とHeyGenのティアです。フィールド、モード、制限、アバター、ボイスは同じです。Turboは1080pで1秒あたり10クレジット($0.05)対20($0.10)、2Kで18($0.09)対29($0.145)です。
HeyGen Avatar 6 Turboのほうが速いですか?
HeyGenのテクニカルレポートと開発者ドキュメントは、どちらのティアのレイテンシの数値も公開していません。ローンチ当日の2回の実行では、異なるスクリプトで、どちらも短いクリップに約2〜2.4分かかりました。速度は自分のリクエストで計測するものとして扱ってください。
リクエストを変えずにTurboからAvatar 6に切り替えられますか?
はい。modelをheygen-avatar-6-turboからheygen-avatar-6に変えるだけで、inputの中身はすべてそのまま有効です。
HeyGen Avatar 6 Turboは2Kに対応していますか?
はい。"resolution": "2K"で、1秒あたり18クレジット($0.09)です。
どのHeyGen Avatar 6 APIティアから始めるべきですか?
スクリプト、プロンプト、アバターの選択を調整する間はTurboで始め、最終レンダリングをheygen-avatar-6に送ってください。テキストからアバターへのウォークスルーは、安く始めるのに最適です。