すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Model Studio:Qwen-MT API リファレンス

    ドキュメントセンター

    Alibaba Cloud Model Studio:Qwen-MT API リファレンス

    最終更新日:Jan 17, 2026

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

    重要

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

    モデル概要

    en

    ソース言語：英語

    ja

    日本語

    es

    ポルトガル語

    ar

    アラビア語

    モデル

    説明

    出力画像の仕様

    qwen-mt-image

    Qwen - 画像翻訳モデル

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

    画像フォーマット：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」をご参照ください。

    リクエストパラメーター

    画像翻訳

    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 (必須)

    認証情報。この API は 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 文字列 (必須)

    ターゲット言語。

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

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

    • 例：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 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。この 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}

    説明

    • 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 (必須)

    認証情報。この API は 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。この 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 フォーマットです。URL は 24 時間有効です。画像を速やかにダウンロードして保存してください。

    code string

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

    message string

    リクエストの失敗に関する詳細情報。詳細については、「エラーメッセージ」をご参照ください。

    このパラメーターは通常、成功したリクエストでは返されません。画像に翻訳可能なテキストが含まれていない場合 (主題セグメンテーションの後にテキストが残らない場合など) にのみ返されます。この場合、タスクは成功し、通常どおり課金されますが、「No text detected for translation」というメッセージが返されます。

    usage object

    使用状況の統計。これらの統計は、成功したタスクに対してのみカウントされます。

    プロパティ

    image_count integer

    モデルによって生成された画像の数。値は 1 に固定されています。

    request_id string

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

    サポートされている言語

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

    言語

    コード

    ソース言語として

    ターゲット言語として

    中国語

    zh

    サポート

    サポート

    英語

    en

    サポート

    対応

    韓国語

    ko

    サポート

    サポート

    日本語

    ja

    サポート

    サポート

    ロシア語

    ru

    対応

    サポート

    スペイン語

    es

    対応

    サポート

    フランス語

    fr

    対応

    対応

    ポルトガル語

    pt

    サポート

    対応

    イタリア語

    it

    対応

    サポート

    ドイツ語

    de

    サポート

    非サポート

    ベトナム語

    vi

    対応

    対応

    マレー語

    ms

    非サポート

    対応

    タイ語

    th

    非サポート

    対応

    インドネシア語

    id

    非サポート

    サポート済み

    アラビア語

    ar

    非サポート

    サポート

    課金とレート制限

    • 無料クォータと料金については、「モデルの料金」をご参照ください。

    • レート制限については、「レート制限」をご参照ください。

    • 課金：正常に生成された画像の数に基づいて課金されます。モデルの呼び出しの失敗や処理エラーは、料金が発生したり、を消費したりすることはありません。

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

    画像アクセス権限の設定

    画像は 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：エンティティセグメンテーション機能により、モデルは人物、プロダクト、ロゴなど、画像内のエンティティ上のテキストを翻訳しません。すべてのテキストを翻訳するには、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"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 時間後に、モデル観測ページに移動して、呼び出し回数や成功率などのメトリックを表示できます。「モデル呼び出しレコードの表示方法」をご参照ください。