POST Create Image Translation Tasks
Create Image Translation Tasks Shop Required scope: serller.product.optimize Initiates a translation task for one or more images. This asynchronous API queues the images for processing in the specified target language. Applicable only for sellers that sell across EU. Use the Image Translation Completed webhook
to monitor the translation progress, or pass the task ID to the Get Image Translation Tasks API
to retrieve the status and the translated images. Note:
- Please wait 5 minutes after task creation before calling the Get endpoint, and retry at intervals over 10 seconds to avoid rate limiting.
- Each task corresponds to the translation of 1 image into 1 target language.
- You can create up to 20 tasks per call and 500 tasks per day. Any tasks beyond the daily limit will be rejected. Version 202505
POST/product/202505/images/translation_tasks
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| shop_cipher Required | string | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. Get by API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| images Required | []object | The list of images to translate.Use the Upload Product Image API to upload the images first and obtain the corresponding image URIs.Note: The total number of image and target language combinations must not exceed 20. For example, you can submit 10 images with 2 target languages each, but you can't submit 10 images with 5 target languages each. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 12038008 | The image URI is invalid. Please use the URI generated by the Upload Product Image API. | | 12038009 | The specified target_language is invalid or unsupported. | | 12038010 | The number of translation task IDs exceeded the limit of 20. | | 12038012 | Exceeded the daily limit of 500 translation tasks. | | 12038013 | This operation is not available for this shop. |
Is this content helpful?Helpful
Not Helpful
PreviousNext