# Tencent Cloud Real-time Remote Operation API

> Tencent Cloud Real-time Remote Operation API on Apizie: 39 endpoints (Batch Delete Devices, Batch Delete Policy, Bound Licenses, Create Batch Video Annotation Job, …) 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-trro/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Tencent Cloud API 3.0 for Real-time Remote Operation (trro). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Batch Delete Devices
`POST https://apizie.tech/v1/cloud:tencent-trro/batch-delete-devices` (byok)

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

### Batch Delete Policy
`POST https://apizie.tech/v1/cloud:tencent-trro/batch-delete-policy` (byok)

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

### Bound Licenses
`POST https://apizie.tech/v1/cloud:tencent-trro/bound-licenses` (byok)

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

### Create Batch Video Annotation Job
`POST https://apizie.tech/v1/cloud:tencent-trro/create-batch-video-annotation-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| InputStorage | object | yes |  |
| AnnotationType | integer | yes |  |
| AnnotationContext | object | no |  |
| ProcessParams | object | no |  |
| OutputStorage | object | no |  |
| CallbackInfo | object | no |  |

### Create Cloud Recording
`POST https://apizie.tech/v1/cloud:tencent-trro/create-cloud-recording` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProjectId | string | yes |  |
| DeviceId | string | yes |  |
| VideoStreamId | integer | yes |  |
| CloudStorage | object | yes |  |
| MaxMediaFileDuration | integer | no |  |
| OutputFormat | integer | no |  |
| MaxIdleTime | integer | no |  |

### Create Device
`POST https://apizie.tech/v1/cloud:tencent-trro/create-device` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProjectId | string | yes |  |
| DeviceId | string | yes |  |
| DeviceName | string | yes |  |
| DeviceType | string | yes |  |
| DeviceToken | string | yes |  |

### Create Project
`POST https://apizie.tech/v1/cloud:tencent-trro/create-project` (byok)

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

### Create Video Annotation Job
`POST https://apizie.tech/v1/cloud:tencent-trro/create-video-annotation-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| InputType | integer | yes |  |
| AnnotationType | integer | yes |  |
| S3SourceInfo | object | no |  |
| HttpUrl | string | no |  |
| AnnotationContext | object | no |  |
| ProcessParams | object | no |  |
| OutputInfo | object | no |  |
| CallbackInfo | object | no |  |

### Delete Annotation Job
`POST https://apizie.tech/v1/cloud:tencent-trro/delete-annotation-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 |  |

### Delete Annotation Task
`POST https://apizie.tech/v1/cloud:tencent-trro/delete-annotation-task` (byok)

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

### Delete Cloud Recording
`POST https://apizie.tech/v1/cloud:tencent-trro/delete-cloud-recording` (byok)

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

### Delete Project
`POST https://apizie.tech/v1/cloud:tencent-trro/delete-project` (byok)

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

### Describe Annotation Jobs
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-annotation-jobs` (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 |  |
| Status | integer | no |  |
| InputPath | string | no |  |

### Describe Annotation Results
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-annotation-results` (byok)

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

### Describe Annotation Tasks
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-annotation-tasks` (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 |  |
| Offset | integer | no |  |
| Limit | integer | no |  |
| FileName | string | no |  |
| Status | integer | no |  |

### Describe Device Info
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-device-info` (byok)

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

### Describe Device List
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-device-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProjectId | string | yes |  |
| DeviceType | string | no |  |
| SearchWords | string | no |  |
| PageSize | integer | no |  |
| PageNumber | integer | no |  |
| DeviceStatus | string | no |  |
| RegisterType | integer | no |  |

### Describe Device Session Details
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-device-session-details` (byok)

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

### Describe Device Session List
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-device-session-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProjectId | string | yes |  |
| PageNumber | integer | yes |  |
| PageSize | integer | yes |  |
| DeviceId | string | no |  |
| StartTime | integer | no |  |
| EndTime | integer | no |  |

### Describe Policy
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProjectId | string | yes |  |
| PolicyMode | string | no |  |
| SearchMode | string | no |  |
| SearchWords | string | no |  |
| PageSize | integer | no |  |
| PageNumber | integer | no |  |

### Describe Project Info
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-project-info` (byok)

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

