Hunyuan API: как выбрать TurboS Latest, Lite, Translation и 3D Engine

TurboS Latest, Hunyuan-Lite, Hunyuan Translation и Hunyuan 3D Engine нельзя читать как четыре уровня одной модели. Это четыре разные рабочие линии Tencent Hunyuan: hunyuan-turbos-latest подходит для текста и чата, Hunyuan-Lite для дешевых текстовых проверок, Hunyuan Translation для задач перевода, а Hunyuan 3D Engine для асинхронной генерации 3D-активов.

Официальные документы Tencent Cloud и консоль отвечают за имена моделей, endpoint, billing rows, квоты, регионы, язык перевода и поведение 3D задач. Страница совместимого провайдера полезна только для оценки его собственного endpoint, цены, лимитов, логов и поддержки. Любые утверждения про latest, бесплатность Lite, стоимость токенов, покрытие языков, форматы 3D, регион, квоту или provider support нужно перепроверять перед публикацией или продакшеном.

Быстрая карта маршрутов

Надежный порядок решения: сначала работа, потом имя модели. Если начать с названия, легко переоценить строку. hunyuan-turbos-latest является текстовым/chat alias, Hunyuan-Lite отдельной дешевой текстовой моделью, Hunyuan Translation специализированным переводческим маршрутом, а Hunyuan 3D Engine системой генерации файловых 3D-активов с submit/query lifecycle.

Tencent Cloud model overview дает первую карту для text и translation family. В нем hunyuan-turbos-latest, hunyuan-lite и hunyuan-translation стоят в разных строках, с разными input/output limits и разными job descriptions. Это защищает от ошибочного ранжирования, где все Hunyuan names превращаются в один список "лучше/хуже".

Карта официальных источников

Tencent Cloud также указывает platform note вокруг migration toward TokenHub. Для внедрения это важнее, чем кажется: старый console path может продолжать работать, но новая активация, новые capabilities или новая покупка должны проверяться по актуальной официальной странице. Working request не является доказательством, что route будет правильным для нового account, region или billing mode.

Provider page читается иначе. Она может показать endpoint, account model, price, rate limits, logs, retries, support and model alias у конкретного провайдера. Она не может менять Tencent Cloud pricing, отменять Tencent quota, доказывать поддержку языка или обещать официальный output format для 3D.

hunyuan-turbos-latest: text и chat route

Используйте hunyuan-turbos-latest, когда задача похожа на обычный text/chat workload и важна форма OpenAI-compatible client. Tencent Cloud compatible-interface examples показывают base URL https://api.hunyuan.cloud.tencent.com/v1, полный chat/completions path и sample с model: "hunyuan-turbos-latest".

Минимальный Python shape выглядит знакомо:

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": "Суммируй release note в три пункта."}
    ],
    extra_body={"enable_enhancement": True},
)

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

Слово compatible не означает identical. Tencent описывает OpenAI-compatible parameters и Tencent-specific parameters рядом. Перед production swap нужен same-payload test: streaming behavior, enhancement flags, function calling, SDK retries, timeout, logging, error body и cost reporting. Если приложение зависит от этих деталей, "endpoint похож" недостаточно.

latest тоже нельзя расширять. В model overview hunyuan-turbos-latest является текущим TurboS alias со своей строкой и limit. Это route внутри text/chat family, не обещание, что он будет newest or strongest Hunyuan across translation, 3D, multimodal, image или future TokenHub routes.

Hunyuan-Lite: дешевые текстовые проверки

Hunyuan-Lite подходит для cost-sensitive text work и ранних integration tests. Tencent Cloud pricing page, checked on May 8, 2026, lists Hunyuan-Lite as free to use; model overview describes it as a Lite text model with its own context and output constraints.

Это не universal production default. Lite хороший первый шаг для smoke tests, simple extraction, classification, internal tools и early prompt evaluation. Если работа требует stronger reasoning, knowledge enhancement, long final answer, customer-visible reliability или более сложных features, держите тот же test set и сравните TurboS или другую official text row.

