# Tencent Cloud Speech Recognition API

> Tencent Cloud Speech Recognition API on Apizie: 33 endpoints (Close Async Recognition Task, Create Asr Key Word Lib, Create Asr Vocab, Create Async Recognition Task, …) 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-asr/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Tencent Cloud API 3.0 for Speech Recognition (asr). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Close Async Recognition Task
`POST https://apizie.tech/v1/cloud:tencent-asr/close-async-recognition-task` (byok)

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

### Create Asr Key Word Lib
`POST https://apizie.tech/v1/cloud:tencent-asr/create-asr-key-word-lib` (byok)

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

### Create Asr Vocab
`POST https://apizie.tech/v1/cloud:tencent-asr/create-asr-vocab` (byok)

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

### Create Async Recognition Task
`POST https://apizie.tech/v1/cloud:tencent-asr/create-async-recognition-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EngineType | string | yes |  |
| Url | string | yes |  |
| CallbackUrl | string | yes |  |
| SignToken | string | no |  |
| FilterDirty | integer | no |  |
| FilterModal | integer | no |  |
| FilterPunc | integer | no |  |
| ConvertNumMode | integer | no |  |
| WordInfo | integer | no |  |
| HotwordId | string | no |  |
| AudioData | boolean | no |  |

### Create Customization
`POST https://apizie.tech/v1/cloud:tencent-asr/create-customization` (byok)

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

### Create Rec Task
`POST https://apizie.tech/v1/cloud:tencent-asr/create-rec-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EngineModelType | string | yes |  |
| ChannelNum | integer | yes |  |
| ResTextFormat | integer | yes |  |
| SourceType | integer | yes |  |
| Data | string | no |  |
| DataLen | integer | no |  |
| Url | string | no |  |
| CallbackUrl | string | no |  |
| SpeakerDiarization | integer | no |  |
| SpeakerNumber | integer | no |  |
| HotwordId | string | no |  |
| CustomizationId | string | no |  |
| EmotionRecognition | integer | no |  |
| EmotionalEnergy | integer | no |  |
| ConvertNumMode | integer | no |  |
| FilterDirty | integer | no |  |
| FilterPunc | integer | no |  |
| FilterModal | integer | no |  |
| SentenceMaxLength | integer | no |  |
| Extra | string | no |  |
| HotwordList | string | no |  |
| KeyWordLibIdList | array | no |  |
| ReplaceTextId | string | no |  |
| SpeakerRoles | array | no |  |

### Delete Asr Key Word Lib
`POST https://apizie.tech/v1/cloud:tencent-asr/delete-asr-key-word-lib` (byok)

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

### Delete Asr Vocab
`POST https://apizie.tech/v1/cloud:tencent-asr/delete-asr-vocab` (byok)

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

### Delete Customization
`POST https://apizie.tech/v1/cloud:tencent-asr/delete-customization` (byok)

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

### Describe Async Recognition Tasks
`POST https://apizie.tech/v1/cloud:tencent-asr/describe-async-recognition-tasks` (byok)

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

### Describe Task Status
`POST https://apizie.tech/v1/cloud:tencent-asr/describe-task-status` (byok)

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

### Download Asr Vocab
`POST https://apizie.tech/v1/cloud:tencent-asr/download-asr-vocab` (byok)

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

### Download Customization
`POST https://apizie.tech/v1/cloud:tencent-asr/download-customization` (byok)

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

### Get Asr Key Word Lib List
`POST https://apizie.tech/v1/cloud:tencent-asr/get-asr-key-word-lib-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Offset | integer | no |  |
| Limit | integer | no |  |
| SpecifyNames | array | no |  |
| OnlySelf | boolean | no |  |

### Get Asr Vocab
`POST https://apizie.tech/v1/cloud:tencent-asr/get-asr-vocab` (byok)

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

### Get Asr Vocab List
`POST https://apizie.tech/v1/cloud:tencent-asr/get-asr-vocab-list` (byok)

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

