Skip to main content
阿里云百炼 home page阿里云百炼
千问

千问-图像翻译API参考

千问-图像翻译模型（Qwen-MT-Image）可精准翻译图像中的文字，并保留原始排版。该模型还支持领域提示、敏感词过滤、术语干预等自定义功能。

模型概览

1

源语种：中文

2

英文

3

日文

4

韩语

es

西班牙语

fr

法语

模型名称

模型简介

可用地域

输出图像规格

qwen-mt-image-2.0

专注做图片翻译的模型服务，能将中、英、日等55个语言的图片翻译到指定的语言，精准还原图片排版和内容信息。

支持术语定义、敏感词过滤、商品主体检测等自定义功能，提供灵活、准确、高效的图像本地化服务。

华北2（北京）

新加坡

图片格式：JPG。

qwen-mt-image

千问-图像翻译模型

支持中/英文与其他语种之间的互译，但不支持在非中/英语种之间直接翻译（例如，从日语翻译为韩语）。详情请参见支持的语种。

华北2（北京）

图片格式：JPG。

前提条件

您需要已获取与配置 API Key并配置API Key到环境变量。

同步调用

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis，调用时请将{WorkspaceId}替换为真实的Workspace ID。 同步模式下，请求会等待处理完成后直接返回翻译后的图像URL，无需轮询任务状态。

请求参数

请求头（Headers）
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。Authorizationstring（必选）请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。
请求体（Request Body）
model string （必选）模型名称，设置为qwen-mt-image-2.0或qwen-mt-image。input object （必选）输入参数对象，包含以下字段：

属性

image_url string （必选）图像的公网可访问的URL，支持 HTTP 和 HTTPS 协议。如需获取本地文件的公网URL，请参见上传文件获取临时URL 。
  • 格式限制：JPG、JPEG、PNG、BMP、PNM、PPM、TIFF、WEBP
  • 尺寸限制：图像的宽度和高度均需在15-8192像素范围内，宽高比在1:10至10:1范围内。
  • 大小限制：不超过100MB
  • URL地址中不能包含中文字符。
  • 示例：https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/ordhsk/1.webp
source_lang string （必选）源语种。
  • 支持值：语种全称、语种编码或auto（自动检测），对大小写不敏感
  • 限制：与target_lang不同。qwen-mt-image-2.0无语种限制；qwen-mt-image要求源语种或目标语种至少有一项为中文或英文。
  • 示例：Chinese、en、auto
target_lang string （必选）目标语种。
  • 支持值：语种全称或语种编码，对大小写不敏感
  • 限制：与source_lang不同。qwen-mt-image-2.0无语种限制；qwen-mt-image要求源语种或目标语种至少有一项为中文或英文。
  • 示例：Chinese、en
ext object （可选）可选拓展字段。

属性

domainHint string （可选）领域提示，为使译文风格更贴合特定领域，可以使用英文描述使用场景、译文风格等需求。为确保翻译效果，建议不超过200个英文单词。
领域提示语句当前只支持英文。
示例：These sentences are from seller-buyer conversations on a B2C ecommerce platform. Translate them into clear, engaging customer service language, ensuring the translation is appropriate for handling potential issues or disputes.sensitives array （可选）配置敏感词，以在翻译前过滤图片中完全匹配的文本，对大小写敏感。敏感词的语种可与源语种不一致，支持全部的源语种和目标语种。为确保翻译效果，建议单次请求添加的敏感词不超过50个。示例：["全场9折", "七天无理由退换"]terminologies array （可选）术语干预，为特定术语设定译文，以满足特定领域的翻译需求，术语对的语种需要与source_lang和target_lang对应。

属性

src string （必选）术语的源文本，语种需要与源语种source_lang一致。tgtstring （必选）术语的目标文本，语种需要与目标语种target_lang一致。
示例：[{"src": "应用程序接口", "tgt": "API"}, {"src": "机器学习", "tgt": "ML"}]config object （可选）

属性

