Qwen-MT-Image 翻訳 API の呼び出し方法 - Alibaba Cloud Model Studio

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

重要

本ドキュメントで説明する機能は、中国 (北京) リージョンでのみ利用可能です。このリージョンでは、API キーを使用する必要があります。

モデル概要

ソース言語：英語

日本語

ポルトガル語

アラビア語

モデル	説明	出力画像仕様
qwen-mt-image	Qwen 画像翻訳モデル。中国語または英語と他の言語との間の翻訳をサポートします。中国語および英語以外の 2 言語間（例：日本語から韓国語）の直接翻訳はサポートされていません。詳細については、「サポート言語」をご参照ください。	画像フォーマット：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 イーコマースプラットフォーム上の販売者と購入者の会話から抜粋したものです。これらを、潜在的な問題や紛争への対応に適した、明確で魅力的なカスタマーサービス向けの言葉遣いに翻訳してください。 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 フォーマット、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	未サポート	サポート

課金とレート制限

無料クォータおよび料金については、「モデル料金」をご参照ください。
レート制限については、「レート制限」をご参照ください。
課金は、正常に生成された画像ごとに行われます。失敗した呼び出しやエラーは料金が発生せず。
画像に翻訳可能なテキストが含まれていない場合（またはセグメンテーション後に主題領域外にテキストがない場合）、タスクは成功し通常通り課金されますが、No text detected for translation が返されます。

エラーコード

モデル呼び出しが失敗してエラーメッセージが返された場合は、「エラーコード」をご参照のうえ、解決策を確認してください。

よくある質問

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

主題セグメンテーション機能により、画像内の主題（人物、商品、ロゴなど）上のテキストが翻訳対象外になります。画像内のすべてのテキストを翻訳するには、ext.config.imageSegment を false に設定してください。

Q：一時的な画像リンクを永続的なリンクに変換するにはどうすればよいですか？

一時的なリンクを直接永続的なリンクに変換することはできません。バックエンドサービスを使用して画像をダウンロードし、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 を取得

リクエストパラメーター

画像翻訳

リクエストヘッダー

リクエスト本文

レスポンスパラメーター

成功時のレスポンス

エラー時のレスポンス