Hunyuan API モデルガイド：TurboS Latest、Lite、Translation、3D Engine の選び方

TurboS Latest、Hunyuan-Lite、Hunyuan Translation、Hunyuan 3D Engine は、同じモデルの上位/下位グレードではない。hunyuan-turbos-latest はテキスト/チャット、Hunyuan-Lite は低コストのテキスト検証、Hunyuan Translation は翻訳ワークフロー、Hunyuan 3D Engine は非同期 3D アセット生成という別々のルートとして扱う。

実装前に、モデル名、endpoint、billing row、quota、region、翻訳対応、3D task behavior は Tencent Cloud docs とコンソールで確認する。互換プロバイダのページは、そのプロバイダの endpoint、価格、制限、ログ、サポート責任を示すだけで、Tencent 公式の価格や quota を置き換えない。latest、Lite の無料行、翻訳言語、3D output formats、TokenHub migration note、地域、provider support は本番前に再確認する。

早見ルートボード

実装判断の順番は「用途が先、モデル名が後」。モデル名から入ると、hunyuan-turbos-latest を全 Hunyuan 製品の最新代表と読んだり、Hunyuan-Lite を本番標準にしたり、Hunyuan Translation を普通の chat prompt に落とし込んだり、Hunyuan 3D Engine を text-token model のように扱ったりしやすい。

Tencent Cloud の Hunyuan product overview は、text と translation family の最初の地図になる。hunyuan-turbos-latest、hunyuan-lite、hunyuan-translation は別々の行に置かれ、input/output limits と用途が異なる。Hunyuan は multi-modal、image、video、3D なども含むため、すべてを一列の性能比較にするのは危険だ。

公式情報の持ち主を分ける

Tencent Cloud docs には Hunyuan capabilities が TokenHub 側へ移行していく注意も出る。これは実装時の小さな注記ではなく、新規開通、新機能、追加購入、既存契約の継続を分ける実務上の境界になる。古い console path が動くことと、新しい account や region で同じ route を選ぶべきことは同義ではない。

互換プロバイダのページは、provider endpoint、account model、price、rate limits、logs、retries、support、model alias を確認するための資料として読む。Tencent Cloud official pricing、quota、region behavior、translation coverage、3D output format、migration note の根拠にはならない。

hunyuan-turbos-latest：テキスト/チャットルート

一般的な text/chat workload で、OpenAI-compatible client shape を使いたい場合は hunyuan-turbos-latest が最初の候補になる。Tencent Cloud compatible-interface examples は base URL を https://api.hunyuan.cloud.tencent.com/v1 と示し、chat/completions path の sample で model: "hunyuan-turbos-latest" を使う。

最小の Python 形は次のようになる。

hljs python复制
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["HUNYUAN_API_KEY"],
    base_url="https://api.hunyuan.cloud.tencent.com/v1",
)

response = client.chat.completions.create(
    model="hunyuan-turbos-latest",
    messages=[
        {"role": "user", "content": "リリースノートを3点に要約してください。"}
    ],
    extra_body={"enable_enhancement": True},
)

print(response.choices[0].message.content)

compatible は identical ではない。Tencent は OpenAI-compatible parameters と Tencent-specific parameters を同じ文脈で説明するため、production migration では same-payload test が必要だ。streaming、enhancement flags、function calling、SDK retries、logging、timeout、error body、cost reporting の差が本番障害になる。

latest の扱いも限定する。hunyuan-turbos-latest は text/chat family の TurboS Latest alias として読むべきで、translation、3D、multimodal、image、future TokenHub route を含む全 Hunyuan 製品の永続的な最新保証ではない。

Hunyuan-Lite：低コストのテキスト検証

Hunyuan-Lite は cost-sensitive text work と early integration tests に向く。Tencent Cloud pricing page は 2026 年 5 月 8 日時点で Hunyuan-Lite を free to use としているが、その表現は現在の公式 billing row に限定する。model overview 側では Lite model として、用途と出力境界を別に確認する。

Lite を universal production default にしない。良い使い方は smoke tests、simple extraction、classification、internal tools、early prompt evaluation だ。stronger reasoning、knowledge enhancement、long customer-facing answer、complex code、higher output limit、SLA が必要なら、同じ test set を TurboS や別の official text row にも流して比較する。

