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

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

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

通义千问-图像翻译模型（Qwen-MT-Image）支持将11种语言图片的文字翻译成中文或英文，能精准保留原始排版与内容信息，并提供术语定义、敏感词过滤、图像主体检测等自定义功能。

模型概览

效果示例

en

原图

ja

日语

es

葡语

ar

阿拉伯语

支持的语言

翻译方向必须以中文或英文作为源语种或目标语种。不支持在其他语种之间互译（如：日文译为韩文）。若不确定源语种，可设置为自动检测。

源语种（中文名）

源语种（英文全称）

源语种（编码）

简体中文

Chinese

zh

英文

English

en

韩语

Korean

ko

日语

Japanese

ja

俄语

Russian

ru

西语

Spanish

es

法语

French

fr

葡萄牙语

Portuguese

pt

意大利语

Italian

it

德语

Germany

de

越南语

Vietnamese

vi

目标语种（中文名）

目标语种（英文全称）

目标语种（编码）

简体中文

Chinese

zh

英文

English

en

韩语

Korean

ko

日语

Japanese

ja

俄语

Russian

ru

西语

Spanish

es

法语

French

fr

葡萄牙语

Portuguese

pt

意大利语

Italian

it

越南语

Vietnamese

vi

马来语

Malay

ms

泰语

Thai

th

印尼语

Indonesian

id

阿拉伯语

Arabian

ar

模型与价格

模型名称

计费单价

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

免费额度（查看）

任务下发接口RPS限制

同时处理中任务数量

qwen-mt-image

0.003元/张

1

2

100张

前提条件

在调用前，您需要开通模型服务并获取API Key，再配置API Key到环境变量。

HTTP调用

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

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

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

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

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

说明

  • 任务创建成功后，接口将返回task_id。task_id查询有效期为 24 小时。

  • HTTP调用新手指南请参见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://img.alicdn.com/imgextra/i2/O1CN01XsvEqj1fNlMqLNBHR_!!6000000003995-0-tps-5933-2930.jpg",
        "source_lang": "en",
        "target_lang": "ja"
    }
}'

请求头（Headers）

Content-Type string （必选）

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

Authorization string（必选）

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

X-DashScope-Async string （必选）

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

请求体（Request Body）

model string （必选）

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

input object （必选）

输入的基本信息。

属性

image_url string （必选）

输入图像的URL。

  • 支持 HTTP 或 HTTPS 协议。

  • 示例值：https://img.alicdn.com/imgextra/i2/O1CN01XsvEqj1fNlMqLNBHR_!!6000000003995-0-tps-5933-2930.jpg。

图像限制：

  • 图像格式：JPG、JPEG、PNG、BMP、PNM、PPM、TIFF、WEBP。

  • 图像分辨率：输入图像的宽度和高度必须在 15 至 8192 像素之间，宽高比在1:10和10:1之间。

  • 图像大小：不超过10MB。

  • URL地址中不能包含中文字符。

source_lang string （必选）

源语种。支持使用语种的英文全称（如Chinese）或语种编码（如zh）。

指定源语种可以获得更稳定的翻译效果，如果您不确定原图的语种，可以将其设置为auto，由模型自动检测。

target_lang string （必选）

目标语种。

ext object （可选）

拓展字段。

属性

domainHint string （可选）

领域提示，如果希望译文风格更符合某个领域的特性，可以用英文描述使用场景、译文风格等领域需求。

为了保障翻译效果，建议长度不超过200个英文单词。

示例值：These sentences are from sellerbuyer 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 （可选）

敏感词，用于屏蔽部分信息，使得翻译后的图片中不显示对应内容。

11个原图语种均支持配置敏感词，敏感词语种需要跟source_lang源语种保持一致，建议单次请求配置数量不超过50个。

示例值：["满200-20", "七天无理由退换"]

terminologies array （可选）

术语定义，为使译文更符合特定领域的翻译需求，您可以为特定术语设定译文，术语信息需要与翻译方向一致。

属性

src string （可选）

术语源文本，要求与source_lang源语种相同。

tgt string （可选）

术语目标文本，要求与target_lang目标语种相同。

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

config object （可选）

属性

skipImgSegment bool （可选）

用于控制是否翻译图像中关键主体（如人物、商品、Logo）上的文字。

  • false ：默认值，智能识别主体，不翻译主体上的文字。

  • true: 将图像主体上的文字一并翻译。

响应参数

成功响应

{
    "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。

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秒。建议采用轮询机制，并设置合理的查询间隔（如3秒）来获取结果。

  • task_id 查询有效期为24小时，超时后将无法查询结果，接口将返回任务状态为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}
}

任务执行失败

如果因为某种原因导致任务执行失败，任务状态将被设置为FAILED，并通过code和message字段明确指示错误原因。请参见错误信息进行解决。

{
    "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。

task_status string

任务状态。

枚举值

  • PENDING：任务排队中

  • RUNNING：任务处理中

  • SUCCEEDED：任务执行成功

  • FAILED：任务执行失败

  • CANCELED：任务取消成功

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

submit_time string

任务提交时间。

scheduled_time string

任务执行时间。

end_time string

任务完成时间。

image_url string

模型生成图片的URL地址。有效期为24小时，请及时下载并保存图像。

code string

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

message string

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

usage object

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

属性

image_count integer

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

request_id string

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

图像访问配置

配置域名白名单：确保业务系统可访问图像链接

模型生成的图像存储于阿里云OSS，每张图像会被分配一个OSS链接，如https://dashscope-result-xx.oss-cn-xxxx.aliyuncs.com/xxx.png。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

错误码

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

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