Image Translation Pro Version API Reference
The Image Translation Pro product is specifically designed for e-commerce images, integrating multimodal large model technology to achieve a more accurate understanding of images. It significantly improves translation quality and continues to expand and optimize multilingual translation capabilities.
Note: This is an asynchronous interface. You need to first submit a task and obtain a task ID, then call the result query interface to retrieve the generated results. The current API is the first step, the task submission API.
Request Parameter
Parameter
Parameter
Type
Required
Description
paramJson
Object[]
Yes
Request body, in JSON format.
targetLanguage
String
Yes
Target language code. Supporting languages as the appendix shows.
Sample: en
sourceLanguage
String
Yes
Source language code. Supporting languages as the appendix shows.
Sample: en
imageUrl
String
Yes
Image requirements:No more than 4000x4000 pixel. Size up to 10MB. Supporting png, jpeg, jpgm, bmp, webp.
includingProductArea
Boolean
No
Choose whether to translate the text within the main subject of images; this allows you to preserve and avoid translating embedded information such as product names.
As shown in the example image, the text in the red box represents the text on the main subject, while the text in the blue box represents text not on the main subject.
Sample: false
useImageEditor
Boolean
No
Whether it return layout information such as the position, font, and color of the text. This is used to obtain data for secondary editing when integrating with the image editor.
Sample: false
translatingBrandInTheProduct
Boolean
No
Choose whether to translate brand names on the image. This can help you preserve brand name information and prevent it from being translated.
Default:false(This means not translating the brand name.)
As shown in the example image,“懒角落”refers to a brand name
Sample:"false"
Sample Request
For other programming languages, please refer to Quick Start.
Response Parameters
Parameter
Type
Description
resCode
Number
Response code;200 indicates a successful call. For other response codes,please refer to the error code information.
resMessage
String
Error message,e.g. "content has sensitive data, please try other input".
data
Object
Result data that generated.
taskId
String
Unique task ID. Used for subsequent result queries.
Sample Response
Errors
Error
Code
Error Message
Description
501
rate limit exceed
700
invalid input
The format of the input parameters does not meet the requirements, and resMessage will return detailed fields that do not meet the requirements.
703
image size exceeds the limit
The image size in the request parameters exceeds the limit; the dimensions of the image must not exceed 4000x4000 pixels.
704
invalid image form
The image format in the request parameters is invalid.
705
image file size exceeds the
The image size in the request parameters exceeds the limit; the image size must not exceed 10MB.
801
model failed
900
tpp url error
1000
content has sensitive data, please try other input
Content has sensitive data, please try other input.
1001
content control failed, please retry
1002
content risk filter failed, please contact us
Appendix
The Image Translation Pro product supports image translation for the language pairs listed in the table below. We will continue to add more advantageous language pairs.
If you have specific needs, please contact us via Discord or email us (aidgesales@alibaba-inc.com).
Source language
Target language
●Chinese (Simplified)
●English
●Japanese
●Russian
●Thai
●English
●Spanish
●French
●German
●Korean
●Portuguese (Portugal)
●Japanese
Language Code
The language codes use the two-letter notation of the ISO 639-1 standard. For regional variants of specific languages, the RFC 5646 format is followed, which involves adding a hyphen after the language code and appending the two-letter country/region code from ISO 3166. For example, the language code for Spanish is es
.
Please refer to Language Code.
Last updated
Was this helpful?