AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 大模型服务平台百炼 API参考（模型） 图像生成 通义千问-图像翻译

通义千问-图像翻译API参考

更新时间：
产品详情
我的收藏

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

重要

本文档仅适用于“中国大陆（北京）”地域，且必须使用该地域的API Key。

模型概览

效果示例

1

源语种：中文

2

英文

3

日文

4

韩语

es

西班牙语

fr

法语

模型与价格

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

模型名称

计费单价

限流（主账号与RAM子账号共用）

免费额度（查看）

任务下发接口RPS限制

同时处理中任务数量

qwen-mt-image

0.003元/张

1

2

100张

有效期：百炼开通后90天内

计费规则

  • 计费方式：按成功生成的图像张数计费，当任务成功 (task_status 为 SUCCEEDED) 并成功生成图像后，会计费。

  • 注意：如果图像中无可翻译文本，或在启用主体识别功能后，非主体部分无文字时，任务仍会成功并正常计费，此时接口会返回No text detected for translation的提示。

  • 模型调用失败或处理错误不产生任何费用，也不消耗免费额度。

  • 您可开启“免费额度用完即停”功能，以避免免费额度耗尽后产生额外费用。详情请参见免费额度。

HTTP调用

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

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

由于图像翻译耗时较长，HTTP API 采用异步模式，调用流程分两步：

  1. 创建任务获取任务ID：发送一个请求创建任务，该请求会返回任务ID（task_id）。

  2. 根据任务ID查询结果：使用task_id轮询任务状态，直到任务完成并获得图像URL。

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

说明

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

  • 新手指引请参见Postman。

请求参数

图像翻译

curl --location 'https://dashscope.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",
    "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"
    }
}'

请求头（Headers）

Content-Type string （必选）

请求内容类型。此参数必须设置为application/json。

Authorization string（必选）

请求身份认证。接口使用阿里云百炼API-Key进行身份认证。示例值：Bearer sk-xxxx。

X-DashScope-Async string （必选）

异步处理配置参数。HTTP请求只支持异步，必须设置为enable。

重要

缺少此请求头将报错：“current user api does not support synchronous calls”。

请求体（Request Body）

model string （必选）

模型名称，需要设置为qwen-mt-image。

input object （必选）

输入参数对象，包含以下字段：

属性

image_url string （必选）

图像的公网可访问的URL，支持 HTTP 或 HTTPS 协议。

  • 格式限制：JPG、JPEG、PNG、BMP、PNM、PPM、TIFF、WEBP

  • 尺寸限制：图像的宽度和高度均需在15-8192像素范围内，宽高比在1:10至10:1范围内。

  • 大小限制：不超过10MB

  • URL地址若包含中文等非ASCII字符，需进行URL编码后再传入。

    URL编码

    from urllib.parse import quote

# 请替换下面的URL为需要编码的URL
url = "https://example.com/搜索?q=测试&page=1"
encoded_url = quote(url, safe=':/?#[]@!$&\'()*+,;=%')
print(f"原始URL: {url}")
print(f"编码后的URL: {encoded_url}")

  • 示例：https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/ordhsk/1.webp

source_lang string （必选）

源语种。

  • 支持值：语种全称、语种编码或auto（自动检测），对大小写不敏感

  • 限制：与target_lang不同，且至少有一项为中文或英文

  • 示例：Chinese、en、auto

target_lang string （必选）

目标语种。

  • 支持值：语种全称或语种编码，对大小写不敏感

  • 限制：与source_lang不同，且至少有一项为中文或英文

  • 示例：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一致。

tgt string （必选）

术语的目标文本，语种需要与目标语种target_lang一致。

示例：[{"src": "应用程序接口", "tgt": "API"}, {"src": "机器学习", "tgt": "ML"}]

config object （可选）

属性

skipImgSegment bool （可选）

用于控制是否跳过主体检测，翻译图像中主体（如人物、商品、Logo）上的文字。

  • false ：默认值，进行主体检测，不翻译主体上的文字。

  • true: 不进行主体检测，将图像主体上的文字一并翻译。

响应参数

成功响应

请保存 task_id，用于查询任务状态与结果。

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

异常响应

创建任务失败，请参见错误信息进行解决。

{
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-xxxxxx"
}

output object

任务输出信息。

属性

task_id string

任务ID。查询有效期24小时。

task_status string

任务状态。

