Skip to main content

Qwen-MT-Image API リファレンス

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

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

モデル概要

en

ソース言語：英語

ja

日本語

es

ポルトガル語

ar

アラビア語

モデル

説明

出力画像仕様

qwen-mt-image

Qwen 画像翻訳モデル。中国語または英語と他の言語との間の翻訳をサポートします。中国語および英語以外の 2 言語間（例：日本語から韓国語）の直接翻訳はサポートされていません。詳細については、「サポート言語」をご参照ください。

画像フォーマット：JPG

前提条件

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

HTTP

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis HTTP API は非同期モードで、次の 2 ステップで処理されます。
  1. タスクを作成してタスク ID を取得：タスク作成リクエストを送信します。リクエストの応答としてタスク ID（task_id）が返されます。
  2. タスク ID を使用して結果を照会：タスク完了まで task_id を使用してタスクステータスをポーリングし、画像 URL を取得します。

ステップ 1：タスクを作成してタスク ID を取得

  • タスク作成後は、返された task_id を使用して結果を照会します。task_id の有効期間は 24 時間です。重複タスクを作成せず、代わりに結果をポーリングしてください。
  • チュートリアルについては、「Postman」をご参照ください。

リクエストパラメーター

リクエストヘッダー
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 と同じである必要があります。tgtstring （必須）用語のターゲットテキスト。言語は target_lang と同じである必要があります。
例：[{"src": "Application Programming Interface", "tgt": "API"}, {"src": "Machine Learning", "tgt": "ML"}]config object（任意）

プロパティ

imageSegmentbool（任意）有効にすると、画像主題セグメンテーションにより、画像内の主題（人物、商品、ロゴなど）上のテキストが翻訳対象外になります。
  • false（デフォルト）：画像内のすべてのテキストを翻訳します。
  • true：画像内の主題上のテキストを翻訳しません。
注記：このパラメーターは以前 skipImgSegment（画像主題セグメンテーションをスキップするかどうかを指定）という名前でした。下位互換性のため、このパラメーターは引き続きサポートされていますが、新しい imageSegment パラメーターの使用を推奨します。
  • 画像翻訳
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
            }
        }
    }
}'

レスポンスパラメーター

output objectタスク出力情報。

プロパティ

task_id stringタスク ID。照会は 24 時間有効です。task_status stringタスクのステータス。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN：タスクが存在しない、またはステータスが不明です。
request_id stringトレースおよびトラブルシューティング用の一意のリクエスト識別子。message string詳細なエラーメッセージ。失敗したリクエストの場合にのみ返されます。「エラーコード」をご参照ください。code stringエラーコード。失敗したリクエストの場合にのみ返されます。「エラーコード」をご参照ください。
  • 成功時のレスポンス
  • エラー時のレスポンス
task_id を保存して、タスクステータスおよび結果を照会します。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

ステップ 2：タスク ID を使用して結果を照会

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
  • task_id の有効期間は 24 時間です。存在しない、または期限切れの ID にはステータス UNKNOWN が返されます。
  • 成功したタスクの url は 24 時間有効です。すぐにダウンロードして保存してください。

リクエストパラメーター

リクエストヘッダー
Authorization string （必須）Model Studio API キーを使用してリクエストを認証します。例：Bearer sk-xxxx。
URL パスパラメーター
task_id string （必須）タスクの ID。
  • タスク結果の照会
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"

レスポンスパラメーター

outputobjectタスク出力に関する情報。

プロパティ

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エラーコード。失敗したリクエストの場合にのみ返されます。「エラーコード」をご参照ください。messagestringリクエスト失敗に関する詳細情報。詳細については、「エラーメッセージ」をご参照ください。通常、成功したリクエストでは返されません。ただし、画像に翻訳可能なテキストが含まれていない場合（例：主題セグメンテーション後）は、タスクは成功し通常通り課金され、No text detected for translation が返されます。
usage object使用量統計。成功したタスクに対してのみカウントされます。

プロパティ

image_count integer生成された画像の枚数（常に 1）。
request_id stringトレースおよびトラブルシューティング用の一意のリクエスト識別子。
  • タスク成功 - 翻訳可能なコンテンツあり
  • タスク成功 - 翻訳可能なコンテンツなし
  • タスク失敗
タスクデータ（タスクステータスおよび画像 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 を設定すると、言語を自動検出します。

言語

コード

ソース言語として

ターゲット言語として

中国語

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 ドメイン名リストを取得してください。