imageSegmentbool （可选）是否开启图像主体分割。开启后，将跳过对图像中主体（如人物、商品、Logo）上文字的翻译。
  • false：（默认值）翻译图像中的所有文字。
  • true：不翻译图像主体的文字。
注意：旧版本参数名为skipImgSegment（是否跳过图像主体分割）。为保持兼容，该参数仍受支持，但建议使用新的 imageSegment参数。
  • curl
  • Python
# 以下为华北2（北京）地域的URL。请将 {WorkspaceId} 替换为您的百炼业务空间ID，各地域的URL不同。
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "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 object输出信息。

属性

image_url string模型生成图像的URL地址，与原图长宽相同，JPG格式。有效期为24小时，请及时下载并保存图像。
usage object输出信息统计。只对成功的结果计数。

属性

image_count integer模型生成图像的数量，固定为1。
request_idstring请求唯一标识。可用于请求明细溯源和问题排查。codestring请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误码。
  • 成功响应
  • 异常响应
{
    "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"
}

异步调用

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis，调用时请将{WorkspaceId}替换为真实的Workspace ID。 异步调用流程分两步：
  1. 创建任务获取任务ID：发送一个请求创建任务，该请求会返回任务ID（task_id）。
  2. 根据任务ID查询结果：使用task_id轮询任务状态，直到任务完成并获得图像URL。

步骤1：创建任务获取任务ID

  • 创建成功后，使用接口返回的 task_id 查询结果，task_id 有效期为 24 小时。请勿重复创建任务，轮询获取即可。
  • 新手指引请参见Postman。

请求参数

请求头（Headers）
Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。Authorizationstring（必选）请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。X-DashScope-Asyncstring（必选）异步处理配置参数。必须设置为enable。
缺少此请求头将使用同步模式（仅qwen-mt-image-2.0支持同步）。qwen-mt-image模型必须设置此请求头。
请求体（Request Body）
model string （必选）模型名称，设置为qwen-mt-image-2.0或qwen-mt-image。input object （必选）输入参数对象，包含以下字段：

属性

image_url string （必选）图像的公网可访问的URL，支持 HTTP 和 HTTPS 协议。如需获取本地文件的公网URL，请参见上传文件获取临时URL 。
  • 格式限制：JPG、JPEG、PNG、BMP、PNM、PPM、TIFF、WEBP
  • 尺寸限制：图像的宽度和高度均需在15-8192像素范围内，宽高比在1:10至10:1范围内。
  • 大小限制：不超过100MB
  • URL地址中不能包含中文字符。
  • 示例：https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/ordhsk/1.webp
source_lang string （必选）源语种。
  • 支持值：语种全称、语种编码或auto（自动检测），对大小写不敏感
  • 限制：与target_lang不同。qwen-mt-image-2.0无语种限制；qwen-mt-image要求源语种或目标语种至少有一项为中文或英文。
  • 示例：Chinese、en、auto
target_lang string （必选）目标语种。
  • 支持值：语种全称或语种编码，对大小写不敏感
  • 限制：与source_lang不同。qwen-mt-image-2.0无语种限制；qwen-mt-image要求源语种或目标语种至少有一项为中文或英文。
  • 示例：Chinese、en
ext object （可选）可选拓展字段。

属性

domainHint string （可选）领域提示，为使译文风格更贴合特定领域，可以使用英文描述使用场景、译文风格等需求。为确保翻译效果，建议不超过200个英文单词。
领域提示语句当前只支持英文。
示例：These sentences are from seller-buyer conversations on a B2C ecommerce platform. Translate them into clear, engaging customer service language, ensuring the translation is appropriate for handling potential issues or disputes.sensitives array （可选）配置敏感词，以在翻译前过滤图片中完全匹配的文本，对大小写敏感。敏感词的语种可与源语种不一致，支持全部的源语种和目标语种。为确保翻译效果，建议单次请求添加的敏感词不超过50个。示例：["全场9折", "七天无理由退换"]terminologies array （可选）术语干预，为特定术语设定译文，以满足特定领域的翻译需求，术语对的语种需要与source_lang和target_lang对应。

