Qwen画像生成・編集3.0モデルは、テキストから画像への変換(T2I)と画像から画像への変換/画像編集(I2I)の両方をサポートしています。テキストプロンプトから直接画像を生成したり、1-3枚の参照画像と編集指示を組み合わせて画像を編集したりできます。OpenAI互換プロトコルとDashScopeプロトコルの両方をサポートしています。
モデル概要
モデル | 説明 | 出力画像の仕様 |
|---|---|---|
qwen-image-3.0-pro | テキストから画像への変換(T2I)と画像から画像への変換/画像編集(I2I)の両方をサポートするQwen画像生成・編集3.0モデルです。 | 画像解像度:
画像形式:PNG |
qwen-image-3.0 | テキストから画像への変換(T2I)と画像から画像への変換/画像編集(I2I)の両方をサポートするQwen画像生成・編集3.0標準モデルです。品質と速度のバランスが取れています。 |
可用性
モデル、エンドポイント URL、および API キーは同じリージョンに属している必要があります。クロスリージョン呼び出しは失敗します。
- モデルを選択する:ターゲットリージョンでモデルが利用可能であることを確認してください。
- URLの選択:モデルのリージョンに一致するエンドポイントURLを選択してください。HTTPおよびDashScope SDKのURLの両方がサポートされています。
- APIキーの設定:対象リージョンのAPIキーを取得し、APIキーを環境変数として設定してください。
- SDKのインストール:SDKでAPI呼び出しを行うには、DashScope SDKをインストールしてください。
アクセス方法
Qwen画像生成・編集3.0は、同一のモデル機能を持つ3つのアクセス方法を提供しています。アプリケーションに適したものを選択してください。
アクセス方法 | 使用場面 |
|---|---|
すでにOpenAI ImagesプロトコルまたはOpenAI SDK上に構築されたアプリケーション向けです。 | |
推奨されます。パブリック URL と Base64 画像入力の両方を含む、完全な機能カバレッジを提供します。 | |
バッチ生成、または接続を開いたままにwantない場合に使用します。タスクを送信し、 |
OpenAI 互換
アプリケーションがすでにOpenAI ImagesプロトコルまたはOpenAI SDK上に構築されている場合、リクエスト構造を変更することなく、OpenAI互換モードを通じてQwen画像生成・編集3.0を呼び出すことができます。テキストから画像(T2I)と画像から画像/画像編集(I2I)は同じエンドポイントを共有します:T2Iの場合はomit image とし、I2Iの場合は image を指定します。
/images/generations上のimage拡張フィールドを使用します。公式OpenAIの/images/editsエンドポイントで使用されるマルチパートファイルアップロード形式は使用しません。現在、以下はまだサポートされていません:非同期呼び出し、ストリーミング出力、部分画像、/images/edits、マルチパート、およびマスク。response_format=b64_jsonを渡してもエラーにはなりませんが、無視され、レスポンスには引き続き画像URLが含まれます。非同期呼び出しを行うには、DashScope非同期を使用してください。URL
- Singapore
- 米国(バージニア)
- 中国(北京)
- China (Hong Kong)
- Germany (Frankfurt)
- Japan (Tokyo)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generationsSDK 呼び出し用の base_url:https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1{WorkspaceId}を実際のワークスペースIDに置き換えます。
リクエストパラメーターヘッダーContent-Typestring (必須)リクエストのコンテンツタイプです。application/jsonである必要があります。Authorization string (必須)Model Studio APIキーを使用してリクエストを認証します。例:Bearer sk-xxxx。リクエストボディDashScopeプロトコルとは異なり、OpenAI互換モードではすべてのパラメータがリクエストボディのトップレベルに配置されます。inputやparametersのネストはありません。model string (必須)モデル名です。利用可能な値:qwen-image-3.0-pro および qwen-image-3.0。prompt string (必須)生成または編集wantたい画像の内容、スタイル、構図を記述するポジティブプロンプトです。中国語と英語の両方がサポートされています。推奨最大値:4,500トークン。空文字列にすることはできません。image string または array(任意)入力画像のURLまたはBase64エンコードデータです。テキストから画像への変換(T2I)の場合はこのパラメータを省略してください。画像から画像への変換(I2I)の場合は指定する必要があり、1-3枚の画像がサポートされています。単一画像の場合は文字列を渡し、複数画像の場合は文字列の配列を渡してください。複数の画像が提供される場合、順序は配列のシーケンスによって定義されます。注意:null および空の配列は 400 エラーで拒否されます。画像要件:
integer(オプション)出力画像の数です。値の範囲:1~6。デフォルト:1。整数である必要があります。"1"のような文字列値を指定すると、400エラーが返されます。size string(オプション)出力画像の解像度をwidthxheight形式で指定します(例:"1024x1024")。autoを渡すこともできます。指定しない場合、モデルはプロンプトに基づいて解像度を自動的に推奨します。
string(任意)画像にwantとしない内容を記述するネガティブプロンプトです。seed integer(オプション)ランダムシードです。値の範囲:[0, 2147483647]。省略した場合、サービスはランダムシードを生成します。再現性のある結果を得るには、固定シードを使用してください。prompt_extend boolean(任意)インテリジェントプロンプト書き換えを有効にするかどうかです。デフォルト:true(推奨)。有効にすると、モデルはprompt_extend_modeで指定された方法を使用してポジティブプロンプトを最適化し、単純な説明の場合に結果を大幅に改善します。prompt_extend_mode string(任意)プロンプトの書き換え方法です。デフォルト:direct。オプション:
boolean(任意)思考モードを有効にします。デフォルトはtrueです。これによりモデルの推論能力が強化され画質が向上しますが、生成時間は長くなります。prompt_extend=trueが必要です。ダイレクトT2I、ダイレクトI2I、およびエージェントT2Iでサポートされています。I2Iエージェントではサポートされていません。watermark boolean(オプション)ウォーターマークを追加するかどうか。デフォルト:false。image、negative_prompt、seed、prompt_extend、prompt_extend_mode、enable_thinking、およびwatermarkはModel Studio拡張フィールドであり、公式のOpenAIパラメータではありません。生のHTTPリクエストの場合、これらをリクエストボディのトップレベルに配置してください。OpenAI SDKを使用する場合は、extra_bodyを通じて渡してください。 |
レスポンスパラメーターcreatedintegerレスポンスが作成された際の Unix タイムスタンプ(秒単位)です。data array生成結果のリストです。n が 1 より大きい場合、配列には複数の要素が含まれます。
プロパティ url stringPNG形式で生成された画像のURLです。リンクの有効期間は24時間です。画像を速やかにダウンロードして保存してください。objectこの呼び出しのリソース使用量です。成功時のみ返されます。これらは画像の入出力メータリングフィールドであり、トークン使用量ではありません。
プロパティ output_width integer最終出力画像の幅(ピクセル単位)です。output_height integer最終出力画像の高さ(ピクセル単位)です。input_image_count integerリクエスト内の入力画像の数です。テキストから画像への変換(T2I)の場合は0を返し、画像から画像への変換(I2I)の場合は実際の数を返します。input_image_type string入力画像の課金ティアです。出力解像度のピクセル面積によって決定されます:面積が2,250,000以下の場合はqima_input_1k、面積が2,250,000より大きい場合はqima_input_2kとなります。output_image_count integer返される出力画像の実際の数です。output_image_type string出力画像の課金ティアです。出力解像度のピクセル面積によって決定されます:面積が2,250,000以下の場合はqima_output_1k、面積が2,250,000より大きい場合はqima_output_2kとなります。objectエラーの詳細です。失敗したリクエストに対してのみ返されます。
プロパティ message string詳細なエラーメッセージ。type stringエラータイプ(例:invalid_request_error)。param stringエラーの原因となったパラメーター名、またはエラーが特定のパラメーターに起因しない場合は null です。code stringエラーコードです。エラーコードを参照してください。DashScopeプロトコルとは異なり、OpenAI互換モードではレスポンスボディにrequest_idが返されません request_id。一意のリクエスト識別子はx-request-id HTTPレスポンスヘッダーに返されます。OpenAI Python SDKでは、成功時はresponse._request_idを、失敗時はAPIStatusError.request_idを読み取ってください。問題を報告する際は、この識別子を含めてください。 |
画像 URL は 24 時間のみ保持され、その後自動的に削除されます。生成された画像は速やかに保存してください。 |
SDK
まずOpenAI Python SDKをインストールまたはアップグレードしてください。
DashScope 同期 API(推奨)
HTTP
- Singapore
- 米国(バージニア)
- 中国(北京)
- China (Hong Kong)
- Germany (Frankfurt)
- Japan (Tokyo)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation{WorkspaceId}を実際のワークスペースIDに置き換えます。
リクエストパラメーターヘッダーContent-Typestring (必須)リクエストのコンテンツタイプです。application/jsonである必要があります。Authorization string (必須)Model Studio APIキーを使用してリクエストを認証します。例:Bearer sk-xxxx。リクエストボディmodelstring (必須)モデル名です。利用可能な値:qwen-image-3.0-pro および qwen-image-3.0。input object (必須)入力パラメーターオブジェクトで、以下のフィールドが含まれます。
プロパティ messages array (必須)リクエストコンテンツ配列です。単一ターンの会話のみがサポートされているため、配列にはroleおよびcontentプロパティを持つ正確に1つのオブジェクトを含める必要があります。
プロパティ role string (必須)メッセージ送信者のロールです。user に設定する必要があります。contentarray (必須)メッセージ内容の配列で、ユースケースに応じて異なる組み合わせがあります。
プロパティ image string (I2I に必須)入力画像のURLまたはBase64エンコードデータです。I2Iシナリオでは、1-3枚の画像がサポートされています。複数の画像が提供される場合、順序は配列のシーケンスによって定義されます。画像要件:
string(必須)生成または編集wantたい画像の内容、スタイル、構図を記述するポジティブプロンプトです。中国語と英語の両方がサポートされています。推奨最大値:4,500トークン。注意:許可されるtextオブジェクトは1つだけです。これを省略したり、複数のtextオブジェクトを指定したりすると、エラーが発生します。object(オプション)画像生成を制御するための追加パラメーターです。
プロパティ prompt_extend boolean(任意)インテリジェントプロンプト書き換えを有効にするかどうかです。デフォルト:true(推奨)。有効にすると、モデルはprompt_extend_modeで指定された方法を使用してポジティブプロンプトを最適化し、単純な説明の場合に結果を大幅に改善します。prompt_extend_mode string(任意)プロンプトの書き換え方法です。デフォルト:direct。オプション:
boolean(任意)思考モードを有効にします。デフォルトはtrueです。これによりモデルの推論能力が強化され画質が向上しますが、生成時間は長くなります。prompt_extend=trueが必要です。ダイレクトT2I、ダイレクトI2I、およびエージェントT2Iでサポートされています。I2Iエージェントではサポートされていません。n integer(オプション)出力画像の数です。値の範囲:1 ~ 6。デフォルト:1。size string(オプション)出力画像の解像度をwidth*height形式で指定します(例:"1024*1024")。指定しない場合、モデルはプロンプトに基づいて解像度を自動的に推奨します。
string(任意)画像にwantとしない内容を記述するネガティブプロンプトです。seed integer(オプション)ランダムシードです。値の範囲:[0, 2147483647]。省略した場合、サービスはランダムシードを生成します。再現性のある結果を得るには、固定シードを使用してください。watermark boolean(オプション)ウォーターマークを追加するかどうか。デフォルト:false。 |
レスポンスパラメーターoutputobjectモデルの生成結果が含まれます。
プロパティ rewrite_status stringプロンプト書き換えのステータスです。値は、リクエストで書き換えが有効にされたかどうか、および書き換えの結果によって異なります。choices array結果オプションのリストです。
プロパティ finish_reason stringタスクが停止した理由です。タスクが正常に完了した場合、値は stop になります。message objectモデルから返されるメッセージです。
プロパティ role stringメッセージのロールです。assistant に固定されています。contentarray生成された画像情報を含むメッセージ内容です。
プロパティ image stringPNG形式で生成された画像のURLです。リンクの有効期間は24時間です。画像を速やかにダウンロードして保存してください。objectこの呼び出しのリソース使用量です。成功時のみ返されます。これらは画像の入出力メータリングフィールドであり、トークン使用量ではありません。
プロパティ output_width integer最終出力画像の幅(ピクセル単位)です。output_height integer最終出力画像の高さ(ピクセル単位)です。input_image_count integerリクエスト内の入力画像の数です。テキストから画像への変換(T2I)の場合は0を返し、画像から画像への変換(I2I)の場合は実際の数を返します。input_image_type string入力画像の課金ティアです。出力解像度のピクセル面積によって決定されます:面積が2,250,000以下の場合はqima_input_1k、面積が2,250,000より大きい場合はqima_input_2kとなります。output_image_count integer返される出力画像の実際の数です。output_image_type string出力画像の課金ティアです。出力解像度のピクセル面積によって決定されます:面積が2,250,000以下の場合はqima_output_1k、面積が2,250,000より大きい場合はqima_output_2kとなります。stringトレースおよびトラブルシューティングのための一意のリクエスト識別子です。code stringエラーコードです。失敗したリクエストに対してのみ返されます。エラーコードをご確認ください。message string詳細なエラーメッセージです。失敗したリクエストに対してのみ返されます。エラーコードをご確認ください。 |
タスクデータ(タスクステータスおよび画像URL)は24時間のみ保持され、その後自動的に削除されます。生成された画像は速やかに保存してください。 |
SDK
以下の例では、PythonおよびJava SDKを使用して画像から画像への変換/画像編集(I2I)を行うAPIの呼び出し方法を示します。
DashScope 非同期 API
上記の同期呼び出しに加えて、Qwen画像生成・編集3.0は非同期呼び出しもサポートしています。非同期APIは同期APIと同じリクエストパラメータ構造を共有します。X-DashScope-Async: enableヘッダーを追加するだけで済みます。サービスがリクエストを受理した後、タスクID(task_id)を返しますので、それを使用して最終結果をクエリAPIにポーリングします。
HTTP
非同期呼び出しでは、2段階のワークフローを使用します。
- タスクを作成してタスクIDを取得する:タスク作成のリクエストを送信します。レスポンスにはタスクID(task_id)が含まれます。
- タスクIDを使用して結果をポーリングする:task_idを使用して、タスクが完了し画像URLが返されるまでタスクステータスをポーリングします。
ステップ1:タスクを作成してタスクIDを取得する
- Singapore
- 米国(バージニア)
- 中国(北京)
- China (Hong Kong)
- Germany (Frankfurt)
- Japan (Tokyo)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationリクエストパラメーターヘッダーContent-Typestring (必須)リクエストのコンテンツタイプです。application/jsonである必要があります。Authorization string (必須)Model Studio APIキーを使用してリクエストを認証します。例:Bearer sk-xxxx。X-DashScope-Async string (必須)非同期処理を有効にします。値はenableである必要があります。このセクションのエンドポイントは非同期リクエストのみを受け付け、同期呼び出しはサポートしていません。リクエストボディmodelstring (必須)モデル名です。利用可能な値:qwen-image-3.0-pro および qwen-image-3.0。input object (必須)入力パラメーターオブジェクトで、以下のフィールドが含まれます。
プロパティ messages array (必須)リクエストコンテンツ配列です。単一ターンの会話のみがサポートされているため、配列にはroleおよびcontentプロパティを持つ正確に1つのオブジェクトを含める必要があります。
プロパティ role string (必須)メッセージ送信者のロールです。user に設定する必要があります。contentarray (必須)メッセージ内容の配列で、ユースケースに応じて異なる組み合わせがあります。
プロパティ image string (I2I に必須)入力画像のURLまたはBase64エンコードデータです。I2Iシナリオでは、1-3枚の画像がサポートされています。複数の画像が提供される場合、順序は配列のシーケンスによって定義されます。画像要件:
string(必須)生成または編集wantたい画像の内容、スタイル、構図を記述するポジティブプロンプトです。中国語と英語の両方がサポートされています。推奨最大値:4,500トークン。注意:許可されるtextオブジェクトは1つだけです。これを省略したり、複数のtextオブジェクトを指定したりすると、エラーが発生します。object(オプション)画像生成を制御するための追加パラメーターです。
プロパティ prompt_extend boolean(任意)インテリジェントプロンプト書き換えを有効にするかどうかです。デフォルト:true(推奨)。有効にすると、モデルはprompt_extend_modeで指定された方法を使用してポジティブプロンプトを最適化し、単純な説明の場合に結果を大幅に改善します。prompt_extend_mode string(任意)プロンプトの書き換え方法です。デフォルト:direct。オプション:
boolean(任意)思考モードを有効にします。デフォルトはtrueです。これによりモデルの推論能力が強化され画質が向上しますが、生成時間は長くなります。prompt_extend=trueが必要です。ダイレクトT2I、ダイレクトI2I、およびエージェントT2Iでサポートされています。I2Iエージェントではサポートされていません。n integer(オプション)出力画像の数です。値の範囲:1 ~ 6。デフォルト:1。size string(オプション)出力画像の解像度をwidth*height形式で指定します(例:"1024*1024")。指定しない場合、モデルはプロンプトに基づいて解像度を自動的に推奨します。
string(任意)画像にwantとしない内容を記述するネガティブプロンプトです。seed integer(オプション)ランダムシードです。値の範囲:[0, 2147483647]。省略した場合、サービスはランダムシードを生成します。再現性のある結果を得るには、固定シードを使用してください。watermark boolean(オプション)ウォーターマークを追加するかどうか。デフォルト:false。 |
レスポンスパラメーターoutputobjectタスクの受付情報です。
プロパティ task_id string非同期タスク ID で、タスクのステータスと結果を照会するために使用されます。必ず保存してください。task_status stringタスクステータスです。通常、タスク送信時はPENDINGとなり、これはタスクが受理されたことのみを示し、画像が生成されたことを示すものではありません。stringトレースおよびトラブルシューティングのための一意のリクエスト識別子です。code stringエラーコードです。失敗したリクエストに対してのみ返されます。エラーコードをご確認ください。 |
タスクのステータスと結果を照会するには、 task_idを保存してください。 |
ステップ2:タスクIDを使用して結果をポーリングする
- Singapore
- 米国(バージニア)
- 中国(北京)
- China (Hong Kong)
- Germany (Frankfurt)
- Japan (Tokyo)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}リクエストパラメーターヘッダーAuthorizationstring (必須)Model Studio APIキーを使用してリクエストを認証します。例:Bearer sk-xxxx。URL パスパラメーターtask_idstring (必須)タスクのID。 |
{task_id}を、前のAPI呼び出しで返されたtask_id値に置き換えます。task_idは24時間有効です。{WorkspaceId}を実際のワークスペースIDに置き換えてください。 |
レスポンスパラメーターoutputobjectタスクの出力情報です。
プロパティ task_id stringタスク ID です。24 時間有効です。task_status stringタスクのステータスです。
列挙値
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 です。rewrite_status stringプロンプト書き換えのステータスです。値は、リクエストで書き換えが有効にされたかどうか、および書き換えの結果によって異なります。choices array結果オプションのリストです。
プロパティ finish_reason stringタスクが停止した理由です。タスクが正常に完了した場合、値は stop になります。message objectモデルから返されるメッセージです。
プロパティ role stringメッセージのロールです。assistant に固定されています。contentarray生成された画像情報を含むメッセージ内容です。
プロパティ image stringPNG形式で生成された画像のURLです。リンクの有効期間は24時間です。画像を速やかにダウンロードして保存してください。objectこの呼び出しのリソース使用量です。成功時のみ返されます。これらは画像の入出力メータリングフィールドであり、トークン使用量ではありません。
プロパティ output_width integer最終出力画像の幅(ピクセル単位)です。output_height integer最終出力画像の高さ(ピクセル単位)です。input_image_count integerリクエスト内の入力画像の数です。テキストから画像への変換(T2I)の場合は0を返し、画像から画像への変換(I2I)の場合は実際の数を返します。input_image_type string入力画像の課金ティアです。出力解像度のピクセル面積によって決定されます:面積が2,250,000以下の場合はqima_input_1k、面積が2,250,000より大きい場合はqima_input_2kとなります。output_image_count integer返される出力画像の実際の数です。output_image_type string出力画像の課金ティアです。出力解像度のピクセル面積によって決定されます:面積が2,250,000以下の場合はqima_output_1k、面積が2,250,000より大きい場合はqima_output_2kとなります。stringトレースおよびトラブルシューティングのための一意のリクエスト識別子です。code stringエラーコードです。失敗したリクエストに対してのみ返されます。エラーコードをご確認ください。message string詳細なエラーメッセージです。失敗したリクエストに対してのみ返されます。エラーコードをご確認ください。 |
タスクデータ(タスクステータスおよび画像URL)は24時間のみ保持され、その後自動的に削除されます。生成された画像は速やかに保存してください。 |