### Get Customization List
`POST https://apizie.tech/v1/cloud:tencent-asr/get-customization-list` (byok)

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

### Get Model Info
`POST https://apizie.tech/v1/cloud:tencent-asr/get-model-info` (byok)

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

### Get Usage By Date
`POST https://apizie.tech/v1/cloud:tencent-asr/get-usage-by-date` (byok)

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

### Modify Customization
`POST https://apizie.tech/v1/cloud:tencent-asr/modify-customization` (byok)

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

### Modify Customization State
`POST https://apizie.tech/v1/cloud:tencent-asr/modify-customization-state` (byok)

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

### Sentence Recognition
`POST https://apizie.tech/v1/cloud:tencent-asr/sentence-recognition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| EngSerViceType | string | yes |  |
| SourceType | integer | yes |  |
| VoiceFormat | string | yes |  |
| Url | string | no |  |
| Data | string | no |  |
| DataLen | integer | no |  |
| WordInfo | integer | no |  |
| FilterDirty | integer | no |  |
| FilterModal | integer | no |  |
| FilterPunc | integer | no |  |
| ConvertNumMode | integer | no |  |
| HotwordId | string | no |  |
| CustomizationId | string | no |  |
| HotwordList | string | no |  |
| InputSampleRate | integer | no |  |
| ReplaceTextId | string | no |  |

### Set Vocab State
`POST https://apizie.tech/v1/cloud:tencent-asr/set-vocab-state` (byok)

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

### Update Asr Key Word Lib
`POST https://apizie.tech/v1/cloud:tencent-asr/update-asr-key-word-lib` (byok)

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

### Update Asr Vocab
`POST https://apizie.tech/v1/cloud:tencent-asr/update-asr-vocab` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| VocabId | string | yes |  |
| Name | string | no |  |
| WordWeights | array | no |  |
| WordWeightStr | string | no |  |
| Description | string | no |  |

### Voice Print Compare
`POST https://apizie.tech/v1/cloud:tencent-asr/voice-print-compare` (byok)

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

### Voice Print Count
`POST https://apizie.tech/v1/cloud:tencent-asr/voice-print-count` (byok)

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

### Voice Print Delete
`POST https://apizie.tech/v1/cloud:tencent-asr/voice-print-delete` (byok)

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

### Voice Print Enroll
`POST https://apizie.tech/v1/cloud:tencent-asr/voice-print-enroll` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| VoiceFormat | integer | yes |  |
| SampleRate | integer | yes |  |
| Data | string | no |  |
| SpeakerNick | string | no |  |
| GroupId | string | no |  |
| AudioUrl | string | no |  |
| QualityCheck | boolean | no |  |

### Voice Print Group List
`POST https://apizie.tech/v1/cloud:tencent-asr/voice-print-group-list` (byok)

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

### Voice Print Group Verify
`POST https://apizie.tech/v1/cloud:tencent-asr/voice-print-group-verify` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| VoiceFormat | integer | yes |  |
| SampleRate | integer | yes |  |
| Data | string | yes |  |
| GroupId | string | yes |  |
| TopN | integer | yes |  |

### Voice Print Update
`POST https://apizie.tech/v1/cloud:tencent-asr/voice-print-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| VoiceFormat | integer | yes |  |
| SampleRate | integer | yes |  |
| VoicePrintId | string | yes |  |
| Data | string | no |  |
| SpeakerNick | string | no |  |
| AudioUrl | string | no |  |

### Voice Print Verify
`POST https://apizie.tech/v1/cloud:tencent-asr/voice-print-verify` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| VoiceFormat | integer | yes |  |
| SampleRate | integer | yes |  |
| VoicePrintId | string | yes |  |
| Data | string | no |  |
| AudioUrl | string | no |  |

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-asr/close-async-recognition-task" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Speech Recognition API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-asr/close-async-recognition-task with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Tencent Cloud Speech Recognition 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-asr.

### What is the status of the Tencent Cloud Speech Recognition API?
Needs your own provider key (bring your own key)