Tencent Hunyuan Commands & Prompt Reference
22 commands & parameters · 4 categories · Source: Tencent Cloud Hunyuan ChatCompletions API
Tencent Hunyuan's ChatCompletions endpoint follows Tencent Cloud's API conventions rather than the OpenAI shape, so parameter names are PascalCase and three common parameters (Action, Version, Region) travel with every request. The conversation itself goes in Messages.N, capped at 40 entries ordered oldest to newest, with system first if present and user and assistant alternating.
What distinguishes Hunyuan from most chat APIs is the size of its search and enhancement surface. EnableEnhancement turns on capability augmentation, ForceSearchEnhancement makes it mandatory, EnableSpeedSearch trades depth for a faster first token, and SearchInfo plus Citation control what search metadata comes back. Several parameters are model-gated: tool calling works on hunyuan-turbos, hunyuan-t1 and hunyuan-functioncall, while EnableThinking currently applies only to hunyuan-a13b.
All Commands
Core Request Parameters (8)
| Command / Syntax | What it does | Notes |
|---|---|---|
| Model | Model name to call | Required. Example: hunyuan-turbos-latest. Billing differs by model. |
| Messages.N | Chat context array, ordered oldest to newest | Required. Up to 40 entries. Role values: system, user, assistant, tool. System, if present, must be first; user and assistant alternate. |
| Stream | Streaming response switch | Defaults to false. When true, results arrive incrementally over SSE in Choices[n].Delta. |
| StreamModeration | Content moderation switch for streaming output | Boolean. |
| Temperature | Sampling temperature controlling output randomness | Float. Set either Temperature or TopP, not both. |
| TopP | Nucleus sampling probability threshold | Float. Set either Temperature or TopP, not both. |
| Seed | Random seed for reproducible output | Non-zero positive integer up to 10000. Not recommended unless needed; unsuitable values degrade quality. |
| Stop.N | Custom stop strings that end generation | Array of strings. |
Tools & Reasoning Parameters (3)
| Command / Syntax | What it does | Notes |
|---|---|---|
| Tools.N | List of callable tools for function calling | Effective only on hunyuan-turbos, hunyuan-t1 and hunyuan-functioncall models. |
| ToolChoice | Tool usage mode | Values: none, auto, custom. Defaults to auto. Effective on hunyuan-turbo and hunyuan-functioncall models. |
| EnableThinking | Chain-of-thought reasoning switch | Enabled by default. Currently effective only on the hunyuan-a13b model. |
Search & Enhancement Switches (8)
| Command / Syntax | What it does | Notes |
|---|---|---|
| EnableEnhancement | Capability enhancement switch, such as search | Boolean. |
| ForceSearchEnhancement | Force search enhancement on | Boolean. |
| EnableSpeedSearch | Turn on the fast search variant | Defaults to false. When on and search is triggered, streaming returns the first token sooner. |
| SearchInfo | Return SearchInfo in the response when search is triggered | Defaults to false. |
| Citation | Search citation superscript switch | Boolean. |
| EnableMultimedia | Multimedia output switch | Boolean. |
| EnableRecommendedQuestions | Recommended follow-up questions switch | Boolean. |
| TopicChoice | Topic passed in by the caller | String. |
Common API Parameters (3)
| Command / Syntax | What it does | Notes |
|---|---|---|
| Action | Common parameter; the API action name | Fixed value for this endpoint: ChatCompletions. Required. |
| Version | Common parameter; the API version | Fixed value for this endpoint: 2023-09-01. Required. |
| Region | Common parameter; the region | Optional for this endpoint. |
Frequently Asked Questions
Why do Hunyuan parameters look different from OpenAI's?
The endpoint follows Tencent Cloud API conventions: PascalCase names, and every request carries the common Action and Version parameters (ChatCompletions and 2023-09-01 for this endpoint).
How long can the conversation context be?
Messages.N holds up to 40 entries, ordered oldest to newest. If total Content exceeds the model's input limit, the earliest content is truncated and the tail is kept.
Which models support tool calling and thinking?
Tools and ToolChoice are effective on hunyuan-turbos, hunyuan-t1 and hunyuan-functioncall. EnableThinking currently applies only to hunyuan-a13b.
Every entry on this page is a literal, typeable token taken from the official documentation linked above. Command sets in AI tools change quickly - the in-product command menu is always authoritative for your installed version.