属性

src string （必选）术语的源文本，语种需要与源语种source_lang一致。tgtstring （必选）术语的目标文本，语种需要与目标语种target_lang一致。
示例：[{"src": "应用程序接口", "tgt": "API"}, {"src": "机器学习", "tgt": "ML"}]config object （可选）

属性

imageSegmentbool （可选）是否开启图像主体分割。开启后，将跳过对图像中主体（如人物、商品、Logo）上文字的翻译。
  • false：（默认值）翻译图像中的所有文字。
  • true：不翻译图像主体的文字。
注意：旧版本参数名为skipImgSegment（是否跳过图像主体分割）。为保持兼容，该参数仍受支持，但建议使用新的 imageSegment参数。
  • curl
  • Python
# 以下为华北2（北京）地域的URL。请将 {WorkspaceId} 替换为您的百炼业务空间ID，各地域的URL不同。
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "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",
        "ext": {
            "config": {
                "imageSegment": false
            }
        }
    }
}'

响应参数

output object任务输出信息。

属性

task_id string任务ID。查询有效期24小时。task_status string任务状态。

枚举值

  • PENDING：任务排队中
  • RUNNING：任务处理中
  • SUCCEEDED：任务执行成功
  • FAILED：任务执行失败
  • CANCELED：任务已取消
  • UNKNOWN：任务不存在或状态未知
request_idstring请求唯一标识。可用于请求明细溯源和问题排查。messagestring请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误码。codestring请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。
  • 成功响应
  • 异常响应
请保存 task_id，用于查询任务状态与结果。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

步骤2：根据任务ID查询结果

GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}
  • task_id 有效期为24小时，若ID不存在或已过期，任务状态将返回 UNKNOWN。
  • 任务成功后返回的 url有效期为24小时，请及时下载并保存图像。
  • 此查询接口的默认RPS为1。如需更高频次的查询或事件通知，请配置异步任务回调。
  • 如需批量查询或取消任务，请参见管理异步任务。

请求参数

请求头（Headers）
Authorizationstring（必选）请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。
URL路径参数（Path parameters）
task_id string（必选）任务ID。
  • 查询任务结果
您需要将86ecf553-d340-4e21-xxxxxxxxx替换为真实的task_id。
# 以下为华北2（北京）地域的URL。请将 {WorkspaceId} 替换为您的百炼业务空间ID，各地域的URL不同。
curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

响应参数

outputobject任务输出信息。

属性

task_id string任务ID。查询有效期24小时。task_status string任务状态。

枚举值

  • PENDING：任务排队中
  • RUNNING：任务处理中
  • SUCCEEDED：任务执行成功
  • FAILED：任务执行失败
  • CANCELED：任务已取消
  • UNKNOWN：任务不存在或状态未知
submit_time string任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。scheduled_time string任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。end_time string任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。image_url string模型生成图像的URL地址，与原图长宽相同，JPG格式。有效期为24小时，请及时下载并保存图像。codestring请求失败的错误码。请求成功时不会返回此参数，详情请参见错误码。messagestring请求失败的详细信息，详情请参见错误码。通常请求成功时不会返回此参数，仅在图像中无可翻译文本（例如，在分割图像主体后，其余部分无文字）时，任务仍会成功并正常计费，但会返回No text detected for translation的提示。
usage object输出信息统计。只对成功的结果计数。

属性

image_count integer模型生成图像的数量，固定为1。
request_idstring请求唯一标识。可用于请求明细溯源和问题排查。
  • 任务执行成功-存在可翻译内容
  • 任务执行成功-无可翻译内容
  • 任务执行失败
任务数据（如任务状态、图像URL等）仅保留24小时，超时后会被自动清除。请您务必及时保存生成的图像。
{
    "request_id": "5fec62eb-bf94-91f8-b9f4-f7f758e4e27e",
    "output": {
        "task_id": "72c52225-8444-4cab-ad0c-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-08-13 18:11:16.954",
        "scheduled_time": "2025-08-13 18:11:17.003",
        "end_time": "2025-08-13 18:11:23.860",
        "image_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx"
    },
    "usage": {
        "image_count":1
    }
}

