Skip to main content
千問

千問-映像翻譯API參考

千問-映像翻譯模型（Qwen-MT-Image）可精準翻譯映像中的文字，並保留原始排版。該模型還支援領域提示、敏感詞過濾、術語幹預等自訂功能。

本文檔描述的功能僅在華北2（北京）地區可用，必須使用該地區的API Key。
阿里雲百鍊為華北2（北京）地區推出了業務空間專屬網域名稱 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com，能夠為推理請求提供卓越的效能和更高的穩定性，建議從 https://dashscope.aliyuncs.com 遷移至新網域名稱。其中 {WorkspaceId} 為您的業務空間 ID，可在阿里雲百鍊控制台的業務空間詳情頁面查看。現有網域名稱仍可正常使用。

模型概覽

en

源語種：英文

ja

日語

es

葡語

ar

阿拉伯語

模型名稱

模型簡介

輸出映像規格

qwen-mt-image

千問-映像翻譯模型

支援中/英文與其他語種之間的互譯，但不支援在非中/英語種之間直接翻譯（例如，從日語翻譯為韓語）。詳情請參見支援的語種。

圖片格式：JPG。

前提條件

您需要已擷取API Key並配置API Key到環境變數。請將範例程式碼中的 DASHSCOPE_API_HOST 替換為擷取的 API Host。

HTTP調用

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis，調用時請將{WorkspaceId}替換為真實的Workspace ID。 HTTP API 採用非同步模式，調用流程分兩步：
  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（必選）非同步處理配置參數。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範圍內。
  • 大小限制：不超過100MB
  • URL地址中不能包含中文字元。
  • 樣本：https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/arpjoo/p1000391.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一致。tgtstring （必選）術語的目標文本，語種需要與目標語種target_lang一致。
樣本：[{"src": "應用程式介面", "tgt": "API"}, {"src": "機器學習", "tgt": "ML"}]config object （可選）

屬性

imageSegmentbool （可選）是否開啟映像主體分割。開啟後，將跳過對映像中主體（如人物、商品、Logo）上文字的翻譯。
  • false：（預設值）翻譯映像中的所有文字。
  • true：不翻譯映像主體的文字。
注意：舊版本參數名為skipImgSegment（是否跳過映像主體分割）。為保持相容，該參數仍受支援，但建議使用新的 imageSegment參數。
  • 映像翻譯
# 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
curl --location 'https://{WorkspaceId}.ap-southeast-1.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",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/arpjoo/p1000391.webp",
        "source_lang": "en",
        "target_lang": "ja",
        "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小時，請及時下載並儲存映像。

請求參數

要求標頭（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任務提交時間。時區為UTC+8，格式為 YYYY-MM-DD HH:mm:ss.SSS。scheduled_time string任務執行時間。時區為UTC+8，格式為 YYYY-MM-DD HH:mm:ss.SSS。end_time string任務完成時間。時區為UTC+8，格式為 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 進行自動檢測。

語種（中文名）

英文全稱

編碼

支援作為源語種

支援作為目標語種

簡體中文

Chinese

zh

支援

支援

英文

English

en

支援

支援

韓語

Korean

ko

支援

支援

日語

Japanese

ja

支援

支援

俄語

Russian

ru

支援

支援

西班牙語

Spanish

es

支援

支援

法語

French

fr

支援

支援

葡萄牙語

Portuguese

pt

支援

支援

意大利語

Italian

it

支援

支援

德語

German

de

支援

不支援

越南語

Vietnamese

vi

支援

支援

馬來語

Malay

ms

不支援

支援

泰語

Thai

th

不支援

支援

印尼語

Indonesian

id

不支援

支援

阿拉伯語

Arabian

ar

不支援

支援

計費與限流

  • 模型免費額度和計費單價請參見模型價格。
  • 模型限流請參見限流。
  • 計費說明：按成功產生的映像張數計費。模型調用失敗或處理錯誤不產生任何費用。
  • 注意：如果映像中無可翻譯文本，或在啟用主體識別功能後，非主體部分無文字時，任務仍記為成功並正常計費，此時介面會返回No text detected for translation的提示。

錯誤碼

如果模型調用失敗並返回報錯資訊，請參見錯誤碼進行解決。

常見問題

Q：為什麼圖中的內容沒有被翻譯？

A：因為啟用了主體分割功能，模型不會翻譯圖片中人物、商品、Logo等主體上的文字。若需翻譯所有文字，請將ext.config.imgSegment參數設定為false。

Q：如何將臨時的映像連結轉為永久連結？

A：臨時連結無法直接轉為永久連結。需通過後端服務下載映像，再上傳至Object Storage Service服務（如阿里雲 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: 模型調用完一小時後，請在 模型监控（新加坡）或模型监控（北京）頁面，查看模型的調用次數、成功率等指標。詳情請參見賬單查詢與成本管理。

Q：如何擷取映像儲存的訪問網域名稱白名單？

A： 模型產生的映像儲存於阿里雲OSS，API將返回一個臨時的公網URL。若需要對該下載地址進行防火牆白名單配置，請注意：由於底層儲存會根據業務情況進行動態變更，為避免到期資訊影響訪問，文檔不提供固定的OSS網域名稱白名單。如有安全管控需求，請聯絡客戶經理擷取最新OSS網域名稱列表。
使用 API
文本產生
映像產生
視頻產生
音頻
即時多模態
Realtime API
  • 概述
向量與排序
更多模型
工具包/架構
模型生產
檔案管理
更多
千問-映像翻譯API參考 - Alibaba Cloud Model Studio