Фраза "free" должна оставаться date-bounded. Если billing page, console setting, region, account status или service migration changes, old provider pages and screenshots do not protect the budget.

Hunyuan Translation: переводческий route

Hunyuan Translation заслуживает отдельного маршрута, потому что Tencent documents hunyuan-translation as translation model and API surface. Для переводческой системы полезные проверки другие: source language, target language, segment length, glossary handling, formatting, fallback behavior, throughput and cost per accepted translation.

Выбирайте Translation route для bilingual product copy, document localization, support-message conversion, subtitle or transcript preparation, multilingual QA и pipelines с большим числом коротких segments. Chat completions уместен, когда translation is one step inside broader reasoning, например read customer message, classify intent, generate answer and translate it. Если задача только high-volume translation, отдельный translation API легче мониторить и объяснять.

Hunyuan 3D Engine: async asset pipeline

Hunyuan 3D Engine не является text model variant. Tencent positions it as a 3D asset generation platform for text, image and sketch prompts. International Tencent HY 3D docs put it under a separate documentation family, with auth, task submission and result retrieval different from chat/completions.

API shape меняет архитектуру. Professional 3D API is asynchronous: submit a task, receive JobId, then query result with JobId. That requires queue design, retry policy, status storage, timeout, asset storage, preview UI, moderation review and customer-facing failure messages. A text response can be retried inline; a 3D file workflow needs a durable job record.

Первый продакшен-тест должен быть маленьким asset job, not a chat prompt about 3D. Проверьте auth, JobId, query interval, output file, failure body, storage path and user-visible status.

Provider-compatible routes

Совместимый провайдер может быть удобным, если нужна familiar OpenAI-compatible endpoint, быстрый test route или centralized billing. Но это отдельный contract. Его page can prove only that provider's route, not Tencent official facts.

Перед production use проверьте:

1. Exact model alias and whether it maps to a Tencent model row.
2. Endpoint compatibility and unsupported parameters.
3. Billing unit, minimum charge, retry billing and failed-request behavior.
4. Data handling, log retention, privacy and support responsibility.
5. Fallback plan if provider route lags behind Tencent official updates.

No provider recommendation is needed for the basic route decision. Identify the official Tencent lane first; then decide if provider convenience is worth the extra contract boundary.

Production recheck checklist

Use the same small job set before committing docs, code or budget: one chat prompt on TurboS Latest, one cheap text sample on Lite, one translation segment through ChatTranslations, and one small 3D async job. The aim is not a leaderboard; the aim is proving each route can finish its own job.

If a claim cannot be confirmed now, do not write it as a promise. Avoid unlimited speed, permanent free access, no-ban claims, refund guarantees, fixed SLA or all-region availability unless current evidence supports that exact statement.

Часто задаваемые вопросы

Что означает hunyuan-turbos-latest?

It is a Tencent Cloud Hunyuan text/chat model alias shown in OpenAI-compatible chat/completions examples. Treat it as the TurboS Latest route for text/chat, not as a permanent newest claim across all Hunyuan product families.

Hunyuan-Lite бесплатен?

Tencent pricing page, checked on May 8, 2026, lists Hunyuan-Lite as free to use. Keep that statement dated and source-bounded; recheck official pricing, account state, region and console behavior before external use.

Translation route или chat model для перевода?

Use Hunyuan Translation when translation is the job. Use chat completions when translation is part of broader reasoning or conversation. Separate translation route is easier to budget, monitor and validate.

Hunyuan 3D Engine похож на TurboS API model?

No. Treat Hunyuan 3D Engine as an async 3D asset workflow with job submission, JobId storage, result query, retries, preview, review and storage.

Может ли provider page доказать Tencent official pricing?

No. Provider page proves provider route and commercial terms. Tencent Cloud docs and console own Tencent official model names, pricing, quota and API behavior.

Какой маршрут тестировать первым?

Start from the job: TurboS Latest for text/chat, Lite for cheap text checks, Hunyuan Translation for translation, and Hunyuan 3D Engine for 3D assets. Compare a compatible provider only after the official lane is clear.