Wanxiang 一般画像編集 wan2.5 モデルは、テキストの命令のみで画像を編集および融合し、編集全体で主題の一貫性を維持します。
クイックスタート: ユーザーガイド
呼び出しを行う前に、API キーを取得し、API キーを環境変数としてエクスポートしてください。SDK を使用して呼び出しを行うには、DashScope SDK をインストールします。
画像の編集には 1~2 分かかるため、API は非同期呼び出しを使用します:タスクの作成 → 結果のポーリング。
シンガポールリージョン:
SDK パラメーターは、各言語に合わせてラップされた HTTP API 呼び出しと一致します。
画像の編集には 30~60 秒かかります。SDK は非同期 HTTP フローをラップし、同期呼び出しと非同期呼び出しの両方をサポートします。
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご確認ください。
モデルの概要
モデルの機能 | 入力例 | 出力画像 |
|---|---|---|
単一画像の編集 | ![]() | ![]() 花柄のドレスを、襟と袖口に繊細な刺繍が施されたヴィンテージスタイルのレースガウンに置き換えます。 |
複数画像の融合 | ![]() | ![]() 画像 1 の目覚まし時計を、画像 2 の食卓にある花瓶の横に置きます。 |
モデル名 | モデルの説明 | 出力画像の仕様 |
|---|---|---|
wan2.5-i2i-preview | Wanxiang 2.5 プレビュー 単一画像の編集と複数画像の融合をサポート | 画像フォーマット:PNG。 画像解像度:
|
API を呼び出す前に、ご利用のリージョンでサポートされているモデルと料金を確認してください。
前提条件
呼び出しを行う前に、API キーを取得し、API キーを環境変数としてエクスポートしてください。SDK を使用して呼び出しを行うには、DashScope SDK をインストールします。
HTTP API 呼び出し
画像の編集には 1~2 分かかるため、API は非同期呼び出しを使用します:タスクの作成 → 結果のポーリング。
実際の実行時間は、キューの長さとサービスの負荷によって変動します。
ステップ 1:タスクを作成し、タスク ID を取得する
シンガポールリージョン: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
北京リージョン: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
{WorkspaceId} を実際のワークスペース ID に置き換えてください。
- タスクが作成された後、返された
task_idを使用して結果をクエリします。task_idは 24 時間有効です。重複したタスクを作成しないでください。代わりに、ポーリングを使用して結果を取得してください。 - 初心者向けのガイダンスについては、「Postman または cURL を使用して API を呼び出す」をご参照ください。
リクエストパラメーターリクエストヘッダーContent-Typestring (必須)リクエストのコンテンツタイプ。application/json である必要があります。Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。X-DashScope-Async string (必須)非同期処理を有効にします。HTTP リクエストは非同期呼び出しのみをサポートします。enable である必要があります。リクエストボディmodelstring (必須)モデル名。「サポートされているモデルと料金」をご参照ください。値の例:wan2.5-i2i-preview。input object (必須)プロンプトや画像などの入力フィールド。
プロパティ prompt string (必須)生成される画像に含める要素や視覚的特徴を記述する肯定的なプロンプト。中国語と英語をサポートします。最大:2000 文字 (各文字が 1 としてカウントされます)。超過分は切り捨てられます。プロンプト作成のヒントについては、「テキストから画像へのプロンプトガイド」をご参照ください。値の例:座っている陽気なオレンジ色の猫、リアルで詳細。images array of string (必須)画像 URL の配列。
string (任意)画像から除外する要素を記述する否定的なプロンプト。中国語と英語をサポートします。最大:500 文字。超過分は切り捨てられます。値の例:低解像度、エラー、最低品質、低品質、不完全、余分な指、不適切な比率。object (任意)解像度、プロンプトリライト、ウォーターマークを制御します。
プロパティ size string (任意)出力画像の解像度を width×height フォーマットで設定します。デフォルト:1280×1280。
推奨される解像度と縦横比
size が省略された場合、デフォルトで 1280×1280 ピクセルになり、おおよその縦横比は次のようになります:
integer (任意)生成する画像の数。範囲:1~4。デフォルト:4。テスト中はコストを管理するために 1 に設定してください。watermark boolean (任意)右下隅に「AI Generated」のウォーターマークを追加します。
boolean (任意)LLM ベースのプロンプトリライトを有効にして画質を向上させます。レイテンシが追加されます。
integer (任意)乱数シード。有効範囲:[0, 2147483647]。省略した場合、ランダムなシードが生成されます。指定した場合、n 枚の各画像に n に基づいて連続したシードが割り当てられます。たとえば、n=4 の場合、シードは seed、seed+1、seed+2、seed+3 となります。再現性を向上させるには、シード値を固定してください。確率的な生成のため、同一のシードが同一の出力を保証するわけではありません。 |
レスポンスパラメーターoutputobjectタスクの出力情報。
プロパティ task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。
列挙値
string追跡とトラブルシューティングのためのユニークなリクエスト識別子。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。 |
task_id を保存して、タスクのステータスと結果をクエリします。 |
ステップ 2:タスク ID を使用して結果をクエリする
- シンガポール
- 中国 (北京)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}呼び出す際、{WorkspaceId} を実際のワークスペース ID に置き換えてください。- ポーリングの推奨事項:画像生成には時間がかかります。10 秒などの適切な間隔でポーリングメカニズムを使用してください。
- タスク状態の遷移:PENDING → RUNNING → SUCCEEDED または FAILED。
- 結果リンク:タスクが成功すると、24 時間有効な画像 URL が返されます。画像をダウンロードし、OSS などの永続ストレージに保存してください。
リクエストパラメーターリクエストヘッダーAuthorizationstring (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。URL パスパラメーターtask_idstring (必須)タスクの ID。 |
86ecf553-d340-4e21-xxxxxxxxx を実際の task_id に置き換えてください。API キーはリージョンごとに異なります。詳細については、「API キーの取得」をご参照ください。 中国 (北京) リージョンのモデルを使用する場合、 |
レスポンスパラメーター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 です。results array of object画像 URL、プロンプト、部分的な失敗のエラー詳細を含むタスク結果のリスト。
プロパティ orig_prompt string元の入力プロンプト。リクエストパラメーター prompt に対応します。actual_prompt stringプロンプトリライトが有効な場合に使用される最適化されたプロンプト。無効な場合は返されません。url string生成された画像の URL。code string失敗した画像のエラーコード。部分的な失敗の場合にのみ返されます。message string失敗した画像のエラーメッセージ。部分的な失敗の場合にのみ返されます。objectタスク結果の統計。
プロパティ TOTAL integerタスクの総数。SUCCEEDED integer成功したタスクの数。FAILED integer失敗したタスクの数。stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。object使用状況の統計。成功した結果のみをカウントします。
プロパティ image_count integer正常に生成された画像の数。課金:コスト = 画像数 × 単価。string追跡とトラブルシューティングのためのユニークなリクエスト識別子。 |
画像 URL は 24 時間のみ有効で、その後自動的にパージされます。生成された画像は速やかに保存してください。 |
DashScope SDK 呼び出し
SDK パラメーターは、各言語に合わせてラップされた HTTP API 呼び出しと一致します。
画像の編集には 30~60 秒かかります。SDK は非同期 HTTP フローをラップし、同期呼び出しと非同期呼び出しの両方をサポートします。
実際の実行時間は、キューの長さとサービスの負荷によって変動します。
Python SDK 呼び出し
- 同期呼び出し
- 非同期呼び出し
リクエスト例
この例では、パブリック URL、Base64 エンコーディング、ローカルファイルパスの 3 つの画像入力メソッドをサポートしています。レスポンス例
画像 URL は 24 時間後に期限切れになります。画像を速やかにダウンロードしてください。
Java SDK 呼び出し
- 同期呼び出し
- 非同期呼び出し
リクエスト例
この例では、パブリック URL、Base64 エンコーディング、ローカルファイルパスの 3 つの画像入力メソッドをサポートしています。レスポンス例
画像 URL は 24 時間後に期限切れになります。画像を速やかにダウンロードしてください。
制限事項
- データ保持:タスク ID と画像 URL はどちらも 24 時間後に期限切れになります。期限切れ後はクエリやダウンロードはできません。
- コンテンツモデレーション:すべてのプロンプト、入力画像、出力画像はコンテンツモデレーションを受けます。禁止されたコンテンツを含むリクエストは、「IPInfringementSuspect」や「DataInspectionFailed」などのエラーを返します。詳細については、「エラー情報」をご参照ください。
エラーコード
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご確認ください。
よくある質問
Q:以前に General Image Editing 2.1 を使用していましたが、wan2.5 を使用するために SDK 呼び出しを変更する必要がありますか?
A:はい — バージョン間でパラメーターの設計が異なります:- General Image Editing 2.1:
promptとfunctionの両方のパラメーターが必要です。 - General Image Editing 2.5:のみ
promptが必要です。すべての編集をテキストで記述します。functionパラメーターはサポートされなくなり、不要です。



