# Tencent Cloud AI Agent Security Gateway API

> Tencent Cloud AI Agent Security Gateway API on Apizie: 40 endpoints (Create Agent App, Create Agent App Mcp Servers, Create Agent App Model Services, Create Agent App Services, …) 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://www.apizie.tech/v1/cloud:tencent-apis/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Tencent Cloud API 3.0 for AI Agent Security Gateway (apis). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Create Agent App
`POST https://www.apizie.tech/v1/cloud:tencent-apis/create-agent-app` (byok)

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

### Create Agent App Mcp Servers
`POST https://www.apizie.tech/v1/cloud:tencent-apis/create-agent-app-mcp-servers` (byok)

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

### Create Agent App Model Services
`POST https://www.apizie.tech/v1/cloud:tencent-apis/create-agent-app-model-services` (byok)

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

### Create Agent App Services
`POST https://www.apizie.tech/v1/cloud:tencent-apis/create-agent-app-services` (byok)

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

### Create Agent Credential
`POST https://www.apizie.tech/v1/cloud:tencent-apis/create-agent-credential` (byok)

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

### Create Mcp Server
`POST https://www.apizie.tech/v1/cloud:tencent-apis/create-mcp-server` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Mode | string | yes |  |
| McpVersion | string | yes |  |
| InstanceID | string | yes |  |
| Name | string | yes |  |
| Description | string | yes |  |
| WrapServices | array | no |  |
| TargetSelect | string | no |  |
| TargetHosts | array | no |  |
| HttpProtocolType | string | no |  |
| CheckTargetCertsError | boolean | no |  |
| TargetPath | string | no |  |
| IpWhiteStatus | boolean | no |  |
| IpWhiteConfig | object | no |  |
| IpBlackStatus | boolean | no |  |
| IpBlackConfig | object | no |  |
| CustomHttpHost | string | no |  |
| HttpHostType | string | no |  |
| Timeout | integer | no |  |
| McpSecurityRules | array | no |  |
| ToolConfigs | array | no |  |
| WrapPaasID | string | no |  |
| PluginConfigs | array | no |  |
| IgnoreHealthCheck | boolean | no |  |
| CredentialID | string | no |  |
| Domain | string | no |  |
| RequestProtocolType | string | no |  |

### Create Model
`POST https://www.apizie.tech/v1/cloud:tencent-apis/create-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| InstanceID | string | yes |  |
| Name | string | yes |  |
| HttpProtocolType | string | no |  |
| TargetPath | string | no |  |
| TargetHosts | array | no |  |
| Provider | string | no |  |
| ApiKeys | array | no |  |
| CredentialID | string | no |  |
| CheckTargetCertsError | boolean | no |  |
| HttpProtocolVersion | string | no |  |
| ModelID | string | no |  |
| Description | string | no |  |

### Create Model Service
`POST https://www.apizie.tech/v1/cloud:tencent-apis/create-model-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| InstanceID | string | yes |  |
| Name | string | yes |  |
| Description | string | yes |  |
| PubPath | string | yes |  |
| TargetModels | array | yes |  |
| PathMatchType | string | no |  |
| TmsStatus | boolean | no |  |
| TmsConfig | object | no |  |
| IpWhiteStatus | boolean | no |  |
| IpWhiteList | array | no |  |
| IpBlackList | array | no |  |
| PluginConfigs | array | no |  |
| Timeout | integer | no |  |
| PromptModerateStatus | boolean | no |  |
| PromptModerateConfig | object | no |  |
| SensitiveDataCheckStatus | boolean | no |  |
| SensitiveDataCheckConfig | object | no |  |
| TargetSelect | string | no |  |
| FindHostKeyMethod | string | no |  |
| HostKeyHeaderName | string | no |  |
| FallbackStatus | boolean | no |  |
| FallbackModels | array | no |  |
| ModelProtocol | string | no |  |
| RawCustomModelProtocolConfig | string | no |  |
| RouteStrategy | string | no |  |
| TokenLengthRoute | array | no |  |
| TaskComplexityRoute | object | no |  |
| Domain | string | no |  |
| RequestProtocolType | string | no |  |

### Create Service
`POST https://www.apizie.tech/v1/cloud:tencent-apis/create-service` (byok)

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

### Delete Agent App
`POST https://www.apizie.tech/v1/cloud:tencent-apis/delete-agent-app` (byok)

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

