comparisons

HeyGen Avatar 6 API vs Turbo:どのモデルIDを呼び出すべきか

Poyo.ai Team
3 min read
Share:

HeyGen Avatar 6 API vs Turbo:どのモデルIDを呼び出すべきか

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-6heygen-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文字同じ
resolution1080p(デフォルト)、2K同じ
aspect_ratio(パブリックアバター)16:9、9:16、1:1、4:5、5:4同じ
課金ルール秒数は切り上げ。音声は送信時に課金、テキストは予約後に精算同じ

inputの中身は何も変わらないので、一方のモデルで動くリクエスト本文はもう一方でも動きます。切り替えはmodel文字列だけです。

違い:料金

1クレジット = $0.005、出力1秒あたり:

解像度heygen-avatar-6heygen-avatar-6-turboTurboの節約率
1080p20クレジット($0.10)10クレジット($0.05)50%
2K29クレジット($0.145)18クレジット($0.09)38%

モデルIDだけを変えた場合の、同じクリップでの料金:

クリップheygen-avatar-6heygen-avatar-6-turbo
10秒、1080p200クレジット($1.00)100クレジット($0.50)
10秒、2K290クレジット($1.45)180クレジット($0.90)
30秒、1080p600クレジット($3.00)300クレジット($1.50)
60秒、1080p1,200クレジット($6.00)600クレジット($3.00)
60秒、2K1,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-turboheygen-avatar-6
アバター / ボイスAbigail Office Front / Jessica Anne BogartBryan Tech Expert / Andrew
スクリプト27語21語
設定16:9、1080p16: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-turbo1080pで半額。フィールドが同じなので、承認済みの本文をそのままAvatar 6で再実行できる
大量のパーソナライズクリップheygen-avatar-6-turbo規模が大きいと秒単価が支配的になる
アプリ内でのユーザーのプレビューheygen-avatar-6-turboユーザーがアバターやスクリプトを試す間、安く反復できる
最終的なプレゼンター動画やブランド動画heygen-avatar-6HeyGenのQualityティア
予算内で2Kが必要heygen-avatar-6-turbo + 2K1秒あたり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に送ってください。テキストからアバターへのウォークスルーは、安く始めるのに最適です。

Share: