# Alibaba Cloud Real Translation Agent API

> Alibaba Cloud Real Translation Agent API on Apizie: 8 endpoints (Cancels a translation task that is currently running, Retrieves the download URL of the original file for a translation task, Retrieves the download URL of the translated file for a translation task, Retrieves the details of a translation 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:aliyun-realtranslationagent/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-realtranslationagent`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/realtranslationagent
- Page: https://apizie.tech/api/cloud/aliyun-realtranslationagent
- OpenAPI: https://apizie.tech/api/cloud/aliyun-realtranslationagent/openapi.json

Alibaba Cloud OpenAPI for Real Translation Agent (realtranslationagent, version 2026-06-22). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Cancels a translation task that is currently running
`POST https://apizie.tech/v1/cloud:aliyun-realtranslationagent/cancel-translation-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://realtranslationagent.aliyuncs.com |
| TaskId | string | yes | The task ID. The TaskId is returned after a task is submitted by calling SubmitTranslationTask. Only running tasks can be canceled |
| APIKey | string | no | The API key, the identity of member accounts. You can obtain it from the RuiYiBao console |

### Retrieves the download URL of the original file for a translation task
`POST https://apizie.tech/v1/cloud:aliyun-realtranslationagent/get-original-file-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://realtranslationagent.aliyuncs.com |
| TaskId | string | yes | The task ID. The TaskId is returned after a task is submitted by calling SubmitTranslationTask |
| APIKey | string | no | The API key that identifies a member account. You can obtain it from the Ruiyi Bao console |

### Retrieves the download URL of the translated file for a translation task
`POST https://apizie.tech/v1/cloud:aliyun-realtranslationagent/get-translated-file-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://realtranslationagent.aliyuncs.com |
| TaskId | string | yes | The task ID. The TaskId is returned after a task is submitted by calling SubmitTranslationTask |
| APIKey | string | no | The API key that identifies a member accounts identity. You can obtain the key from the RuiYiBao console |

### Retrieves the details of a translation task
`POST https://apizie.tech/v1/cloud:aliyun-realtranslationagent/get-translation-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://realtranslationagent.aliyuncs.com |
| TaskId | string | yes | The translation task ID, which is the TaskId obtained from UploadTranslationFile |
| APIKey | string | no | The API key that identifies a member accounts identity. You can obtain it from the RuiYiBao console |

### Queries translation tasks by paging
`POST https://apizie.tech/v1/cloud:aliyun-realtranslationagent/list-translation-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://realtranslationagent.aliyuncs.com |
| MaxResults | integer | no | The maximum number of results to return per request when using the NextToken-based pagination. Valid values: 1 to 100. Default value: 10 |
| NextToken | string | no | The pagination token |
| TaskId | string | no | The translation task ID, which is the TaskId obtained from UploadTranslationFile |
| OriginalFileName | string | no | The name of the source file |
| SourceLanguage | string | no | The language of the source file |
| TargetLanguage | string | no | The target language |
| Status | string | no | The task status. Valid values: CANCELLED: Cancelled. COMPLETED: Completed. FAILED: Failed. PROCESSING: Processing. PENDING: Pending.… |
| StartTime | string | no | The start time of the task. Format: YYYY-MM-dd HH:mm:ss |
| EndTime | string | no | The end time of the task. Format: YYYY-MM-dd HH:mm:ss |
| APIKey | string | no | The API key that identifies the identity of member accounts. You can obtain it from the RuiYiBao console |

### Submits a translation task. You can submit a new translation task by passing in a TaskId, or resubmit a…
`POST https://apizie.tech/v1/cloud:aliyun-realtranslationagent/submit-translation-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://realtranslationagent.aliyuncs.com |
| TaskId | string | no | The translation task ID. Obtained from the TaskId returned by UploadTranslationFile. You must pass in either this parameter or BaseTaskId |
| BaseTaskId | string | no | The translation task ID of a previously submitted translation task. Pass in this parameter when resubmitting a translation task. You must… |
| Config | string | yes | The translation configuration (JSON-encoded) |
| APIKey | string | no | The API key that identifies the identity of the member account. You can obtain this from the RuiYiBao console |
| CustomTerms | string | no | The custom terms. Custom terms are for reference only. Actual translation results may differ. Refer to the final output for the definitive… |

### Uploads a document, parses document-related information, and generates a translation task. After a…
`POST https://apizie.tech/v1/cloud:aliyun-realtranslationagent/upload-translation-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://realtranslationagent.aliyuncs.com |
| APIKey | string | no | The API key that identifies the identity of the member accounts. You can obtain it from the RuiYiBao console |
| File | string | yes | The file. The SDK supports direct upload and temporary authorized upload. Direct upload: Use UploadTranslationFileAdvance in the SDK for… |
| FileName | string | yes | The name of the uploaded file. Make sure the correct file name (including the extension) is provided. Otherwise, file parsing will fail. |

### version
`POST https://apizie.tech/v1/cloud:aliyun-realtranslationagent/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://realtranslationagent.aliyuncs.com |

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-realtranslationagent/cancel-translation-task" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Real Translation Agent API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-realtranslationagent/cancel-translation-task with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Alibaba Cloud Real Translation Agent 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:aliyun-realtranslationagent.

### What is the status of the Alibaba Cloud Real Translation Agent API?
Needs your own provider key (bring your own key)