Skip to main content
QwenCloud home page
Docs
Qwen-MT-Image

Qwen-MT-Image — Synchronous

Call qwen-mt-image-2.0 image translation synchronously and receive the translated image URL directly

Get an API Key and set it as an environment variable.
In synchronous mode, the request waits for processing to complete and returns the translated image URL directly — no task polling needed. Only qwen-mt-image-2.0 supports synchronous calls. Difference from asynchronous calls: synchronous calls do not require the X-DashScope-Async header, and the response contains the translated image URL immediately.

Request

POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis

Headers

ParameterTypeRequiredDescription
Content-TypestringYesMust be application/json
AuthorizationstringYesAPI Key authentication: Bearer $DASHSCOPE_API_KEY
Do not set the X-DashScope-Async: enable header for synchronous calls. Setting it switches to asynchronous mode.

Request body

ParameterTypeRequiredDescription
modelstringYesModel name. Synchronous mode only supports qwen-mt-image-2.0
inputobjectYesInput parameters
input.image_urlstringYesPublic URL of the image. Supports JPG/JPEG/PNG/BMP/TIFF/WEBP, 15-8192px width/height, aspect ratio 1:10 to 10:1, max 100MB
input.source_langstringYesSource language. Accepts full name, language code, or auto (auto-detect), case-insensitive
input.target_langstringYesTarget language. Accepts full name or language code, case-insensitive
input.extobjectNoExtension parameters
input.ext.domainHintstringNoDomain hint in English describing the translation context and style, max 200 words
input.ext.sensitivesarrayNoSensitive words list — exact matches will be skipped during translation, case-sensitive
input.ext.terminologiesarrayNoTerminology list, each item has src (source text) and tgt (target text)
input.ext.config.imageSegmentbooleanNoEnable image subject segmentation. When enabled, text on subjects (people, products, logos) is skipped. Default false

Request examples

curl -X POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-mt-image-2.0",
    "input": {
      "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/ordhsk/1.webp",
      "source_lang": "zh",
      "target_lang": "en"
    }
  }'

Response

Response parameters

ParameterTypeDescription
output.image_urlstringURL of the translated image, same dimensions as the original, JPG format. Valid for 24 hours — download promptly
usage.image_countintegerNumber of generated images, always 1
request_idstringUnique request identifier for troubleshooting

Success response

{
  "output": {
    "image_url": "https://dashscope-result-sg.oss-ap-southeast-1.aliyuncs.com/xxx.jpg?Expires=xxx"
  },
  "usage": {
    "image_count": 1
  },
  "request_id": "b60d747a-adee-940a-aa3e-ac55b957189a"
}

Error response

{
  "code": "InvalidApiKey",
  "message": "No API-key provided.",
  "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

Supported languages

qwen-mt-image-2.0 supports translation between any combination of the following 55 languages — no restriction requiring Chinese or English as source/target. Set source_lang to auto for automatic language detection.
LanguageCode
Simplified Chinesezh
Traditional Chinesezh-tw
Englishen
Japaneseja
Koreanko
Germande
Spanishes
Russianru
Frenchfr
Portuguesept
Italianit
Vietnamesevi
Indonesianid
Malayms
Thaith
Arabicar
Dutchnl
Polishpl
Turkishtr
Ukrainianuk
Greekel
Hungarianhu
Romanianro
Czechcs
Swedishsv
Danishda
Finnishfi
Norwegianno
Hindihi
Tamilta
Telugute
Nepaline
Persianfa
Azerbaijaniaz
Kazakhkk
Uzbekuz
Mongolianmn
Uyghurug
Belarusianbe
Bulgarianbg
Serbiansr
Croatianhr
Bosnianbs
Sloveniansl
Slovaksk
Macedonianmk
Latvianlv
Lithuanianlt
Irishga
Luxembourgishlb
Afrikaansaf
Latinla
Chechence
Ingushinh
Marichm

Extended parameters example

Use domain hint and terminology to improve translation quality: 
curl -X POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-mt-image-2.0",
    "input": {
      "image_url": "https://example.com/product-image.jpg",
      "source_lang": "zh",
      "target_lang": "en",
      "ext": {
        "domainHint": "These are product descriptions on a B2C ecommerce platform. Use clear and engaging marketing language.",
        "sensitives": ["SALE", "Limited Time"],
        "terminologies": [
          {"src": "API", "tgt": "API"},
          {"src": "ML", "tgt": "ML"}
        ],
        "config": {
          "imageSegment": true
        }
      }
    }
  }'