### Delete Agent App Mcp Servers
`POST https://www.apizie.tech/v1/cloud:tencent-apis/delete-agent-app-mcp-servers` (byok)

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

### Delete Agent App Model Services
`POST https://www.apizie.tech/v1/cloud:tencent-apis/delete-agent-app-model-services` (byok)

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

### Delete Agent App Services
`POST https://www.apizie.tech/v1/cloud:tencent-apis/delete-agent-app-services` (byok)

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

### Delete Agent Credential
`POST https://www.apizie.tech/v1/cloud:tencent-apis/delete-agent-credential` (byok)

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

### Delete Mcp Server
`POST https://www.apizie.tech/v1/cloud:tencent-apis/delete-mcp-server` (byok)

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

### Delete Model
`POST https://www.apizie.tech/v1/cloud:tencent-apis/delete-model` (byok)

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

### Delete Model Service
`POST https://www.apizie.tech/v1/cloud:tencent-apis/delete-model-service` (byok)

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

### Delete Service
`POST https://www.apizie.tech/v1/cloud:tencent-apis/delete-service` (byok)

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

### Describe Agent App
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-agent-app` (byok)

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

### Describe Agent App Mcp Servers
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-agent-app-mcp-servers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | no |  |
| InstanceID | string | no |  |
| AgentAppIDs | array | no |  |
| McpServerIDs | array | no |  |
| AgentCredentialIDs | array | no |  |
| Keyword | string | no |  |

### Describe Agent App Model Services
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-agent-app-model-services` (byok)

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

### Describe Agent App Services
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-agent-app-services` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| InstanceID | string | no |  |
| IDs | array | no |  |
| AgentAppIDs | array | no |  |
| ServiceIDs | array | no |  |
| Keyword | string | no |  |
| Offset | integer | no |  |
| AgentCredentialExist | boolean | no |  |
| AgentCredentialIDs | array | no |  |

### Describe Agent Apps
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-agent-apps` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | no |  |
| IDs | array | no |  |
| InstanceID | string | no |  |
| NotIDs | array | no |  |
| Status | string | no |  |
| Keyword | string | no |  |
| AuthType | string | no |  |
| Sort | object | no |  |
| AgentCredentialID | string | no |  |

### Describe Agent Credential
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-agent-credential` (byok)

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

### Describe Agent Credentials
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-agent-credentials` (byok)

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

### Describe Mcp Server
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-mcp-server` (byok)

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

### Describe Mcp Servers
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-mcp-servers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | no |  |
| InstanceID | string | no |  |
| Statuses | array | no |  |
| Keyword | string | no |  |
| IDs | array | no |  |
| Modes | array | no |  |
| McpSecurityRuleID | string | no |  |
| McpSecurityRuleAct | string | no |  |
| PluginID | string | no |  |

### Describe Model
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-model` (byok)

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

### Describe Model Service
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-model-service` (byok)

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

### Describe Model Services
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-model-services` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| InstanceID | string | yes |  |
| Offset | integer | no |  |
| Limit | integer | no |  |
| IDs | array | no |  |
| NotIDs | array | no |  |
| Status | string | no |  |
| Keyword | string | no |  |
| ModelID | string | no |  |
| Sort | object | no |  |
| ModelProtocol | string | no |  |

### Describe Models
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-models` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| InstanceID | string | yes |  |
| Offset | integer | no |  |
| Limit | integer | no |  |
| IDs | array | no |  |
| NotIDs | array | no |  |
| CredentialID | string | no |  |
| Keyword | string | no |  |
| Sort | object | no |  |

### Describe Service
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-service` (byok)

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

### Describe Services
`POST https://www.apizie.tech/v1/cloud:tencent-apis/describe-services` (byok)

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

### Modify Agent App
`POST https://www.apizie.tech/v1/cloud:tencent-apis/modify-agent-app` (byok)

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

### Modify Agent App Model Services
`POST https://www.apizie.tech/v1/cloud:tencent-apis/modify-agent-app-model-services` (byok)

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

### Modify Agent Credential
`POST https://www.apizie.tech/v1/cloud:tencent-apis/modify-agent-credential` (byok)

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

