# Tencent Cloud Live Music Copyright Engine API

> Tencent Cloud Live Music Copyright Engine API on Apizie: 20 endpoints (Apply Chorus, Batch Describe KTVMusic Details, Create KTVRobot, Describe KTVMatch Musics, …) 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-yinsuda/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Tencent Cloud API 3.0 for Live Music Copyright Engine (yinsuda). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Apply Chorus
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/apply-chorus` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| RoomId | string | yes |  |
| MusicId | string | yes |  |
| MaxChorusNum | integer | no |  |
| ChorusUserIds | array | no |  |

### Batch Describe KTVMusic Details
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/batch-describe-ktvmusic-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| MusicIds | array | yes |  |
| PlayScene | string | no |  |
| GuestUserId | string | no |  |
| RoomId | string | no |  |

### Create KTVRobot
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/create-ktvrobot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| RTCSystem | string | yes |  |
| JoinRoomInput | object | yes |  |
| SyncRobotCommands | array | no |  |

### Describe KTVMatch Musics
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-ktvmatch-musics` (byok)

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

### Describe KTVMusic Accompany Segment Url
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-ktvmusic-accompany-segment-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| MusicId | string | yes |  |
| PlayScene | string | no |  |
| RoomId | string | no |  |

### Describe KTVMusic Accompany Segment Url Vip
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-ktvmusic-accompany-segment-url-vip` (byok)

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

### Describe KTVMusics By Tag
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-ktvmusics-by-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| TagId | string | yes |  |
| ScrollToken | string | no |  |
| Limit | integer | no |  |
| RightFilters | array | no |  |
| MaterialFilters | array | no |  |

### Describe KTVPlaylist Detail
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-ktvplaylist-detail` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| PlaylistId | string | yes |  |
| ScrollToken | string | no |  |
| Limit | integer | no |  |
| RightFilters | array | no |  |
| PlayScene | string | no |  |
| MaterialFilters | array | no |  |

### Describe KTVPlaylists
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-ktvplaylists` (byok)

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

### Describe KTVRobots
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-ktvrobots` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| RobotIds | array | no |  |
| Statuses | array | no |  |
| CreateTime | object | no |  |
| Offset | integer | no |  |
| Limit | integer | no |  |

### Describe KTVSuggestions
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-ktvsuggestions` (byok)

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

### Describe KTVTags
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-ktvtags` (byok)

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

### Describe Live Vip Trade Infos
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-live-vip-trade-infos` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| StartTime | string | no |  |
| EndTime | string | no |  |
| TradeSerialNos | array | no |  |
| UserIds | array | no |  |
| Offset | integer | no |  |
| Limit | integer | no |  |

### Describe User Info
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-user-info` (byok)

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

### Describe Vip User Info
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/describe-vip-user-info` (byok)

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

### Destroy KTVRobot
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/destroy-ktvrobot` (byok)

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

### Recharge Live Vip
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/recharge-live-vip` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| TradeSerialNo | string | yes |  |
| RoomId | string | yes |  |
| VipDays | integer | yes |  |
| GiveType | string | no |  |
| PlayScene | string | no |  |

### Recharge Vip
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/recharge-vip` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| RoomId | string | yes |  |
| VipDays | integer | yes |  |
| AnchorId | string | yes |  |

### Search KTVMusics
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/search-ktvmusics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| KeyWord | string | yes |  |
| ScrollToken | string | no |  |
| Limit | integer | no |  |
| RightFilters | array | no |  |
| PlayScene | string | no |  |
| MaterialFilters | array | no |  |

### Sync KTVRobot Command
`POST https://apizie.tech/v1/cloud:tencent-yinsuda/sync-ktvrobot-command` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AppName | string | yes |  |
| UserId | string | yes |  |
| RobotId | string | yes |  |
| SyncRobotCommands | array | yes |  |

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

## FAQ

### How do I call the Tencent Cloud Live Music Copyright Engine API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-yinsuda/apply-chorus with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Tencent Cloud Live Music Copyright Engine 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-yinsuda.

### What is the status of the Tencent Cloud Live Music Copyright Engine API?
Needs your own provider key (bring your own key)