支持的语种

若不确定源语种，可将 source_lang 设置为 auto 进行自动检测。

qwen-mt-image-2.0 支持的语种

qwen-mt-image-2.0支持以下55种语言的任意组合互译，无需源语种或目标语种为中文或英文。所有语种均可作为源语种和目标语种。
语种（中文名）英文全称编码
简体中文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

qwen-mt-image 支持的语种

qwen-mt-image要求源语种或目标语种必须至少有一种是中文或英文，不支持在两个非中、英语种之间直接翻译（例如，从日语翻译为韩语）。
语种（中文名）英文全称编码支持作为源语种支持作为目标语种
简体中文Chinesezh支持支持
英文Englishen支持支持
韩语Koreanko支持支持
日语Japaneseja支持支持
俄语Russianru支持支持
西班牙语Spanishes支持支持
法语Frenchfr支持支持
葡萄牙语Portuguesept支持支持
意大利语Italianit支持支持
德语Germande支持不支持
越南语Vietnamesevi支持支持
马来语Malayms不支持支持
泰语Thaith不支持支持
印尼语Indonesianid不支持支持
阿拉伯语Arabianar不支持支持

计费与限流

  • 模型免费额度和计费单价请参见模型价格。
  • 模型限流请参见限流。
  • 计费说明：按成功生成的图像张数计费。模型调用失败或处理错误不产生任何费用，也不消耗新人免费额度。
  • 注意：如果图像中无可翻译文本，或在启用主体识别功能后，非主体部分无文字时，任务仍记为成功并正常计费，此时接口会返回No text detected for translation的提示。

错误码

如果模型调用失败并返回报错信息，请参见错误码进行解决。

常见问题

Q：为什么图中的内容没有被翻译？

A：因为启用了主体分割功能，模型不会翻译图片中人物、商品、Logo等主体上的文字。若需翻译所有文字，请将ext.config.imgSegment参数设置为false。

Q：如何将临时的图像链接转为永久链接？

A：临时链接无法直接转为永久链接。需通过后端服务下载图像，再上传至对象存储服务（如阿里云 OSS）以生成新的永久链接。 
import requests

def download_and_save_image(image_url, save_path):
  try:
    response = requests.get(image_url, stream=True, timeout=300)
    response.raise_for_status()
    with open(save_path, 'wb') as f:
      for chunk in response.iter_content(chunk_size=8192):
        f.write(chunk)
    print(f"图像已成功下载到: {save_path}")
  except requests.exceptions.RequestException as e:
    print(f"图像下载失败: {e}")

if __name__ == '__main__':
  image_url = "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx?Expires=xxx"
  save_path = "image-translation.jpg"
  download_and_save_image(image_url, save_path)

Q: 如何查看模型调用量？

A: 模型调用完一小时后，请在模型监控（北京）或模型监控（新加坡） 页面，查看模型的调用次数、成功率等指标。详情请参见账单查询与成本管理。

Q：如何获取图像存储的访问域名白名单？

A： 模型生成的图像存储于阿里云OSS，API将返回一个临时的公网URL。若需要对该下载地址进行防火墙白名单配置，请注意：由于底层存储会根据业务情况进行动态变更，为避免过期信息影响访问，文档不提供固定的OSS域名白名单。如有安全管控需求，请联系客户经理获取最新OSS域名列表。

Q：翻译后的文字没有覆盖原内容，出现格式错位怎么办？

A：复杂排版（如多列文本、混合字体大小）的图片在翻译后容易出现文字错位，属于已知的模型限制。建议将复杂排版的图片分割为简单区域后分别翻译，即可规避此问题。
阿里云百炼 home page阿里云百炼
使用 API
文本生成
图像生成
视频生成
3D模型生成
音频
实时多模态
Realtime API
  • 概述
向量与排序
更多模型
工具包/框架
模型生产
文件管理
更多