# Alibaba Cloud Machine Translation API

> Alibaba Cloud Machine Translation API on Apizie: 23 endpoints (The machine asynchronous translation job creation API supports translation of up to 1 million characters., Creates a document translation task, Create an asynchronous image translation job. Image translation includes capabilities such as OCR, text…, Retrieve the content of an asynchronous text translation 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://zieapi.vercel.app/v1/cloud:aliyun-alimt/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-alimt`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/alimt
- Page: https://zieapi.vercel.app/api/cloud/aliyun-alimt
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-alimt/openapi.json

Alibaba Cloud OpenAPI for Machine Translation (alimt, version 2018-10-12). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### The machine asynchronous translation job creation API supports translation of up to 1 million characters.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/create-async-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | yes | Source language. For language codes, see Language Code Reference… |
| TargetLanguage | string | yes | Target language. For language codes, see the reference |
| SourceText | string | yes | Content to be translated |
| Scene | string | yes | Scenario. Supported values include: general, title (product title), description (product description), message (buyer-seller… |
| FormatType | string | yes | The format of the text to translate: html (web page format; when this parameter is set, both the source text and the translated text are… |
| ApiType | string | yes | Version type. You must select one version: General-purpose Edition: translate_standard Professional Edition: translate_ecommerce |

### Creates a document translation task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/create-doc-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | yes | The source language. For more information, see Language codes… |
| TargetLanguage | string | yes | The target language. For more information, see Language codes… |
| FileUrl | string | yes | The URL of the document |
| Scene | string | no | The scenario. Valid values: \`general\`, \`title\` (product titles), \`description\` (product descriptions), \`message\` (buyer-seller… |
| CallbackUrl | string | no | The webhook address for the translation result. The server sends a POST request to this address. Request body Raw JSON Parameter… |
| ClientToken | string | no | Ensures idempotence. A request with the same client token is processed only once within 3 minutes |

### Create an asynchronous image translation job. Image translation includes capabilities such as OCR, text…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/create-image-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| UrlList | string | yes | The URLs of images for translation. Separate multiple image URLs with commas. The number of images cannot exceed 20 |
| SourceLanguage | string | yes | The source language of the image |
| TargetLanguage | string | yes | The target language for image translation |
| Extra | string | no | The following JSON format content contains optional parameters. You can omit any parameters you do not need. Example JSON format: ``` {… |
| ClientToken | string | no | Provides idempotency. Within 3 minutes, requests with the same value will take effect only once |

### Retrieve the content of an asynchronous text translation job
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-async-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| JobId | string | yes | Asynchronous job ID. This is the JobId returned when you invoke CreateAsyncTranslate to create an asynchronous job |

### Translates multiple text segments in batches by using machine translation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-batch-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| FormatType | string | yes | The format of the text to be translated. Valid values: html: Web page format. If you set this parameter to html, the source text and… |
| TargetLanguage | string | yes | The target language. For more information, see Language codes… |
| SourceLanguage | string | yes | The source language. For more information, see Language codes… |
| Scene | string | yes | The scenario. Valid values: Professional edition: title (product title), description (product description), communication (product… |
| ApiType | string | yes | The edition type. You must specify an edition. Valid values: translate_standard: General edition. translate_ecommerce: Professional edition |
| SourceText | string | yes | The source text in JSON format. key: A unique identifier used to map the translation result to the source text. value: The content to be… |

### Describes the language recognition API
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-detect-language` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| SourceText | string | yes | The source text for language recognition |

### Query a document translation job
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-doc-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| TaskId | string | yes | Job ID |

### Detects the language of text in an image
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-image-diagnose` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| Url | string | yes | Image link |
| Extra | string | no | Format content: { "product_id": "1", "platform": "ae" } product_id: Product ID platform: Platform to which the product belongs. Support… |

### Includes capabilities such as OCR, text translation, and text backfill.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-image-translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| Url | string | yes | The Image Link that requires translation |
| SourceLanguage | string | yes | The language of the text in the image. Supported language pairs and language codes… |
| TargetLanguage | string | yes | The language into which the text in the image is translated. Supported languages and language codes… |
| Extra | string | no | The following JSON format is used. You can omit any optional parameters you do not need. JSON format: ``` { "have_ocr": "false",… |

### Obtain the asynchronous image translation result by job ID.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-image-translate-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| TaskId | string | yes | Job ID of the asynchronous image translation task |

### By using the Product title quality Diagnosis service, a visualized title quality score is generated to help…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-title-diagnose` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| Title | string | yes | Title content |
| Language | string | yes | Language of the title text. Supported language directions and language codes… |
| Platform | string | yes | Platform to which the product title belongs. Supported platforms are ae, icbu, and lazada. |
| CategoryId | string | yes | Category ID. Pass 0 if no category data is available. |
| Extra | string | no | Optional field Format: { "product_id": "1", "platform": "ae" } product_id: Product ID platform: Platform to which the product belongs.… |

### Automatically optimize product titles based on e-commerce big data.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-title-generate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| Title | string | yes | Title content |
| Language | string | yes | Title language. Supported languages and language codes (https://help.aliyun.com/document_detail/182310.html) Supported languages and… |
| Platform | string | yes | Platform to which the product title belongs; supports ae/icbu |
| CategoryId | string | yes | Category ID; pass 0 if no category data is available |
| HotWords | string | no | Hot words |
| Attributes | string | no | Product properties; pass JSON data as shown in the Sample |
| Extra | string | no | Format: { "product_id": "1", "platform": "ae" } product_id: Product ID platform: Platform to which the product belongs |

### Automatically generate Product titles based on category, platform, and keywords.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-title-intelligence` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| Platform | string | yes | Platform where the Product is listed: ae, icbu, or lazada |
| Extra | string | no | Extension information in JSON data format; optional field |
| CatLevelThreeId | integer | yes | Third-level category ID; pass 0 if no category data is available. |
| CatLevelTwoId | integer | yes | Second-level category ID; pass 0 if no category data is available. |
| Keywords | string | no | Keywords, separated by English commas, such as: hello,apple |

### Retrieve the results of asynchronous batch image translation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-translate-image-batch-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| TaskId | string | yes | The task ID obtained by calling the asynchronous batch image translation API |

### Retrieves API call reports based on the API name and the start and end time, and returns the data aggregated…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/get-translate-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| BeginTime | string | yes | The start time in the YYYY-MM-DD HH:mm:ss format |
| EndTime | string | yes | The end time in the YYYY-MM-DD HH:mm:ss format |
| ApiName | string | yes | The API name. Valid values: translate_standard: Machine Translation General Edition translate_ecommerce: Machine Translation Professional… |
| Group | string | yes | The grouping method |

### Activates a machine translation service
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/open-alimt-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| Type | string | no | Machine translation: alimt Automated machine learning translation service: type = automl Certificate translation: type = ct Document… |

### Invoke Machine Translation Professional Edition to obtain translation results.
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/translate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| FormatType | string | yes | Format of the text to be translated: html (web page format; setting this parameter processes both the source and translated text as HTML)… |
| TargetLanguage | string | yes | Target language. Refer to language codes (https://help.aliyun.com/document_detail/215387.html) Refer to language codes… |
| SourceLanguage | string | yes | Source language. Refer to language codes (https://help.aliyun.com/document_detail/215387.html) Refer to language codes… |
| SourceText | string | yes | Content to be translated |
| Scene | string | yes | Available values for the scenario parameter: Product title (title), Product description (description), Product communication… |
| Context | string | no | Context information (optional) |

### Translate certificates
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/translate-certificate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| SourceLanguage | string | yes | Source language of the image |
| TargetLanguage | string | yes | Target language |
| ImageUrl | string | yes | OSS file URL: an HTTP URL that can be accessed without authorization |
| CertificateType | string | yes | Type of certificate to translate: ID card (idcard), driver's license (driving_license) |
| ResultType | string | no | Result Type: text or image. If no value is provided, the default is text |

### General-purpose translation API call instructions
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/translate-general` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| FormatType | string | yes | Format of the text to be translated: html (webpage format; setting this parameter processes both the source and translated text as HTML)… |
| SourceLanguage | string | yes | Source language. See language codes (https://help.aliyun.com/document_detail/215387.html) See language codes… |
| TargetLanguage | string | yes | Target language for translation. Refer to language codes (https://help.aliyun.com/document_detail/215387.html) Refer to language codes… |
| SourceText | string | yes | Content to be translated |
| Scene | string | no | The default value for the General-purpose Edition is: general |
| Context | string | no | Context information (optional) |

### Translate text in an image from one language to another and output a new image that is as faithful as…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/translate-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| ImageUrl | string | no | The URL of the source image. This parameter and Base64 cannot both be empty. Base64 takes precedence |
| ImageBase64 | string | no | The Base64-encoded source image. This parameter and URL cannot both be empty. Base64 takes precedence |
| SourceLanguage | string | no | Source language. For supported languages, see Language Reference (https://help.aliyun.com/document_detail/163584.html). This parameter is… |
| TargetLanguage | string | no | The target language. For supported languages, see Supported Languages (https://help.aliyun.com/document_detail/163584.html). This… |
| Field | string | no | The translation realm. Valid values: `general`: General image translation `e-commerce`: E-commerce image translation By default, or if the… |
| Ext | string | no | Extension information, in JSON string format. It may contain the following fields: `needEditorData`: A string value of `true` or `false`,… |

### Asynchronously translates text in a batch of images from one language to another and returns a new image for…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/translate-image-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| ImageUrls | string | yes | URLs of the source images. Separate multiple URLs with commas. A single request can include up to 20 URLs. Duplicate URLs are processed… |
| SourceLanguage | string | yes | Source language. For supported languages and their codes, see language codes (https://help.aliyun.com/document_detail/163584.html) |
| TargetLanguage | string | yes | Target language. For supported languages and their codes, see language codes (https://help.aliyun.com/document_detail/163584.html) |
| Ext | string | no | Extended information in JSON string format. Supported fields include the following. needEditorData: Set to `true` or `false`. Default is… |
| CustomTaskId | string | no | Custom task ID. Prevent accidental duplicate requests within a short time. Requests with the same custom task ID are processed only once… |
| Field | string | no | Translation domain. Valid values: `general`: General image translation `e-commerce`: E-commerce image translation If not specified or… |

### Translates search text
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/translate-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |
| FormatType | string | yes | The format of the text to translate. A value of text indicates that the text is processed as plain text, and a value of html indicates… |
| SourceLanguage | string | yes | The code of the source language |
| TargetLanguage | string | yes | The code of the target language |
| Scene | string | yes | The translation scenario. For search query scenarios, set the value to query |
| SourceText | string | yes | The search text to translate |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://mt.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-alimt/create-async-translate" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Machine Translation API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-alimt/create-async-translate with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Alibaba Cloud Machine Translation API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-alimt.

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