### Modify Mcp Server
`POST https://www.apizie.tech/v1/cloud:tencent-apis/modify-mcp-server` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| ID | string | yes |  |
| Mode | string | yes |  |
| McpVersion | string | yes |  |
| InstanceID | string | yes |  |
| Name | string | yes |  |
| Description | string | no |  |
| WrapServices | array | no |  |
| TargetSelect | string | no |  |
| TargetHosts | array | no |  |
| HttpProtocolType | string | no |  |
| CheckTargetCertsError | boolean | no |  |
| TargetPath | string | no |  |
| IpWhiteStatus | boolean | no |  |
| IpWhiteConfig | object | no |  |
| IpBlackStatus | boolean | no |  |
| IpBlackConfig | object | no |  |
| TargetHostType | integer | no |  |
| CustomHttpHost | string | no |  |
| HttpHostType | string | no |  |
| Timeout | integer | no |  |
| McpSecurityRules | array | no |  |
| ToolConfigs | array | no |  |
| WrapPaasID | string | no |  |
| PluginConfigs | array | no |  |
| IgnoreHealthCheck | boolean | no |  |
| CredentialID | string | no |  |
| Domain | string | no |  |
| RequestProtocolType | string | no |  |

### Modify Model
`POST https://www.apizie.tech/v1/cloud:tencent-apis/modify-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| InstanceID | string | yes |  |
| ID | string | yes |  |
| Name | string | no |  |
| HttpProtocolType | string | no |  |
| TargetPath | string | no |  |
| TargetHosts | array | no |  |
| CredentialID | string | no |  |
| CheckTargetCertsError | boolean | no |  |
| HttpProtocolVersion | string | no |  |
| ModelID | string | no |  |
| Description | string | no |  |

### Modify Model Service
`POST https://www.apizie.tech/v1/cloud:tencent-apis/modify-model-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| InstanceID | string | yes |  |
| ID | string | yes |  |
| Name | string | no |  |
| Description | string | no |  |
| TargetModels | array | no |  |
| TmsStatus | boolean | no |  |
| TmsConfig | object | no |  |
| IpWhiteStatus | boolean | no |  |
| IpWhiteList | array | no |  |
| IpBlackStatus | boolean | no |  |
| IpBlackList | array | no |  |
| PluginConfigs | array | no |  |
| Timeout | integer | no |  |
| PromptModerateStatus | boolean | no |  |
| PromptModerateConfig | object | no |  |
| SensitiveDataCheckStatus | boolean | no |  |
| SensitiveDataCheckConfig | object | no |  |
| TargetSelect | string | no |  |
| FindHostKeyMethod | string | no |  |
| HostKeyHeaderName | string | no |  |
| FallbackStatus | boolean | no |  |
| FallbackModels | array | no |  |
| ModelProtocol | string | no |  |
| RawCustomModelProtocolConfig | string | no |  |
| RouteStrategy | string | no |  |
| TokenLengthRoute | array | no |  |
| TaskComplexityRoute | object | no |  |
| Domain | string | no |  |
| RequestProtocolType | string | no |  |

### Modify Service
`POST https://www.apizie.tech/v1/cloud:tencent-apis/modify-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| InstanceID | string | no |  |
| Name | string | no |  |
| Description | string | no |  |
| LabelIDs | array | no |  |
| CategoryIDs | array | no |  |
| TargetSelect | string | no |  |
| PubPath | string | no |  |
| RequestMethod | string | no |  |
| HttpProtocolType | string | no |  |
| CheckTargetCertsError | boolean | no |  |
| HttpProtocolVersion | string | no |  |
| Versions | array | no |  |
| TargetPath | string | no |  |
| RequestParamsValidatorStatus | boolean | no |  |
| RequestParamsValidatorJsonInfoT | string | no |  |
| ResponseParamsValidatorStatus | boolean | no |  |
| ResponseParamsValidatorJsonInfoT | string | no |  |
| HealthCheckStatus | boolean | no |  |
| HealthCheckConfig | object | no |  |
| SourceTypeStatus | boolean | no |  |
| SourceTypeConfig | object | no |  |
| IpWhiteStatus | boolean | no |  |
| IpWhiteList | array | no |  |
| IpBlackStatus | boolean | no |  |
| IpBlackList | array | no |  |
| PluginConfigs | array | no |  |
| ID | string | no |  |

## Example
```
curl "https://www.apizie.tech/v1/cloud:tencent-apis/create-agent-app" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud AI Agent Security Gateway API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/cloud:tencent-apis/create-agent-app with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Tencent Cloud AI Agent Security Gateway API?
Yes. Add the Apizie MCP server (https://www.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-apis.

### What is the status of the Tencent Cloud AI Agent Security Gateway API?
Needs your own provider key (bring your own key)