# Alibaba Cloud TongyiTranslate API

> Alibaba Cloud TongyiTranslate API on Apizie: 13 endpoints (Performs batch translation using the Qwen multimodal translation model, Gets the results of a document translation task from Tongyi Multimodal Translation, Retrieves the result of an HTML translation task from Tongyi Multimodal Translation, Tongyi Multimodal Translation: Getting image translation results, …) 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-anytrans/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for TongyiTranslate (anytrans, version 2025-07-07). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Performs batch translation using the Qwen multimodal translation model
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/batch-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Alibaba Cloud Model Studio workspace used for the current request |
| sourceLanguage | string | yes | The source language |
| targetLanguage | string | yes | The target language |
| text | string | yes | The batch text to be translated (JSON-encoded) |
| scene | string | no | The translation model |
| format | string | no | The translation format |
| appName | string | no | The call source |
| ext | string | no | The extended parameters for controlling translation features (JSON-encoded) |

### Gets the results of a document translation task from Tongyi Multimodal Translation
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/get-doc-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace |
| taskId | string | yes | The document translation task ID |

### Retrieves the result of an HTML translation task from Tongyi Multimodal Translation
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/get-html-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace |
| taskId | string | no | The ID of the HTML translation task |

### Tongyi Multimodal Translation: Getting image translation results
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/get-image-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the workspace |
| taskId | string | yes | The ID of the image translation task |

### Get document translations from Tongyi Multimodal Translation
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/get-long-text-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace |
| taskId | string | no | The ID of the long-text translation task |

### Submit a document translation task to Tongyi Multimodal Translation
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/submit-doc-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace for the current request |
| format | string | no | The format for the translation |
| sourceLanguage | string | yes | The source language code |
| targetLanguage | string | no | The target language code |
| text | string | yes | The URL of the document to translate |
| scene | string | yes | The translation model |
| ext | string | no | Extension parameters that control translation features (JSON-encoded) |

### Submitting an HTML translation task with Tongyi Multimodal Translation
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/submit-html-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace used for this request |
| format | string | no | The format of the input text |
| sourceLanguage | string | no | The source language |
| targetLanguage | string | no | The target language |
| text | string | no | The HTML content to be translated |
| scene | string | no | The translation model |
| ext | string | no | Extended parameters to control translation behavior (JSON-encoded) |

### Use Tongyi multimodal translation to submit an image for translation
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/submit-image-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace |
| format | string | no | The translation format |
| sourceLanguage | string | yes | The source language |
| targetLanguage | string | yes | A list of target languages (JSON-encoded) |
| text | string | yes | The URL of the image to translate |
| scene | string | yes | Specifies the translation model |
| ext | string | no | Extended parameters to control translation features (JSON-encoded) |

### Submitting a long text translation task using Translate Multimodal
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/submit-long-text-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace |
| format | string | no | The format of the source text |
| sourceLanguage | string | no | The language code of the source language |
| targetLanguage | string | no | The language code of the target language |
| text | string | no | The long source text to translate |
| scene | string | no | The translation model |
| ext | string | no | A container for extended parameters that control translation features (JSON-encoded) |

### Editing the Tongyi Multimodal Translation termbase
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/term-edit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace |
| action | string | yes | The action type |
| sourceLanguage | string | yes | The source language. The value must be a valid BCP-47 language code |
| targetLanguage | string | yes | The target language. The value must be a valid BCP-47 language code |
| scene | string | yes | The model type |
| ext | string | yes | The extended parameters (JSON-encoded) |

### Queries the terminology database for Qwen multimodal machine translation
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/term-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace used for the current request |
| sourceLanguage | string | yes | The source language |
| targetLanguage | string | yes | The target language |
| scene | string | yes | The translation model |
| text | string | no | The input sentence that contains terminology interventions |
| ext | string | no | The extended parameters (JSON-encoded) |

### Translates text using the Tongyi multimodal translation service
`POST https://apizie.tech/v1/cloud:aliyun-anytrans/text-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://anytrans.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The workspace ID |
| format | string | no | The text format |
| sourceLanguage | string | yes | The source language code |
| targetLanguage | string | yes | The target language code |
| text | string | yes | The text to be translated |
| scene | string | no | The model type |
| ext | string | no | The extended parameters that control translation behavior (JSON-encoded) |

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

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

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-anytrans/batch-translate" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud TongyiTranslate API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-anytrans/batch-translate with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Alibaba Cloud TongyiTranslate 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-anytrans.

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