Wan2.7-Image は、テキストからの画像生成、テキストからの画像セット生成、画像からの画像セット生成、画像編集、複数画像の参照生成をサポートしています。
モデル概要
モデル | 説明 | 出力画像の仕様 |
|---|---|---|
wan2.7-image-pro | Wan 2.7 画像 Pro。テキストからの画像生成 (画像セットは除く) で 4K 出力をサポートします。 | 画像フォーマット:PNG。 画像の解像度とディメンションについては、size パラメーターをご参照ください。 |
wan2.7-image | Wan 2.7 画像。より高速な生成。 |
モデルを呼び出す前に、モデルリストと価格でリージョンごとのモデルの可用性を確認してください。
前提条件
API キーを取得し、API キーを環境変数としてエクスポートします。
HTTP 同期
単一のリクエストで結果を返します。ほとんどのユースケースで推奨されます。
- シンガポール
- 北京
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation{WorkspaceId} を実際のワークスペース ID に置き換えてください。リクエストパラメーター |
wan2.7-image-pro モデルは、テキストからの画像生成のみ 4K 解像度をサポートします。画像編集と画像セット生成は最大 2K 解像度までサポートします。 |
ヘッダー | |
Content-Type string (必須)リクエストのコンテンツタイプとして application/json を指定する必要があります。 | |
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。 | |
リクエストボディ | |
model string (必須)モデル名。有効な値:wan2.7-image-pro、wan2.7-image。 | |
input object (必須)入力オブジェクト。
プロパティ messages array (必須)リクエストコンテンツの配列。シングルターンの会話のみサポートされています。
プロパティ role string (必須)メッセージのロール。 user である必要があります。content array (必須)メッセージコンテンツの配列。
プロパティ text stringテキストプロンプト。中国語と英語をサポートします。最大 5,000 文字。各文字、英字、数字、記号は 1 文字としてカウントされます。超過した文字は切り捨てられます。image string入力画像の URL または Base64 エンコードされた文字列。画像の制限:
| |
parameters object (任意)モデルのパラメーター設定。
プロパティ bbox_list List[List[List[int]]] (任意)インタラクティブな編集のためのバウンディングボックス領域。
boolean (任意)画像生成モードを制御します:
string (任意)出力画像の解像度。相互に排他的な 2 つのメソッドをサポートします:モデル:wan2.7-image-pro
出力画像のピクセル値は、指定された値とわずかに異なる場合があります。n int (任意)
boolean (任意)思考モードを有効にします。デフォルトは true です。このパラメーターは、画像セットモードが無効で、画像が入力されていない場合にのみ有効です。有効にすると、モデルは推論能力を向上させて出力品質を改善しますが、生成時間が増加します。color_palette array (任意)カスタムカラーテーマ。各オブジェクトが 16 進数カラーと比率を持つオブジェクトの配列。3 から 10 色を含める必要があります。8 色を推奨します。これは、画像セットモードが無効 (enable_sequential=false) の場合にのみ利用可能です。
プロパティ hex string (必須)16 進数 (HEX) 形式のカラー値。ratio string (必須)色のパーセンテージ。小数点以下 2 桁まで正確である必要があります (例:"25.00%")。すべての比率値の合計は 100.00% でなければなりません。
クリックして入力例を表示 bool (任意)画像の右下隅に固定テキスト「AI Generated」のウォーターマークラベルを追加します。
integer (任意)乱数シード。有効範囲:[0,2147483647]。同じ seed を使用すると、類似した出力が得られます。省略した場合、アルゴリズムはランダムなシードを使用します。注:画像生成は確率的です。同じ seed を使用しても、結果が異なる場合があります。 |
レスポンスパラメーター |
タスクデータ (タスクステータスと画像 URL) は 24 時間のみ保持され、その後自動的にパージされます。生成された画像は速やかに保存してください。 |
output objectタスクの出力情報。
プロパティ choices arrayモデルによって生成された出力コンテンツ。
プロパティ finish_reason stringタスクが停止した理由。stop は自然な完了を示します。message objectモデルから返されたメッセージ。
プロパティ role stringメッセージのロール。常に assistant です。content array
プロパティ type string値:image。image string生成された画像の URL。フォーマット:PNG。リンクは 24 時間有効です。速やかに画像をダウンロードしてください。booleanタスクが完了したかどうかを示します。デフォルト:false。 | |
usage objectリクエストの使用統計。成功した結果のみがカウントされます。
プロパティ image_count integer生成された画像の数。size string生成された画像の解像度。例:1376*768。input_tokens integer入力トークンの数 (課金対象外)。課金は画像の数に基づきます。output_tokens integer出力トークンの数 (課金対象外)。課金は画像の数に基づきます。total_tokens integerトークンの総数 (課金対象外)。課金は画像の数に基づきます。 | |
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。 | |
code stringエラーコード。失敗したリクエストに対してのみ返されます。エラーコードをご参照ください。 | |
message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。エラーコードをご参照ください。 |
HTTP 非同期
長時間のタスクに最適です。タスクを送信し、その後ステータスと結果をポーリングします。
ステップ 1:タスクを作成してタスク ID を取得する
- シンガポール
- 北京
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation{WorkspaceId} を実際のワークスペース ID に置き換えてください。リクエストパラメーター |
wan2.7-image-pro モデルは、テキストからの画像生成のみ 4K 解像度をサポートします。画像編集と画像セット生成は最大 2K 解像度までサポートします。 |
ヘッダー | |
Content-Type string (必須)リクエストのコンテンツタイプは、application/json である必要があります。 | |
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。 | |
X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストは、非同期呼び出しのみをサポートします。enable に設定する必要があります。 | |
リクエストボディ | |
model string (必須)モデル名。有効な値:wan2.7-image-pro、wan2.7-image。 | |
input object (必須)入力オブジェクト。
プロパティ messages array (必須)リクエストコンテンツの配列。シングルターンの会話のみサポートされています。
プロパティ role string (必須)メッセージのロール。値は user である必要があります。content array (必須)メッセージコンテンツの配列。
プロパティ text stringテキストプロンプト。中国語と英語をサポートします。最大 5,000 文字。各文字、英字、数字、記号は 1 文字としてカウントされます。超過した文字は切り捨てられます。image string入力画像の URL または Base64 エンコードされた文字列。画像の制限:
| |
parameters object (任意)モデルのパラメーター設定。
プロパティ bbox_list List[List[List[int]]] (任意)インタラクティブな編集のためのバウンディングボックス領域。
boolean (任意)画像生成モードを制御します:
string (任意)出力画像の解像度。相互に排他的な 2 つのメソッドをサポートします:モデル:wan2.7-image-pro
出力画像のピクセル値は、指定された値とわずかに異なる場合があります。n int (任意)
boolean (任意)思考モードを有効にします。デフォルトは true です。このパラメーターは、画像セットモードが無効で、画像が入力されていない場合にのみ有効です。有効にすると、モデルは推論能力を向上させて出力品質を改善しますが、生成時間が増加します。color_palette array (任意)カスタムカラーテーマ。各オブジェクトが 16 進数カラーと比率を持つオブジェクトの配列。3 から 10 色を含める必要があります。8 色を推奨します。これは、画像セットモードが無効 (enable_sequential=false) の場合にのみ利用可能です。
プロパティ hex string (必須)16 進数 (HEX) 形式のカラー値。ratio string (必須)色のパーセンテージ。小数点以下 2 桁まで正確である必要があります (例:"25.00%")。すべての比率値の合計は 100.00% でなければなりません。
クリックして入力例を表示 bool (任意)画像の右下隅に固定テキスト「AI Generated」のウォーターマークラベルを追加します。
integer (任意)乱数シード。有効範囲:[0,2147483647]。同じ seed を使用すると、類似した出力が得られます。省略した場合、アルゴリズムはランダムなシードを使用します。注:画像生成は確率的です。同じ seed を使用しても、結果が異なる場合があります。 |
レスポンスパラメーター |
task_id を保存して、タスクのステータスと結果をクエリします。 |
output objectタスクの出力情報。
プロパティ task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。
列挙値
| |
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。 | |
code stringエラーコード。失敗したリクエストに対してのみ返されます。エラーコードをご参照ください。 | |
message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。エラーコードをご参照ください。 |
ステップ 2:タスク ID で結果をクエリする
- シンガポール
- 北京
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}リクエストパラメーター |
{task_id} を、前の API 呼び出しで返された task_id の値に置き換えます。task_id は 24 時間クエリに有効です。 |
ヘッダー | |
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。 | |
パスパラメーター | |
task_id string (必須)タスクの ID。 |
レスポンスパラメーター |
タスクデータ (タスクステータスと画像 URL) は 24 時間のみ保持され、その後自動的にパージされます。生成された画像は速やかに保存してください。 |
output objectタスクの出力情報。
プロパティ task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。
列挙値
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 です。finished booleanタスクが完了したかどうかを示します。デフォルト:false。choices arrayモデルによって生成された出力コンテンツ。
プロパティ finish_reason stringタスクが停止した理由。stop は自然な完了を示します。message objectモデルから返されたメッセージ。
プロパティ role stringメッセージのロール。常に assistant です。content array
プロパティ type string値:text、image。text string生成されたテキスト。image string生成された画像の URL。フォーマット:PNG。リンクは 24 時間有効です。速やかに画像をダウンロードしてください。 | |
usage objectリクエストの使用統計。成功した結果のみがカウントされます。
プロパティ image_count integer生成された画像の数。size string生成された画像の解像度。例:1376*768。input_tokens integer入力トークンの数 (課金対象外)。課金は画像の数に基づきます。output_tokens integer出力トークンの数 (課金対象外)。課金は画像の数に基づきます。total_tokens integerトークンの総数 (課金対象外)。課金は画像の数に基づきます。 | |
request_id stringトレースとトラブルシューティングのための一意のリクエスト識別子。 | |
code stringエラーコード。失敗したリクエストに対してのみ返されます。エラーコードをご参照ください。 | |
message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。エラーコードをご参照ください。 |
Python SDK
SDK のパラメーター名は、HTTP API とほぼ一致しています。
画像生成タスクには時間がかかることがあるため、SDK は HTTP 非同期ワークフローをラップしています。同期呼び出しと非同期呼び出しの両方がサポートされています。
タスクの所要時間は、キューの長さとサービスのステータスに依存します。
base_url と API キーは両方ともリージョン固有です。次の例では、シンガポールリージョンを使用しています:
- シンガポール
- 中国 (北京)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1呼び出す際、{WorkspaceId} を実際のワークスペース ID に置き換えてください。画像編集
- 同期呼び出し
- 非同期呼び出し
リクエスト例
レスポンス例
URL は 24 時間有効です。速やかに画像をダウンロードしてください。
画像セット生成
- 同期呼び出し
- 非同期呼び出し
リクエスト例
レスポンス例
URL は 24 時間有効です。速やかに画像をダウンロードしてください。
Java SDK
SDK のパラメーター名は、HTTP API とほぼ一致しています。
画像生成タスクには時間がかかることがあるため、SDK は HTTP 非同期ワークフローをラップしています。同期呼び出しと非同期呼び出しの両方がサポートされています。
- シンガポール
- 中国 (北京)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1呼び出す際、{WorkspaceId} を実際のワークスペース ID に置き換えてください。画像編集
- 同期呼び出し
- 非同期呼び出し
リクエスト例
レスポンス例
URL は 24 時間有効です。速やかに保存してください。
画像セット生成
- 同期呼び出し
- 非同期呼び出し
リクエスト例
レスポンス例
URL は 24 時間有効です。速やかに保存してください。
課金とレート制限
- モデルの無料クォータと単価については、モデルの価格設定をご参照ください。
- モデルのレート制限については、Wanxiangをご参照ください。
- 課金の詳細:正常に生成された画像の数に基づいて課金されます。失敗した呼び出しや処理エラーは、料金が発生したり、新規ユーザー向けの無料クォータを消費したりすることはありません。