Tencent HY / Hunyuan docs
** – API overview
Last verified:
Visit Tencent HY / Hunyuan docs
What is Tencent HY / Hunyuan docs?
Tencent HY / Hunyuan docs is Tencent’s self-developed general-purpose and multimodal large model family. It is positioned for high-quality content creation, mathematical logic, code generation, and multi-round dialogue, with the website describing it as industry-leading in those areas. The API also supports AI search with online plug-ins, which lets it combine model generation with Tencent’s content ecosystem for real-time, in-depth retrieval and AI FAQ capability.
The product is aimed at developers and businesses that want to build AI applications on top of Tencent Cloud APIs. The documentation frames it as an API-driven service that can be accessed through the API Explorer tool and the ChatCompletions API. That makes it relevant for teams prototyping quickly as well as teams integrating a production model into existing systems.
A key part of the offering is that it is not limited to simple chat. The overview emphasizes multimodal capability, and the broader Tencent HY family is described across Tencent Cloud pages as covering text and other modalities such as image, video, and 3D. That makes the platform suitable for content products, business automation, and other enterprise scenarios where one model family may need to support multiple media types.
From a usage standpoint, the service is built around Tencent Cloud authentication and API access controls. The documentation notes that users need an API key consisting of SecretId and SecretKey, and that usage limits depend on the parameter limits of each API document. Overall, it is best for teams that want a Tencent-native AI stack with hosted API access, billing controls, and access to Tencent’s ecosystem.
Tencent HY / Hunyuan docs pricing
Pricing model: Freemium
Tencent HY Text Generation Global uses postpaid daily settlement. On first activation, Tencent provides a one-time free resource package for testing; for Hunyuan-translation this includes 100M tokens of shared consumption, valid for 1 year. After the free quota is used up, pricing is pay-as-you-go at USD 0.2571 per million input tokens and USD 0.7714 per million output tokens for Hunyuan-translation. Billing is based on token usage, including direct API calls and API Explorer usage, and failed calls are not charged. Postpaid must be manually enabled in Tencent HY Console > Settings > Postpaid Settings.
Tencent HY / Hunyuan docs pros
- Self-developed by Tencent
- Strong content generation
- Supports mathematical logic
- Supports code generation
- Handles multi-round dialogue
- Multimodal model family
- Supports AI search plugins
- Real-time content retrieval
- AI FAQ capability
- Integrates Tencent content ecosystem
- API-based access
- Available through API Explorer
- ChatCompletions support
- Enterprise-grade positioning
- Useful for business automation
- Suitable for content products
- Uses secure API key authentication
- Hosted on Tencent Cloud
Tencent HY / Hunyuan docs cons
- Requires Tencent Cloud account setup
- Needs SecretId and SecretKey
- API usage depends on parameter limits
- Free quota is limited to testing
- Free quota expires after 1 year
- Postpaid is not enabled by default
- Billing exception if postpaid is not enabled
- Failed calls are not charged but still require careful tracking
- Settlement is token-based and can be complex
- Documentation points users to separate API docs for details
Frequently asked questions about Tencent HY / Hunyuan docs
What is Tencent Hunyuan?
Tencent Hunyuan is Tencent’s self-developed general-purpose and multimodal large model family. The documentation highlights it for high-quality content creation, mathematical logic, code generation, and multi-round dialogue, and says it also supports AI search with online plug-ins for retrieval and AI FAQ capabilities.
What can I use Tencent Hunyuan for?
The website positions it for content products and business automation, with particular strengths in content generation, reasoning, coding, and interactive dialogue. It is also suitable for scenarios that need real-time information retrieval through Tencent’s content ecosystem.
How do I call the API?
Tencent says you can use the API Explorer tool to call the API online. The page uses application creation as an example and instructs users to open API Explorer and call the ChatCompletions API to invoke Tencent Hunyuan.
What authentication is required?
The documentation says an API key is required for identity verification, and that the key consists of SecretId and SecretKey. That credential is used to access Tencent Cloud APIs securely.
What billing model does Tencent HY use?
Tencent HY Text Generation Global uses postpaid daily settlement. Usage is billed by tokens, and the system settles the previous month’s bill from the 1st to the 3rd of each month.
Is there a free quota?
Yes. On first activation, Tencent provides a one-time free resource package for testing. For Hunyuan-translation, the documented free quota is 100M tokens of shared consumption, and the package is valid for 1 year after activation.
What happens when the free quota runs out?
After the free quota is used up, billing switches to the listed pay-as-you-go rates, but only if postpaid has been enabled. If postpaid is not activated, the documentation says a billing exception error will occur.
How much does Hunyuan-translation cost?
The documented postpaid price for Hunyuan-translation is USD 0.2571 per million input tokens and USD 0.7714 per million output tokens. Tencent also provides the formula for calculating cost from input and output token counts.
Are failed calls charged?
No. The billing overview explicitly states that failed calls are not charged. Billing is based on usage that successfully consumes tokens, including direct API calls and API Explorer usage.
Where do I enable postpaid billing?
Tencent says to enable postpayment in the Tencent HY Console under Settings > Postpaid Settings. The documentation notes that postpaid does not turn on automatically after the free package is exhausted or expires.