Get Image Translation Tasks

GET

/product/202506/images/translation_tasks

Retrieves the image translation task status and translated images for one or more previously submitted images. Note: Please wait 5 minutes after task creation before calling this API, and retry at intervals over 10 seconds to avoid rate limiting. Applicable only for sellers that sell across EU.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

translation_task_ids

Array<string>

<= 20 items

The image translation task IDs for retrieving translation results. Max count: 20

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

translation_tasks

The requested translation tasks and the corresponding results. Each task corresponds to the translation of 1 image into 1 target language.

Array<object>

object

original_image

The original image to be translated.

object

uri

The URI of the original image.

string

url

The URL of the original image.

string

id

The ID to identify the image translation task.

string

target_language

The target language to translate the image into. Possible values:

• de-DE
• en-IE
• es-ES
• fr-FR
• it-IT

string

Allowed values: de-DE en-IE es-ES fr-FR it-IT

status

The translation result. Possible values:

• PROCESSING: Translation is underway and has not yet completed.
• COMPLETED: Translation has completed and results are ready.
• FAILED: Translation did not complete due to an error.

string

Allowed values: PROCESSING COMPLETED FAILED

fail_reason

The reason why the translation task failed. Possible values:

• Invalid image URI.
• Internal processing error, please try calling this endpoint again.
• This image can’t be translated. Try a different image.

string

translated_image

The translated image.

object

uri

The URI of the translated image.

string

url

The URL of the translated image.

string

Example

{
  "code": 0,
  "data": {
    "translation_tasks": [
      {
        "original_image": {
          "uri": "tos-useast2a-i-tulkllf4y5-euttp/748e39ecff38453ab8396a36a53dbb92",
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/sample.jpeg"
        },
        "id": "764c6e87eedcea90399a0dafcd572b71",
        "target_language": "it-IT",
        "status": "COMPLETED",
        "fail_reason": "This image can't be translated. Try a different image.",
        "translated_image": {
          "uri": "tos-maliva-i-o3syd03w52-us/53b55d6e8cdf1f315affa7e70b45707d",
          "url": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/sample.jpeg"
        }
      }
    ]
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}