# Tencent Cloud Hunyuan Large Language Model API

> Tencent Cloud Hunyuan Large Language Model API on Apizie: 7 endpoints (Activate Service, Query Hunyuan Image Chat Job, Query Hunyuan Image Job, Set Pay Mode, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:tencent-hunyuan/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-hunyuan`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://apizie.tech/api/cloud/tencent-hunyuan
- OpenAPI: https://apizie.tech/api/cloud/tencent-hunyuan/openapi.json

Tencent Cloud API 3.0 for Hunyuan Large Language Model (hunyuan). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Activate Service
`POST https://apizie.tech/v1/cloud:tencent-hunyuan/activate-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PayMode | integer | no |  |

### Query Hunyuan Image Chat Job
`POST https://apizie.tech/v1/cloud:tencent-hunyuan/query-hunyuan-image-chat-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | no |  |

### Query Hunyuan Image Job
`POST https://apizie.tech/v1/cloud:tencent-hunyuan/query-hunyuan-image-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| JobId | string | yes |  |

### Set Pay Mode
`POST https://apizie.tech/v1/cloud:tencent-hunyuan/set-pay-mode` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PayMode | integer | yes |  |

### Submit Hunyuan Image Chat Job
`POST https://apizie.tech/v1/cloud:tencent-hunyuan/submit-hunyuan-image-chat-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Prompt | string | yes |  |
| ChatId | string | no |  |
| LogoAdd | integer | no |  |
| LogoParam | object | no |  |

### Submit Hunyuan Image Job
`POST https://apizie.tech/v1/cloud:tencent-hunyuan/submit-hunyuan-image-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Prompt | string | yes |  |
| NegativePrompt | string | no |  |
| Style | string | no |  |
| Resolution | string | no |  |
| Num | integer | no |  |
| Clarity | string | no |  |
| ContentImage | object | no |  |
| Revise | integer | no |  |
| Seed | integer | no |  |
| LogoAdd | integer | no |  |
| LogoParam | object | no |  |

### Text To Image Lite
`POST https://apizie.tech/v1/cloud:tencent-hunyuan/text-to-image-lite` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Prompt | string | yes |  |
| NegativePrompt | string | no |  |
| Style | string | no |  |
| Resolution | string | no |  |
| LogoAdd | integer | no |  |
| LogoParam | object | no |  |
| RspImgType | string | no |  |

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-hunyuan/activate-service" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Hunyuan Large Language Model API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-hunyuan/activate-service with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud Hunyuan Large Language Model API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud Hunyuan Large Language Model itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud Hunyuan Large Language Model API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-hunyuan.

### What is the status of the Tencent Cloud Hunyuan Large Language Model API?
Needs your own provider key (bring your own key)