Qwen-MT-Image 翻訳 API で非同期画像ローカライズ - Model Studio

Qwen-MT-Image は、画像内のテキストを元のレイアウトを維持したまま高精度に翻訳します。このモデルは、ドメインヒント、禁止用語フィルター、用語介入などのカスタム機能もサポートしています。

重要

このドキュメントは中国本土デプロイメントモードのみに適用されます。対応する API キーを使用する必要があります。

モデル概要

ソース言語：英語

日本語

ポルトガル語

アラビア語

モデル

説明

出力画像仕様

qwen-mt-image

Qwen - 画像翻訳モデル

中国語または英語と他の言語間の翻訳をサポートします。日本語から韓国語など、中国語および英語以外の言語間の直接翻訳はサポートしていません。詳細については、「サポート言語」をご参照ください。

画像フォーマット：JPG。

前提条件

API キーの取得および API キーを環境変数としてエクスポートします。

HTTP

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

HTTP API は非同期モードを使用します。呼び出しには次の 2 ステップが必要です。

タスクを作成し、タスク ID を取得します：リクエストを送信してタスクを作成します。リクエストの応答として タスク ID (task_id) が返されます。
タスク 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/arpjoo/p1000391.webp", "source_lang": "en", "target_lang": "ja", "ext": { "config": { "imageSegment": false } } } }'`
リクエストヘッダー
Content-Type `string` （必須）リクエストのコンテンツタイプです。必ず `application/json` を指定してください。
Authorization `string` （必須） Model Studio API キーを使用した認証情報です。例： `Bearer sk-xxxx`
X-DashScope-Async `string` （必須）非同期処理を有効にします。HTTP リクエストは非同期処理のみをサポートしているため、必ず `enable` を指定してください。重要このヘッダーを含めない場合、「current user api does not support synchronous calls」というエラーが返されます。
リクエスト本文
model `string` （必須）モデル名です。必ず `qwen-mt-image` を指定してください。
input `object` （必須）入力パラメーターオブジェクトで、以下のフィールドを含みます。プロパティ image_url `string` （必須）画像の公開アクセス可能な URL です。HTTP および HTTPS プロトコルをサポートしています。フォーマット：JPG、JPEG、PNG、BMP、PNM、PPM、TIFF、WEBP ディメンション：画像の幅および高さは 15 ～ 8,192 ピクセルの範囲内である必要があります。縦横比は 1:10 ～ 10:1 の範囲内である必要があります。サイズ：100 MB 以下 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 英単語以内にしてください。重要ドメインヒントワードは現在、英語のみをサポートしています。例: これらの文章は、B2C eコマースプラットフォームにおける出品者と購入者の会話です。起こりうる問題や紛争の対応に適したものとなるよう、明確で好感の持てるカスタマーサービス用の言葉遣いに翻訳してください。 sensitives `array` （任意）翻訳前に画像テキストからフィルターする禁止用語を設定します。フィルターは完全に一致かつ大文字と小文字を区別します。禁止用語の言語はソース言語と異なっていても構いません。ソース言語およびターゲット言語すべてをサポートしています。翻訳品質を確保するため、1 回のリクエストにつき 50 個以下の禁止用語を追加してください。例： ["10% off entire store", "7-day no-questions-asked return"] terminologies `array` （任意）用語介入を提供します。この機能により、特定のドメインの要件を満たすために、用語に対して特定の翻訳を設定できます。用語ペアの言語は、`source_lang` および `target_lang` に対応している必要があります。プロパティ src `string` （必須）用語のソーステキストです。言語は `source_lang` と同じである必要があります。 tgt `string` （必須）用語のターゲットテキストです。言語は `target_lang` と同じである必要があります。例： [{"src": "Application Programming Interface", "tgt": "API"}, {"src": "Machine Learning", "tgt": "ML"}] config `object` （任意）プロパティ imageSegment `bool` （任意）画像主題セグメンテーションを有効にするかどうかを指定します。有効にすると、人物、商品、ロゴなど画像内の主題上にあるテキストは翻訳されません。 `false` （デフォルト）：画像内のすべてのテキストを翻訳します。 `true`：画像主題上のテキストを翻訳しません。注記：このパラメーターは以前 `skipImgSegment` （画像主題セグメンテーションをスキップするかどうかを指定）という名前でした。下位互換性のため、この古いパラメーター名も引き続きサポートされていますが、新しい `imageSegment` パラメーターの使用を推奨します。