### Describe Project List
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-project-list` (byok)

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

### Describe Recent Session List
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-recent-session-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProjectId | string | yes |  |
| PageNumber | integer | yes |  |
| PageSize | integer | yes |  |
| DeviceId | string | no |  |
| StartTime | integer | no |  |
| EndTime | integer | no |  |

### Describe Session Statistics
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-session-statistics` (byok)

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

### Describe Session Statistics By Interval
`POST https://apizie.tech/v1/cloud:tencent-trro/describe-session-statistics-by-interval` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProjectId | string | yes |  |
| StatisticInterval | string | yes |  |
| DeviceId | string | no |  |
| StartTime | integer | no |  |
| EndTime | integer | no |  |

### Get Device License
`POST https://apizie.tech/v1/cloud:tencent-trro/get-device-license` (byok)

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

### Get Devices
`POST https://apizie.tech/v1/cloud:tencent-trro/get-devices` (byok)

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

### Get Duration Details
`POST https://apizie.tech/v1/cloud:tencent-trro/get-duration-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| StartTime | integer | yes |  |
| EndTime | integer | yes |  |
| PageNum | integer | yes |  |
| PageSize | integer | yes |  |
| ProjectId | string | yes |  |
| DeviceId | string | no |  |

### Get License Stat
`POST https://apizie.tech/v1/cloud:tencent-trro/get-license-stat` (byok)

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

### Get Licenses
`POST https://apizie.tech/v1/cloud:tencent-trro/get-licenses` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| PageNum | integer | yes |  |
| PageSize | integer | yes |  |
| ProjectId | string | no |  |
| DeviceId | string | no |  |
| Status | integer | no |  |

### Get Total Duration
`POST https://apizie.tech/v1/cloud:tencent-trro/get-total-duration` (byok)

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

### Modify Callback Url
`POST https://apizie.tech/v1/cloud:tencent-trro/modify-callback-url` (byok)

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

### Modify Device
`POST https://apizie.tech/v1/cloud:tencent-trro/modify-device` (byok)

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

### Modify Policy
`POST https://apizie.tech/v1/cloud:tencent-trro/modify-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProjectId | string | yes |  |
| RemoteDeviceId | string | yes |  |
| FieldDeviceIds | array | yes |  |
| PolicyMode | string | yes |  |
| ModifyMode | string | yes |  |

### Modify Project
`POST https://apizie.tech/v1/cloud:tencent-trro/modify-project` (byok)

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

### Modify Project Sec Mode
`POST https://apizie.tech/v1/cloud:tencent-trro/modify-project-sec-mode` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ProjectId | string | yes |  |
| Mode | integer | yes |  |
| Key | string | no |  |
| AutoRegister | integer | no |  |
| FieldListEnable | integer | no |  |

### Retry Annotation Task
`POST https://apizie.tech/v1/cloud:tencent-trro/retry-annotation-task` (byok)

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

### Start Publish Live Stream
`POST https://apizie.tech/v1/cloud:tencent-trro/start-publish-live-stream` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| WithTranscoding | integer | yes |  |
| MaxIdleTime | integer | yes |  |
| VideoParams | object | yes |  |
| PublishParams | array | yes |  |

### Stop Publish Live Stream
`POST https://apizie.tech/v1/cloud:tencent-trro/stop-publish-live-stream` (byok)

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

## Example
```
curl "https://apizie.tech/v1/cloud:tencent-trro/batch-delete-devices" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Real-time Remote Operation API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:tencent-trro/batch-delete-devices with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Tencent Cloud Real-time Remote Operation 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-trro.

### What is the status of the Tencent Cloud Real-time Remote Operation API?
Needs your own provider key (bring your own key)