Qwen-MT-Image は、画像内のテキストを正確に翻訳し、元のレイアウトを保持します。このモデルは、ドメインヒント、禁止用語フィルター、用語介入などのカスタム機能もサポートしています。
このドキュメントは、中国 (北京) リージョンにのみ適用されます。このリージョンの API キー を使用する必要があります。
モデル概要
例
翻訳元言語:英語 |
日本語 |
ポルトガル語 |
アラビア語 |
モデルと料金
画像翻訳機能は、中国語または英語と他の言語間の翻訳に対応していますが、日本語から韓国語への翻訳など、中国語/英語以外の言語間の直接翻訳には対応していません。詳細については、「対応言語」をご参照ください。
モデル | 単価 | レート制限 (Alibaba Cloud アカウントと RAM ユーザーで共有) | |
タスク送信 API の RPS 制限 | 同時タスク数 | ||
qwen-mt-image | $0.000431/画像 | 1 | 2 |
課金ルール
課金方法: 生成に成功したイメージの数に基づいて課金されます。タスクが成功 (
task_statusがSUCCEEDED) し、イメージが生成された後に課金されます。注: イメージに翻訳可能なテキストが含まれていない場合、または主題識別を有効にした後に非主題領域にテキストが残っていない場合でも、タスクは成功し、通常どおり課金されます。この場合、API はメッセージ
No text detected for translationを返します。
HTTP
API キーを取得し、その API キーを環境変数として設定する必要があります。
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
画像翻訳には時間がかかるため、HTTP API は非同期モードを使用します。呼び出しプロセスは 2 つのステップで構成されます:
タスクを作成してタスク ID を取得:リクエストを送信してタスクを作成します。リクエストは task_id を返します。
タスク ID を使用してタスク結果を照会:task_id を使用して、タスクが完了し、画像 URL を取得するまでタスクステータスをポーリングします。
ステップ 1:タスクを作成し、タスク ID を取得
タスクの作成後、返された task_id を使用して、ポーリングで結果をクエリします。task_id は 24 時間有効です。タスクを繰り返し作成しないでください。
リクエストパラメーター | 画像翻訳 |
リクエストヘッダー | |
Content-Type リクエストのコンテンツタイプ。このパラメーターを | |
Authorization リクエストの ID 認証情報。この API は、ID 認証に Model Studio API キーを使用します。例:Bearer sk-xxxx。 | |
X-DashScope-Async 非同期処理の設定パラメーター。HTTP リクエストは非同期処理のみをサポートします。このパラメーターを 重要 このリクエストヘッダーがない場合、「current user api does not support synchronous calls」というエラーメッセージが返されます。 | |
リクエストボディ | |
model モデル名。このパラメーターを | |
input 入力パラメーターオブジェクト。次のフィールドが含まれます: |
レスポンスパラメーター | 成功レスポンスtask_id を保存して、タスクのステータスと結果を照会します。 エラーレスポンスタスクの作成に失敗しました。詳細については、「エラーメッセージ」を参照して問題を解決してください。 |
output タスクの出力情報。 | |
request_id 一意のリクエスト ID。この ID を使用して問題を追跡およびトラブルシューティングできます。 | |
message 失敗したリクエストに関する詳細情報。このパラメーターは、リクエストが成功した場合は返されません。詳細については、「エラーメッセージ」をご参照ください。 | |
code 失敗したリクエストのエラーコード。このパラメーターは、リクエストが成功した場合は返されません。詳細については、「エラーメッセージ」をご参照ください。 |
ステップ 2:タスク ID を使用して結果を照会
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
モデルがリクエストを処理するには約 15 秒かかります。5 秒などの適切なクエリ間隔でポーリングメカニズムを使用して、結果を取得してください。
task_idは 24 時間有効です。ID が存在しないか、期限切れの場合、タスクのステータスはUNKNOWNとして返されます。成功したタスクで返される
urlは、24 時間有効です。速やかにイメージをダウンロードして保存してください。
リクエストパラメーター | タスク結果の照会
|
リクエストヘッダー | |
Authorization リクエストの ID 認証情報。この API は、ID 認証に Model Studio API キーを使用します。例:Bearer sk-xxxx。 | |
URL パスパラメーター | |
task_id タスク ID。 |
レスポンスパラメーター | タスク成功タスクステータスや画像 URL などのタスクデータは 24 時間のみ保持され、この期間が過ぎると自動的に消去されます。生成された画像は速やかに保存する必要があります。 タスク失敗タスクが失敗した場合、task_status は FAILED に設定され、エラーコードとメッセージが表示されます。詳細については、「エラーメッセージ」を参照して問題を解決してください。 |
output タスクの出力情報。 | |
usage 使用状況の統計。これらの統計は、成功したタスクに対してのみカウントされます。 | |
request_id 一意のリクエスト ID。この ID を使用して問題を追跡およびトラブルシューティングできます。 |
サポート言語
イメージを翻訳する場合、翻訳元言語または翻訳先言語の少なくとも一方が中国語または英語である必要があります。日本語から韓国語への翻訳など、中国語と英語以外の言語間の直接翻訳はサポートされていません。翻訳元言語が不明な場合は、source_lang を auto に設定して自動検出できます。
言語 | コード | 翻訳元言語として | 翻訳先言語として |
中国語 | 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 にアップロードして新しい永続的なリンクを生成します。
Q:モデルの使用状況を確認するにはどうすればよいですか?
A:モデルの呼び出しが完了してから 1 時間後に、Model Observation ページで呼び出し回数や成功率などのメトリックを表示できます。詳細については、「モデルの呼び出しレコードの確認方法」をご参照ください。



