すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:Qwen - 画像翻訳 API リファレンス

最終更新日:Nov 28, 2025

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

重要

このドキュメントは、中国 (北京) リージョンにのみ適用されます。このリージョンの API キー を使用する必要があります。

モデル概要

en

翻訳元言語:英語

ja

日本語

es

ポルトガル語

ar

アラビア語

モデルと料金

画像翻訳機能は、中国語または英語と他の言語間の翻訳に対応していますが、日本語から韓国語への翻訳など、中国語/英語以外の言語間の直接翻訳には対応していません。詳細については、「対応言語」をご参照ください。

モデル

単価

レート制限 (Alibaba Cloud アカウントと RAM ユーザーで共有)

タスク送信 API の RPS 制限

同時タスク数

qwen-mt-image

$0.000431/画像

1

2

課金ルール

  • 課金方法: 生成に成功したイメージの数に基づいて課金されます。タスクが成功 (task_statusSUCCEEDED) し、イメージが生成された後に課金されます。

  • 注: イメージに翻訳可能なテキストが含まれていない場合、または主題識別を有効にした後に非主題領域にテキストが残っていない場合でも、タスクは成功し通常どおり課金されます。この場合、API はメッセージ No text detected for translation を返します。

HTTP

API キーを取得し、その API キーを環境変数として設定する必要があります。

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

画像翻訳には時間がかかるため、HTTP API は非同期モードを使用します。呼び出しプロセスは 2 つのステップで構成されます:

  1. タスクを作成してタスク ID を取得:リクエストを送信してタスクを作成します。リクエストは task_id を返します。

  2. タスク ID を使用してタスク結果を照会:task_id を使用して、タスクが完了し、画像 URL を取得するまでタスクステータスをポーリングします。

ステップ 1:タスクを作成し、タスク ID を取得

説明

タスクの作成後、返された task_id を使用して、ポーリングで結果をクエリします。task_id は 24 時間有効です。タスクを繰り返し作成しないでください。

リクエストパラメーター

画像翻訳

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"
    }
}'

リクエストヘッダー

Content-Type string (必須)

リクエストのコンテンツタイプ。このパラメーターを application/json に設定します。

Authorization string (必須)

リクエストの ID 認証情報。この API は、ID 認証に 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 文字列 (必須)

画像のパブリックアクセス可能な URL。HTTP および HTTPS プロトコルがサポートされています。

  • フォーマット制限:JPG、JPEG、PNG、BMP、PNM、PPM、TIFF、または WEBP

  • ディメンション制限:画像の幅と高さは 15~8,192 ピクセルの範囲内である必要があります。縦横比は 1:10~10:1 の範囲内である必要があります。

  • サイズ制限:10 MB 以下

  • URL に中国語などの非 ASCII 文字が含まれている場合は、リクエストで渡す前に URL を URL エンコードする必要があります。

    URL エンコーディング

    from urllib.parse import quote
    
    # 次の URL をエンコードする必要がある URL に置き換えます
    url = "https://example.com/search?q=test&page=1"
    encoded_url = quote(url, safe=':/?#[]@!$&\'()*+,;=%')
    print(f"Original URL: {url}")
    print(f"Encoded URL: {encoded_url}")
  • https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250916/arpjoo/p1000391.webp

source_lang 文字列 (必須)

翻訳元言語

  • サポートされている値:完全な言語名、言語コード、または auto (自動検出)。値は、大文字と小文字を区別しません。

  • 制約: target_lang とは異なる必要があります。ソース言語またはターゲット言語の少なくとも一方が、中国語または英語である必要があります。

  • Chineseen、または auto

target_lang 文字列 (必須)

翻訳先言語

  • サポートされている値:完全な言語名または言語コード。値の大文字と小文字は区別されません。

  • 制限: source_lang とは異なる必要があります。ソース言語またはターゲット言語の少なくとも 1 つは、中国語または英語である必要があります。

  • Chinese または en

ext object (オプション)

オプションの拡張フィールド。

プロパティ

domainHint string (オプション)

ドメインヒント。翻訳スタイルを特定のドメインにより適したものにするために、英語でシナリオ、翻訳スタイル、その他の要件を記述します。

