Guía de modelos Hunyuan API: TurboS Latest, Lite, Translation y 3D Engine
TurboS Latest, Hunyuan-Lite, Hunyuan Translation y Hunyuan 3D Engine no son cuatro niveles de un mismo modelo. Son cuatro rutas de Tencent Hunyuan: hunyuan-turbos-latest para texto y chat, Hunyuan-Lite para pruebas de texto de bajo coste, Hunyuan Translation para flujos de traducción y Hunyuan 3D Engine para generación asíncrona de activos 3D.
Antes de implementar, trata la documentación y la consola de Tencent Cloud como fuente oficial para nombres de modelo, endpoints, filas de precio, cuotas, regiones, cobertura de traducción y comportamiento de tareas 3D. Una página de proveedor compatible solo demuestra su propio endpoint, precio, límites, logs y soporte. Cualquier afirmación sobre latest, gratuidad de Lite, precios, idiomas, formatos 3D, migración a TokenHub, regiones o cuotas debe revisarse con la fuente vigente antes de producción.
| Trabajo | Ruta Hunyuan inicial | Hecho oficial que conviene revisar |
|---|---|---|
| Texto general, chat, resumen, asistencia de código, cliente OpenAI-compatible | hunyuan-turbos-latest por Tencent Cloud OpenAI-compatible chat/completions | visión general del modelo, ejemplos compatibles, disponibilidad de consola, parámetros Tencent |
| Smoke tests baratos, clasificación, extracción, validación interna de prompts | Hunyuan-Lite | fila actual de precio/gratis, límite funcional, output ceiling, estado de cuenta |
| Traducción como tarea principal | Hunyuan Translation / hunyuan-translation | model overview, ChatTranslations API, idiomas admitidos, segment limits, billing row |
| Texto, imagen o boceto a activo 3D | Hunyuan 3D Engine | Tencent HY 3D docs, async submit/query, output formats, cuotas, storage/review |
| Acceso Hunyuan por proveedor compatible | Solo contrato del proveedor | alias, endpoint, precio, rate limits, logs, retry billing, soporte |
Tablero rápido de rutas
El orden seguro es trabajo primero, nombre de modelo después. Si empiezas por el nombre, es fácil leer hunyuan-turbos-latest como el Hunyuan más nuevo de todo el ecosistema, usar Hunyuan-Lite como default de producción, convertir Hunyuan Translation en un prompt de chat o diseñar Hunyuan 3D Engine como si fuera un modelo de texto.
La visión general de Tencent Cloud Hunyuan funciona como el primer mapa para texto y traducción. hunyuan-turbos-latest, hunyuan-lite y hunyuan-translation aparecen como filas distintas con límites de entrada/salida y usos distintos. Hunyuan también incluye familias multimodales, imagen, video y 3D, por lo que no conviene poner todos los nombres en una sola tabla de ranking.
| Ruta | Mejor primer uso | No usar para |
|---|---|---|
| TurboS Latest | texto/chat general, razonamiento, resúmenes, código, workflows OpenAI-compatible | afirmar que es el modelo más nuevo de todos los productos Hunyuan |
| Hunyuan-Lite | pruebas baratas, extracción simple, clasificación, evaluación temprana de prompts | producción visible al cliente con alta exigencia de calidad |
| Hunyuan Translation | pipelines de traducción, documentos bilingües, soporte, subtítulos | sustituir una API de traducción por un prompt de chat |
| Hunyuan 3D Engine | generación de activos 3D desde texto, imagen o boceto | chat/completions o cálculo con token pricing de texto |
Separar quién posee cada hecho
Tencent Cloud también incluye notas de plataforma sobre la migración de capacidades Hunyuan hacia TokenHub. Para implementación, esa nota es una frontera práctica: una ruta antigua puede seguir funcionando para servicios ya comprados, pero nuevas capacidades, compras o activaciones deben comprobarse en el punto oficial vigente.
| Hecho | Familia de fuente | Por qué importa |
|---|---|---|
| Nombre de modelo, actualización, ventana de entrada/salida, feature notes | Tencent Cloud Hunyuan product overview | evita mezclar latest, Lite, Translation y 3D como nombres equivalentes |
base URL, API key, chat/completions path, sample hunyuan-turbos-latest | Tencent Cloud OpenAI-compatible examples | confirma la forma de cliente OpenAI-compatible y extensiones Tencent |
| recursos gratis, prepaid/postpaid, token billing rows, estado de Lite | Tencent Cloud billing overview | ata "gratis" y "pago" a la fila oficial actual |
| comportamiento específico de traducción | Tencent Cloud ChatTranslations docs | evita convertir traducción en un chat prompt normal |
| auth 3D, SecretId/SecretKey, async job APIs, result retrieval | Tencent HY 3D Global docs | separa 3D Engine de supuestos text/chat |
Una página de proveedor se lee con otro marco. Puede describir endpoint, account model, price, rate limits, logs, retries, support y model aliases del proveedor. No debe usarse para cambiar el precio oficial de Tencent Cloud, eliminar cuotas de Tencent, demostrar cobertura de idioma oficial o prometer un formato 3D de Tencent.
hunyuan-turbos-latest: ruta de texto y chat
Usa hunyuan-turbos-latest cuando el trabajo sea un workload normal de texto/chat y quieras la forma de cliente OpenAI-compatible. Los ejemplos compatibles de Tencent Cloud muestran el base URL https://api.hunyuan.cloud.tencent.com/v1, el path de chat/completions y un sample con model: "hunyuan-turbos-latest".
La forma mínima en Python es familiar:
hljs pythonimport 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": "Resume esta nota de lanzamiento en tres puntos."}
],
extra_body={"enable_enhancement": True},
)
print(response.choices[0].message.content)
Compatible no significa idéntico. Tencent documenta parámetros OpenAI-compatible junto con parámetros propios. Antes de migrar una app, prueba el mismo payload para streaming, enhancement flags, function calling, SDK retries, logging, timeouts, error body y cost reporting. Un endpoint familiar reduce fricción, pero no iguala facturación, errores ni soporte de parámetros.
La palabra latest también tiene límite. En la visión general, hunyuan-turbos-latest es el alias actual de TurboS dentro de text/chat family. No es una promesa de que sea el Hunyuan más nuevo o fuerte en traducción, 3D, multimodal, imagen o futuras rutas TokenHub.
Hunyuan-Lite: pruebas de texto de bajo coste
Hunyuan-Lite encaja con cost-sensitive text work y early integration tests. La página de precios de Tencent Cloud, revisada el 8 de mayo de 2026, lista Hunyuan-Lite como free to use. Esa frase debe mantenerse con fecha y fuente; el model overview debe leerse al mismo tiempo para entender su rol Lite, límites y ajuste de calidad.
No conviertas Lite en production default universal. Es buen primer paso para smoke tests, extracción simple, clasificación, herramientas internas y evaluación temprana de prompts. Si el trabajo necesita stronger reasoning, knowledge enhancement, long output, customer-facing reliability, código complejo o límites mayores, ejecuta el mismo test set en TurboS u otra fila oficial de texto.
| Punto de decisión | Lite encaja | Conviene comparar otra ruta |
|---|---|---|
| Coste | muchas pruebas pequeñas, bajo riesgo | errores y retries crean coste humano |
| Calidad | labels, extraction, short summaries, internal drafts | copy visible al cliente, respuestas críticas, código complejo |
| Funciones | basic text call basta | enhanced search, special parameters, larger output |
| Promesa externa | no escribes "gratis" en copy de cliente | necesitas presupuesto, SLA o documento público |
"Gratis" es una fila oficial actual, no un contrato permanente. Si cambian billing page, consola, región, estado de cuenta o migración de servicio, screenshots antiguos y provider pages no protegen el presupuesto.
Hunyuan Translation: ruta de traducción
Hunyuan Translation merece una ruta propia porque Tencent documenta hunyuan-translation como modelo/API de traducción. En traducción importan source language, target language, segment length, glossary handling, format retention, fallback behavior, throughput y cost per accepted translation.
Elige Translation route para producto bilingüe, documentación localizada, mensajes de soporte, subtítulos, QA multilingüe o pipelines con muchos segmentos cortos. Chat completions sirve cuando la traducción es parte de una tarea de razonamiento más amplia, por ejemplo leer un mensaje de cliente, clasificar intención, generar una respuesta y traducirla. Si la tarea es solo traducción masiva, la API de traducción es más fácil de presupuestar y validar.
| Revisión | Motivo |
|---|---|
| source/target languages | no prometer un idioma solo por un demo |
| segment length and format | docs, subtítulos y JSON fields requieren chunking distinto |
| terminology and names | la API de traducción aún necesita glossary QA |
| retry and fallback | batch translation requiere política de fallos |
| billing row | translation cost no debe mezclarse con chat cost |
Hunyuan 3D Engine: pipeline async de activos 3D
Hunyuan 3D Engine no es una variante de modelo de texto. Tencent lo posiciona como plataforma para generar activos 3D desde texto, imagen o boceto; Tencent HY 3D Global docs lo separa en una familia de producto distinta, con auth, task submission y result retrieval propios.
El API shape cambia la arquitectura. El professional 3D API es asíncrono: envías una tarea, recibes JobId y consultas el resultado con ese JobId. Eso exige queue design, retry policy, status storage, timeout, asset storage, preview UI, moderation review y customer-facing failure messages.
| Production concern | Implicación 3D |
|---|---|
| prompt or image input | valida prompt, requisitos de imagen y derechos del usuario antes de submit |
| async job | guarda JobId, diseña polling o scheduled query, define timeout y retry |
| output formats | revisa GLB, OBJ, STL, FBX o preview antes de prometer formatos |
| billing and quota | usa Tencent HY 3D billing/free-resource docs, no filas text-token |
| review workflow | un activo generado puede requerir preview, cleanup, export y revisión de derechos |
La primera prueba real debe ser una pequeña tarea 3D, no un chat sobre 3D. Comprueba auth, JobId, query interval, output file, failure body, storage path y estado visible para el usuario.
Rutas de proveedores compatibles
Un proveedor compatible puede reducir fricción si ofrece endpoint OpenAI-compatible, facturación centralizada, logs o soporte. Aun así, su contrato es independiente. Su página prueba la ruta del proveedor, su precio, límites, retries, support responsibility y data contract; no prueba hechos oficiales de Tencent.
Antes de producción, revisa:
- alias exacto del modelo y si se mapea a una fila oficial Tencent.
- compatibilidad del endpoint y parámetros no admitidos.
- billing unit, minimum charge, retry billing y failed-request behavior.
- data handling, log retention, privacy y support responsibility.
- fallback si el proveedor tarda en reflejar updates oficiales de Tencent.
No hace falta recomendar un proveedor para elegir la ruta base. Primero identifica el carril oficial de Tencent; después decide si la comodidad del proveedor justifica el contrato adicional.
Checklist antes de producción
Antes de fijar la ruta en código, copy de cliente o presupuesto, usa el mismo conjunto pequeño de tareas: un prompt text/chat en TurboS Latest, una muestra barata en Lite, un segmento en Translation y una pequeña tarea async 3D. El objetivo no es un ranking, sino demostrar que cada ruta termina el trabajo que dice poseer.
| Claim | Revisión antes de usarlo |
|---|---|
hunyuan-turbos-latest para text/chat | model overview actual, sample compatible, disponibilidad de consola, sentido de latest |
| Hunyuan-Lite es gratis | fila actual de precios Tencent, account state, service activation, region, feature caveats |
| Hunyuan Translation coverage | model row actual, ChatTranslations docs, language list, segment limits, billing |
| Hunyuan 3D output format | Tencent HY 3D docs actuales, API version, output formats, free resources, quota, storage |
| disponibilidad del proveedor | docs del proveedor, billing, limits, support, data contract; no convertirlo en hecho Tencent |
Si no puedes confirmarlo ahora, no lo escribas como promesa. Evita unlimited speed, permanent free, no-ban, refund guarantee, fixed SLA o all-region availability sin evidencia actual exacta.
Preguntas frecuentes
¿Qué significa hunyuan-turbos-latest?
Es un alias de modelo text/chat Hunyuan que aparece en ejemplos OpenAI-compatible de Tencent Cloud. Trátalo como ruta TurboS Latest para text/chat, no como promesa de newest Hunyuan en todas las familias.
¿Hunyuan-Lite es gratis?
La página de precios Tencent, revisada el 8 de mayo de 2026, lista Hunyuan-Lite como free to use. Mantén la afirmación con fecha y fuente; revisa pricing oficial, cuenta, región y consola antes de usarla externamente.
¿Usar Hunyuan Translation o un modelo de chat para traducir?
Usa Hunyuan Translation cuando la traducción sea el trabajo. Usa chat completions cuando traducir sea parte de un flujo de razonamiento o conversación. La ruta de traducción es más fácil de presupuestar y validar.
¿Hunyuan 3D Engine es un API model como TurboS?
No. Hunyuan 3D Engine es un workflow async de activos 3D: submit, JobId storage, result query, retries, preview, review y storage.
¿Una página de proveedor prueba el precio oficial Tencent?
No. Prueba la ruta y términos comerciales del proveedor. Tencent Cloud docs y consola poseen los nombres oficiales, precios, cuotas y comportamiento API de Tencent.
¿Qué ruta conviene probar primero?
Empieza por el trabajo: TurboS Latest para text/chat, Lite para cheap text checks, Hunyuan Translation para traducción y Hunyuan 3D Engine para activos 3D. Compara proveedor compatible solo cuando la ruta oficial esté clara.
