跳转到主要内容
Qwen-MT-Image

Qwen-MT-Image — 同步调用

同步模式调用 qwen-mt-image-2.0 图像翻译,直接返回翻译后的图像 URL

同步模式下,请求会等待处理完成后直接返回翻译后的图像 URL,无需轮询任务状态。仅 qwen-mt-image-2.0 支持同步调用。 异步调用的区别:同步调用不需要设置 X-DashScope-Async 请求头,响应直接包含翻译后的图像地址。

请求

POST https://maas.qianwenaiapi.com/api/v1/services/aigc/image2image/image-synthesis

请求头

参数类型必选说明
Content-Typestring固定为 application/json
AuthorizationstringAPI Key 认证,格式:Bearer $DASHSCOPE_API_KEY
同步调用时不要设置 X-DashScope-Async: enable 请求头。设置该请求头将切换为异步模式。

请求体

参数类型必选说明
modelstring模型名称。同步调用仅支持 qwen-mt-image-2.0
inputobject输入参数
input.image_urlstring图像的公网 URL。支持 JPG/JPEG/PNG/BMP/TIFF/WEBP 格式,宽高 15-8192px,宽高比 1:10 至 10:1,不超过 100MB
input.source_langstring源语种。支持语种全称、语种编码或 auto(自动检测),大小写不敏感
input.target_langstring目标语种。支持语种全称或语种编码,大小写不敏感
input.extobject扩展参数
input.ext.domainHintstring领域提示,用英文描述翻译场景和风格需求,建议不超过 200 个英文单词
input.ext.sensitivesarray敏感词列表,完全匹配的文本将被跳过不翻译,大小写敏感
input.ext.terminologiesarray术语干预列表,每项包含 src(源文本)和 tgt(目标文本)
input.ext.config.imageSegmentboolean是否开启图像主体分割。开启后跳过图像主体(人物、商品、Logo)上文字的翻译。默认 false

请求示例

curl -X POST https://maas.qianwenaiapi.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"
    }
  }'

响应

响应参数

参数类型说明
output.image_urlstring翻译后的图像 URL,与原图尺寸相同,JPG 格式。有效期 24 小时,请及时下载保存
usage.image_countinteger生成图像数量,固定为 1
request_idstring请求唯一标识,用于问题排查

成功响应

{
  "output": {
    "image_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.jpg?Expires=xxx"
  },
  "usage": {
    "image_count": 1
  },
  "request_id": "b60d747a-adee-940a-aa3e-ac55b957189a"
}

错误响应

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

支持的语种

qwen-mt-image-2.0 支持以下 55 种语言的任意组合互译,无需源语种或目标语种为中文或英文。所有语种均可同时作为源语种和目标语种。 若不确定源语种,可将 source_lang 设置为 auto 进行自动检测。
语种English编码
简体中文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

扩展参数示例

使用领域提示和术语干预提高翻译质量:
curl -X POST https://maas.qianwenaiapi.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": ["全场9折", "七天无理由退换"],
        "terminologies": [
          {"src": "应用程序接口", "tgt": "API"},
          {"src": "机器学习", "tgt": "ML"}
        ],
        "config": {
          "imageSegment": true
        }
      }
    }
  }'