翻訳の品質を確保するため、ヒントは 200 英単語を超えないようにしてください。

重要

ドメインヒントは現在、英語のみをサポートしています。

例: B2C eコマース プラットフォームにおける出品者と購入者の会話から抜粋したこれらの文章を、起こりうる問題や紛争の対応に適した、明確で分かりやすいカスタマーサービスの言葉遣いに翻訳してください。

sensitives array (オプション)

翻訳前に画像テキストからフィルターする禁止用語を設定します。フィルターは完全一致で実行され、大文字と小文字を区別します

禁止用語の言語は、翻訳元言語と異なっていてもかまいません。すべての翻訳元言語翻訳先言語がサポートされています。翻訳の品質を確保するため、リクエストごとに 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 Program Interface", "tgt": "API"}, {"src": "Machine Learning", "tgt": "ML"}]

config object (オプション)

プロパティ

skipImgSegment bool (オプション)

主題検出をスキップし、人物、製品、ロゴなどの画像上の主題のテキストを翻訳するかどうかを制御します。

  • false(デフォルト) 主題検出を実行し、主題上のテキストは翻訳しません。

  • true:主題検出を実行せず、主題上のテキストを含むすべてのテキストを翻訳します。

レスポンスパラメーター

成功レスポンス

task_id を保存して、タスクのステータスと結果を照会します。

{
    "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。クエリは 24 時間有効です。

task_status string

タスクステータス。

列挙

  • PENDING

  • RUNNING

  • SUCCEEDED

  • FAILED

  • CANCELED

  • UNKNOWN:タスクが存在しないか、そのステータスを特定できません。

request_id string

一意のリクエスト ID。この ID を使用して問題を追跡およびトラブルシューティングできます。

message string

失敗したリクエストに関する詳細情報。このパラメーターは、リクエストが成功した場合は返されません。詳細については、「エラーメッセージ」をご参照ください。

code string

失敗したリクエストのエラーコード。このパラメーターは、リクエストが成功した場合は返されません。詳細については、「エラーメッセージ」をご参照ください。

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

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

説明
  • モデルがリクエストを処理するには約 15 秒かかります。5 秒などの適切なクエリ間隔でポーリングメカニズムを使用して、結果を取得してください。

  • task_id24 時間有効です。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 (必須)

リクエストの ID 認証情報。この API は、ID 認証に 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
    }
}

タスク失敗

タスクが失敗した場合、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

一意のリクエスト ID。この ID を使用して問題を追跡およびトラブルシューティングできます。

サポート言語

イメージを翻訳する場合、翻訳元言語または翻訳先言語の少なくとも一方が中国語または英語である必要があります。日本語から韓国語への翻訳など、中国語と英語以外の言語間の直接翻訳はサポートされていません。翻訳元言語が不明な場合は、source_langauto に設定して自動検出できます。

言語

コード

翻訳元言語として

翻訳先言語として

中国語

zh

サポート

サポート

英語

en

サポート

サポート

韓国語

ko

サポート

サポート

日本語

ja

サポート

サポート

ロシア語

ru

サポート

サポート

スペイン語

es

サポート

サポート

フランス語

fr

サポート

サポート

ポルトガル語

pt

サポート

サポート

イタリア語

it

サポート

サポート

ドイツ

de

対応

非サポート

ベトナム語

vi

サポート

サポート

マレー語

ms

非サポート

サポート

タイ語

th

非サポート

サポート

インドネシア語

id

非サポート

サポート

アラビア

ar

非サポート

サポート

アクセス権限の設定

画像は Object Storage Service (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

エラーコード

呼び出しが失敗した場合は、「エラーメッセージ」をご参照ください。

よくある質問

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"Image successfully downloaded to: {save_path}")
        # ここに永続的なストレージにアップロードするロジックを追加できます。
    except requests.exceptions.RequestException as e:
        print(f"Image download failed: {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 時間後に、Model Observation ページで呼び出し回数や成功率などのメトリックを表示できます。詳細については、「モデルの呼び出しレコードの確認方法」をご参照ください。