無料という言い方は date-bounded にする。billing page、console setting、region、account status、service migration が変われば、古い screenshot や provider page は budget を守らない。

Hunyuan Translation：翻訳専用ルート

Hunyuan Translation は別ルートとして扱うべきだ。Tencent は hunyuan-translation を translation model/API として示しており、translation-first workload の評価指標も chat とは違う。source language、target language、segment length、glossary handling、format retention、fallback behavior、throughput、accepted translation cost を見る。

双語 product copy、document localization、support-message conversion、subtitle preparation、multilingual QA、大量の短い segment を扱う pipeline では ChatTranslations route を優先する。chat completions は、翻訳が broader reasoning の一部である場合、たとえば customer message を読み、intent を分類し、返信を作り、その返信を翻訳する場合に使いやすい。

Hunyuan 3D Engine：非同期 3D アセット pipeline

Hunyuan 3D Engine は text model variant ではない。Tencent は text、image、sketch から 3D asset を生成する platform として位置づけ、Tencent HY 3D Global docs も別 product family として auth、task submission、result retrieval を説明している。

API 形状が違うため、設計も変わる。professional 3D API は asynchronous flow で、task を submit し、JobId を受け取り、JobId で result を query する。queue、retry、status storage、timeout、asset storage、preview UI、moderation review、customer-facing failure message が必要になる。

最初の実装テストは、3D についての文章生成ではなく、小さい 3D task の submit/query にする。auth、JobId、query interval、output file、failure body、storage path、user-visible status を確認する。

互換プロバイダ経路

互換プロバイダは、OpenAI-compatible endpoint、集中課金、ログ、サポートなどで便利な場合がある。ただし契約は別物だ。provider page が示せるのは、その provider の route、price、rate limits、logs、retry behavior、support responsibility、data contract であって、Tencent official facts ではない。

production 採用前に見る項目は次の通り。

1. model alias が Tencent official model row にどう対応するか。
2. endpoint compatibility と unsupported parameters。
3. billing unit、minimum charge、retry billing、failed request behavior。
4. data handling、log retention、privacy、support responsibility。
5. Tencent official update 後に provider route が遅れる、固定される、改名される場合の fallback。

基本判断では provider recommendation は不要だ。まず official Tencent lane を決め、その後に provider convenience が operationally justified かを見る。

本番前の再確認チェックリスト

code、customer copy、budget に route を固定する前に、同じ小さな job set を使う。TurboS Latest で text/chat prompt、Lite で低コスト text sample、Translation で translation segment、3D Engine で小さな async 3D task を実行する。目的は leaderboard ではなく、それぞれが自分の仕事を完了できることの確認だ。

今確認できない情報は約束として書かない。unlimited speed、permanent free、no ban、refund guarantee、fixed SLA、all-region availability などは、現在の根拠がない限り使わない。

よくある質問

hunyuan-turbos-latest は何を指す？

Tencent Cloud の OpenAI-compatible chat/completions examples に出る Hunyuan text/chat model alias。TurboS Latest text route として扱い、全 Hunyuan product family の永続的な最新保証とは書かない。

Hunyuan-Lite は無料？

Tencent pricing page は 2026 年 5 月 8 日時点で Hunyuan-Lite を free to use としている。外部文書や production budget では、official pricing page、account state、region、console behavior を再確認してから使う。

翻訳は Hunyuan Translation と chat model のどちら？

翻訳が主目的なら Hunyuan Translation。翻訳が broader reasoning や会話ワークフローの一部なら chat completions を検討する。translation route の方が budget、monitoring、language QA を説明しやすい。

Hunyuan 3D Engine は TurboS のような API model？

違う。Hunyuan 3D Engine は async 3D asset workflow として扱う。task submit、JobId storage、result query、retry、preview、review、storage が必要だ。

provider page は Tencent official pricing の根拠になる？

ならない。provider page は provider route と commercial terms を示す。Tencent Cloud docs と console が Tencent official model names、pricing、quota、API behavior の持ち主だ。

最初にどの route をテストする？

用途から選ぶ。text/chat は TurboS Latest、cheap text checks は Lite、translation は Hunyuan Translation、3D assets は Hunyuan 3D Engine。provider-compatible route は official lane が明確になった後で比較する。