枚举值

  • PENDING：任务排队中

  • RUNNING：任务处理中

  • SUCCEEDED：任务执行成功

  • FAILED：任务执行失败

  • CANCELED：任务已取消

  • UNKNOWN：任务不存在或状态未知

request_id string

请求唯一标识。可用于请求明细溯源和问题排查。

message string

请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误信息。

code string

请求失败的错误码。请求成功时不会返回此参数，详情请参见错误信息。

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

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

说明

  • 模型处理耗时约15秒。建议采用轮询机制，并设置合理的查询间隔（如5秒）来获取结果。

  • task_id 有效期为24小时，若ID不存在或已过期，任务状态将返回 UNKNOWN。

  • 任务成功后返回的 url有效期为24小时，请及时下载并保存图像。

  • 此查询接口的默认QPS为1。如需更高频次的查询或事件通知，请配置异步任务回调。

  • 如需批量查询或取消任务，请参见管理异步任务。

请求参数

查询任务结果

您需要将86ecf553-d340-4e21-xxxxxxxxx替换为真实的task_id。

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
请求头（Headers）

Authorization string（必选）

请求身份认证。接口使用阿里云百炼API-Key进行身份认证。示例值：Bearer sk-xxxx。

URL路径参数（Path parameters）

task_id string（必选）

任务ID。

响应参数

任务执行成功

任务数据（如任务状态、图像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
    }
}

任务执行失败

若任务执行失败，task_status将置为 FAILED，并提供错误码和信息。请参见错误信息进行解决。

{
    "request_id": "daad9007-6acd-9fb3-a6bc-d55902b9c9ff",
    "output": {
        "task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
        "task_status": "FAILED",
        "submit_time": "2025-08-20 09:54:21.911",
        "scheduled_time": "2025-08-20 09:54:21.984",
        "end_time": "2025-08-20 12:55:00.818",
        "code": "InternalError",
        "message": "xxxxxx"
    }
}

output object

任务输出信息。

属性

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小时，请及时下载并保存图像。

code string

请求失败的错误码。请求成功时不会返回此参数，详情请参见错误信息。

message string

请求失败的详细信息，详情请参见错误信息。

通常请求成功时不会返回此参数，仅在图像中无可翻译文本（例如，在识别出图像主体后，其余部分无文字）时，请求仍会成功并正常计费，但会返回No text detected for translation的提示。

usage object

输出信息统计。只对成功的结果计数。

属性

image_count integer

模型生成图像的数量，固定为1。

request_id string

请求唯一标识。可用于请求明细溯源和问题排查。

支持的语种

进行图像翻译时，源语种或目标语种必须至少有一种是中文或英文。不支持在两个非中、英语种之间直接翻译（例如，从日语翻译为韩语）。若不确定源语种，可将 source_lang 设置为 auto 进行自动检测。

语种（中文名）

英文全称

编码

支持作为源语种

支持作为目标语种

简体中文

Chinese

zh

支持

支持

英文

English

en

支持

支持

韩语

Korean

ko

支持

支持

日语

Japanese

ja

支持

支持

俄语

Russian

ru

支持

支持

西班牙语

Spanish

es

支持

支持

法语

French

fr

支持

支持

葡萄牙语

Portuguese

pt

支持

支持

意大利语

Italian

it

支持

支持

德语

Germany

de

支持

不支持

越南语

Vietnamese

vi

支持

支持

马来语

Malay

ms

不支持

支持

泰语

Thai

th

不支持

支持

印尼语

Indonesian

id

不支持

支持

阿拉伯语

Arabian

ar

不支持

支持

图像访问权限配置

图像存储于阿里云 OSS，链接允许公开访问，仅在 24 小时内有效。如果业务系统因安全策略无法访问阿里云OSS链接，请将以下 OSS 域名加入网络访问白名单。

dashscope-result-bj.oss-cn-beijing.aliyuncs.com
dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com
dashscope-result-sh.oss-cn-shanghai.aliyuncs.com
dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com
dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com
dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com
dashscope-result-hy.oss-cn-heyuan.aliyuncs.com
dashscope-result-cd.oss-cn-chengdu.aliyuncs.com
dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com
dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com

错误码

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

常见问题

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() # 如果HTTP状态码不是200，则引发异常
        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: 模型调用完一小时后，请在模型观测页面，查看模型的调用次数、成功率等指标。如何查看模型调用记录

上一篇：通义千问-图像编辑下一篇：通义万相-文生图V2