レスポンスパラメーター	成功時のレスポンスタスクのステータスおよび結果を照会するために、`task_id` を保存してください。 `{ "output": { "task_status": "PENDING", "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx" }, "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx" }` エラー時のレスポンスタスクの作成に失敗しました。「エラーコード」を参照して問題を解決してください。 `{ "code": "InvalidApiKey", "message": "No API-key provided.", "request_id": "7438d53d-6eb8-4596-8835-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}

説明

task_id の有効期限は 24 時間 です。ID が存在しない、または有効期限が切れている場合、タスクステータスは UNKNOWN として返されます。
成功したタスクに対して返される url の有効期限は 24 時間 です。画像をダウンロードしてすぐに保存してください。

リクエストパラメーター	タスク結果の照会 `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"`
リクエストヘッダー
Authorization `string` （必須） Model Studio API キーを使用した認証情報です。例： `Bearer sk-xxxx`
URL パスパラメーター
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 } }` タスク成功 - 翻訳可能なコンテンツなし画像に翻訳可能なテキストが含まれていない場合（たとえば、主題識別後にテキストが残っていない場合）、タスクは依然として成功と見なされ、通常どおり課金されます。ただし、メッセージ `No text detected for translation` が返されます。 `{ "request_id": "0ccb84aa-e034-431d-9d54-08e14fxxxxxx", "output": { "task_id": "34ec4208-97d6-498b-a390-9173f7xxxxxx", "task_status": "SUCCEEDED", "submit_time": "2026-01-12 17:56:23.625", "scheduled_time": "2026-01-12 17:56:23.656", "end_time": "2026-01-12 17:56:25.324", "image_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.jpg?Expires=xxx", "message": "No text detected for translation" }, "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` タスクが送信された時刻です。時刻は UTC + 08:00 です。フォーマット： `YYYY-MM-DD HH:mm:ss.SSS`。 scheduled_time `string` タスクが実行を開始した時刻です。時刻は UTC + 08:00 です。フォーマット： `YYYY-MM-DD HH:mm:ss.SSS`。 end_time `string` タスクが完了した時刻です。時刻は UTC + 08:00 です。フォーマット： `YYYY-MM-DD HH:mm:ss.SSS`。 image_url `string` モデルによって生成された画像の URL です。画像はソース画像と同じディメンションを持ち、JPG フォーマットです。URL の有効期限は 24 時間です。画像をダウンロードしてすぐに保存してください。 code `string` エラーコードです。リクエストが失敗した場合にのみ返されます。詳細については、「エラーコード」をご参照ください。 message `string` リクエスト失敗に関する詳細情報です。詳細については、「エラーメッセージ」をご参照ください。このパラメーターは通常、成功したリクエストでは返されません。ただし、画像に翻訳可能なテキストが含まれていない場合（たとえば、主題セグメンテーション後にテキストが残っていない場合）にのみ返されます。この場合、タスクは依然として成功と見なされ、通常どおり課金されますが、メッセージ `No text detected for translation` が返されます。
usage `object` 使用量統計情報です。これらの統計情報は、成功したタスクに対してのみカウントされます。プロパティ image_count `integer` モデルによって生成された画像の枚数です。値は常に 1 です。
request_id `string` リクエストの一意な識別子です。トレースおよびトラブルシューティングに使用します。

サポート言語

画像を翻訳する際、ソース言語またはターゲット言語のいずれか一方は、必ず中国語または英語である必要があります。日本語から韓国語など、中国語および英語以外の言語間の直接翻訳はサポートされていません。ソース言語が不明な場合は、source_lang を auto に設定して自動検出を有効にしてください。

言語	コード	ソース言語として	ターゲット言語として
中国語	zh	サポート	サポート
英語	en	サポート	サポート
韓国語	ko	サポート	サポート
日本語	ja	サポート	サポート
ロシア語	ru	サポート	サポート
スペイン語	es	サポート	サポート
フランス語	fr	サポート	サポート
ポルトガル語	pt	サポート	サポート
イタリア語	it	サポート	サポート
ドイツ語	de	サポート	未サポート
ベトナム語	vi	サポート	サポート
マレー語	ms	未サポート	サポート
タイ語	th	未サポート	サポート
インドネシア語	id	未サポート	サポート
アラビア語	ar	未サポート	サポート

課金とレート制限

無料クォータおよび料金については、「モデル料金」をご参照ください。
レート制限については、「レート制限」をご参照ください。
課金：正常に生成された画像の枚数に基づいて課金されます。モデル呼び出しが失敗した場合や処理エラーが発生した場合は、料金は発生せず。
注記：画像に翻訳可能なテキストが含まれていない場合、または主題識別を有効にした後に主題領域外にテキストが残っていない場合でも、タスクは依然として成功と見なされ、通常どおり課金されます。この場合、API はメッセージ No text detected for translation を返します。

エラーコード

モデル呼び出しが失敗してエラーメッセージが返された場合は、「エラーメッセージ」を参照して問題を解決してください。

よくある質問

Q：画像内のコンテンツが翻訳されないのはなぜですか？

A：「エンティティセグメンテーション」機能により、画像内の人物、商品、ロゴなどのエンティティ上にあるテキストは翻訳されません。すべてのテキストを翻訳するには、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() # 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：モデル呼び出しが完了してから 1 時間後に、モデルモニタリング（シンガポール）または モデルモニタリング（中国 (北京)）ページにアクセスして、呼び出し回数や成功率などのメトリックを確認できます。詳細については、「請求書の確認とコスト管理」をご参照ください。

Q：画像ストレージのドメイン名ホワイトリストを取得するにはどうすればよいですか？

A：モデルによって生成された画像は OSS に保存されます。API は一時的な公開 URL を返します。このダウンロード URL のファイアウォールホワイトリストを設定する場合、以下の点にご注意ください。基盤となるストレージは動的に変更される可能性があります。このトピックでは、情報の陳腐化によるアクセス障害を防ぐため、固定の OSS ドメイン名ホワイトリストを提供していません。セキュリティ制御の要件がある場合は、アカウントマネージャーに連絡して最新の OSS ドメイン名リストを取得してください。

モデル概要

前提条件

HTTP

ステップ 1：タスクを作成し、タスク ID を取得する

リクエストパラメーター

画像翻訳

リクエストヘッダー

リクエスト本文

レスポンスパラメーター

成功時のレスポンス

エラー時のレスポンス