Skip to main content

Wan2.6 - 画像生成と編集

Wan2.6 は、複数画像の入力、画像編集、テキストと画像のインターリーブ出力をサポートします。

モデル概要

モデル

説明

出力画像の仕様

wan2.6-image

画像を編集し、テキストと画像のインターリーブ出力を生成します。

画像フォーマット:PNG

画像の解像度とディメンションは size パラメーター を通じて設定されます。

API を呼び出す前に、各リージョンでサポートされているモデルリストと料金を確認してください。

前提条件

API キーを取得し、API キーを環境変数としてエクスポートします。
シンガポール、米国 (バージニア)、中国 (北京) リージョンには、それぞれ個別の API キーとリクエストエンドポイントがあります。これらは相互に利用することはできません。リージョンをまたいだ呼び出しは、認証失敗やサービスエラーにつながります。詳細については、「リージョンとサービスデプロイ範囲の選択」をご参照ください。

HTTP 同期

1 回のリクエストで結果を返します。ほとんどのシナリオで推奨されます。
  • シンガポール
  • 米国 (バージニア)
  • 中国 (北京)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation呼び出す際、{WorkspaceId} を実際の ワークスペース ID に置き換えてください。
グローバルデプロイメント範囲 (フランクフルトリージョン) は非同期呼び出しのみをサポートします。

リクエストパラメーター

  • 画像編集
  • テキストと画像のインターリーブ出力 (ストリーミングのみ)
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
    --header 'Content-Type: application/json' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --data '{
        "model": "wan2.6-image",
        "input": {
            "messages": [
                {
                    "role": "user",
                    "content": [
                        {
                            "text": "画像1のスタイルと画像2の背景に基づいて、トマトと卵の炒め物を生成してください"
                        },
                        {
                            "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
                        },
                        {
                            "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
                        }
                    ]
                }
            ]
        },
        "parameters": {
            "prompt_extend": true,
            "watermark": false,
            "n": 1,
            "enable_interleave": false,
            "size": "1K"
        }
    }'
リクエストヘッダー
Content-Type string (必須)リクエストのコンテンツタイプ。 application/json にする必要があります。
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。
X-DashScope-SSEstring (任意)ストリーミング出力を有効にします。
  • parameters.enable_interleave=true の場合、enable に設定します。
  • その他の場合は、このヘッダーを省略します。
リクエストボディ
model string (必須)モデル名。wan2.6-image に設定します。
input object (必須)入力設定。

プロパティ

messages array (必須)リクエストコンテンツの配列。シングルターンの会話のみサポートされています -- 1 つの role-content ペアを提供してください。

プロパティ

rolestring (必須)メッセージのロール。 user に設定します。contentarray (必須)メッセージコンテンツの配列。

プロパティ

textstring(必須)希望する画像の内容、スタイル、構成を記述するポジティブプロンプト。中国語と英語をサポートします。最大 2,000 文字 (各漢字、文字、数字、記号は 1 文字としてカウント)。超過した場合は自動的に切り捨てられます。例:この画像のスタイルに基づいてトマトと卵の炒め物を生成します。注: content 配列には、text フィールドを持つオブジェクトを正確に 1 つ含める必要があります。imagestring(任意)入力画像の URL または Base64 エンコードされた文字列。画像の制約:
  • 画像フォーマット:JPEG、JPG、PNG (アルファチャンネルはサポートされていません)、BMP、WebP。
  • 画像解像度:幅と高さはそれぞれ 240 から 8,000 ピクセルの間である必要があります。
  • ファイルサイズ:10 MB を超えてはなりません。
画像数の制限:
  • 入力イメージの数は、parameters.enable_interleave パラメーターによって決まります。
    • enable_interleave=true (テキストと画像のインターリーブ出力) の場合、0~1 個のイメージを入力できます。
    • enable_interleave=false (画像編集) の場合、1~4 個のイメージを入力する必要があります。
  • 複数のイメージを入力する場合、content 配列に複数の image オブジェクトを含め、配列のシーケンスでイメージの順序を定義します。
サポートされている入力フォーマット:
  1. 公開アクセス可能な URL を使用
    • HTTP または HTTPS プロトコルをサポートします。
    • 例: http://wanx.alicdn.com/material/xxx.jpeg。
  2. Base64 エンコードされた画像文字列を提供
    • フォーマット:data:{MIME_type};base64,{base64_data}
    • 例:data:image/jpeg;base64,GDU7MtCZzEbTbmRZ... (説明のためのみ。実際には完全な文字列を提供してください)
    • Base64 エンコーディングのガイドラインについては、「画像入力メソッド」をご参照ください。
parameters object (任意)生成パラメーター。

プロパティ

negative_prompt string (任意)画像に含めたくないものを記述するネガティブプロンプト。中国語と英語をサポートします。最大長は 500 文字です。超過した文字は自動的に切り捨てられます。例:低解像度、低品質、歪んだ手足、奇形の指、過飽和の色、ワックスのような外観、顔の詳細なし、過度に滑らかな表面、AI 生成の外観。混沌とした構成。ぼやけたまたは歪んだテキスト。size string (任意)出力画像の解像度。入力画像の比率を参照する方法と、ディメンションを直接指定する方法の 2 つをサポートします。enable_interleave=false の場合 (画像編集モード):
  • 方法 1:入力画像の比率を参照 (推奨) 利用可能な出力解像度オプション: 1K (デフォルト)、2K。
    • 1K:最後の入力イメージの縦横比を維持し、総ピクセル数が 1280*1280 に近くなるように出力します。
    • 2K: 最後の入力イメージの縦横比を維持し、総ピクセル数が約 2048*2048 になるように出力します。
  • 方法 2:出力画像の幅と高さをピクセルで指定 総ピクセル数は [768768, 20482048] の範囲内、アスペクト比は [1:4, 4:1] の範囲内である必要があります。
    実際の出力ピクセル値は、指定された値に最も近い 16 の倍数になります。
enable_interleave=true の場合 (テキストと画像のインターリーブ出力モード):
  • 方法 1:入力画像の比率を参照 (デフォルトの方法)
    • 入力画像の総ピクセル数が 1280*1280 以下の場合、出力は入力の総ピクセル数とアスペクト比に一致します。
    • 入力画像の総ピクセル数が 12801280 より大きい場合、出力の総ピクセル数は 12801280 に近く、入力のアスペクト比を維持します。
    • 入力画像が提供されない場合、出力サイズは 1280*1280 です。
  • 方法 2:出力画像の幅と高さをピクセルで指定 総ピクセル数は [768768, 12801280] の範囲内、アスペクト比は [1:4, 4:1] の範囲内である必要があります。
    実際の出力ピクセル値は、指定された値に最も近い 16 の倍数になります。

一般的なアスペクト比の推奨解像度

  • 1:1: 1280*1280
  • 2:3: 800*1200
  • 3:2: 1200*800
  • 3:4: 960*1280
  • 4:3: 1280*960
  • 9:16: 720*1280
  • 16:9: 1280*720
  • 21:9: 1344*576
enable_interleave bool (任意)画像生成モードを制御します:
  • false (デフォルト):画像編集モードを示します (複数画像の入力と主題の一貫性生成をサポート)。
    • ユースケース:1 から 4 枚の入力画像に基づいて、編集、スタイル変換、または主題の一貫性のある画像を生成します。
    • 入力:少なくとも 1 枚の参照画像を提供する必要があります。
    • 出力:1 から 4 枚の結果画像を生成できます。
  • true:テキストと画像のインターリーブ出力モードを有効にします (1 枚の画像または画像なしの入力をサポート)。
    • ユースケース:テキスト記述に基づいてテキストと画像を組み合わせたコンテンツを生成するか、純粋なテキストからの画像生成を実行します。
    • 入力:画像なし (テキストからの画像生成) または最大 1 枚の参照画像を提供できます。
    • 出力:テキストと画像の両方を含む混合コンテンツを生成します。
n integer (任意)
このパラメーターはコストに影響します (成功した画像ごとに課金されます -- 「料金」をご参照ください)。
生成するイメージ数。動作は enable_interleave によって異なります:
  • enable_interleave=false (画像編集モード) の場合:
    • 生成される画像の数を直接制御します。
    • 範囲:1 から 4。デフォルト値は 4 です。
    • テスト中は、低コストの検証のためにこの値を 1 に設定してください。
  • enable_interleave=true (インターリーブ テキスト-イメージ モード) の場合:
    • デフォルトは 1 で、1 のままである必要があります。その他の値はエラーを引き起こします。
    • このモードでは、max_imagesを使用してイメージ数をコントロールします。
max_images integer (任意)
このパラメーターはコストに影響します (成功した画像ごとに課金されます -- 「料金」をご参照ください)。
テキストとイメージのインターリーブモード (enable_interleave=true) でのみ有効です。
  • モデルが 1 回の応答で生成する画像の最大数。
  • 範囲:1 から 5。デフォルト値は 5 です。
  • 上限を設定します。モデルは要求されたよりも少ない画像を生成する場合があります。
prompt_extend bool (任意)画像編集モード (enable_interleave = false) でのみ有効です。インテリジェントなプロンプトリライトを有効にします。ポジティブプロンプトのみを最適化し、ネガティブプロンプトは変更されません。
  • true (デフォルト)
  • false
stream bool (任意)ストリーミング出力を有効にします。enable_interleave=true の場合、true に設定することが必須です。
  • false (デフォルト)
  • true
watermark bool (任意)画像の右下隅に固定テキスト「AI Generated」のウォーターマークラベルを追加します。
  • false (デフォルト)
  • true
seed integer (任意)乱数シード。有効値: [0,2147483647]。同じ seed を使用すると、類似した出力が得られます。省略した場合、アルゴリズムはランダムシードを使用します。注: 画像生成は確率的です。同じ seed を使用しても、結果が異なる場合があります。

レスポンスパラメーター

  • タスク実行成功
  • タスク実行成功 (ストリーミング出力)
  • タスク実行失敗
タスクデータ (タスクステータスと画像 URL) は 24 時間のみ保持され、その後自動的にパージされます。生成された画像は速やかに保存してください。
{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ],
                    "role": "assistant"
                }
            }
        ],
        "finished": true
    },
    "usage": {
        "image_count": 1,
        "input_tokens": 0,
        "output_tokens": 0,
        "size": "1376*768",
        "total_tokens": 0
    },
    "request_id": "a3f4befe-cacd-49c9-8298-xxxxxx"
}
output objectタスクの出力。

プロパティ

choices array of objectモデルが生成した出力コンテンツ。

プロパティ

finish_reason stringタスク終了の理由。非ストリーミング出力シナリオ: stop で自然に停止します。ストリーミング出力シナリオ:このパラメーターは、データストリームの送信が完了したかどうかを示します。
  • 伝送中: 先行するデータパケットは継続的に "finish_reason": "null" を返し、コンテンツがまだ生成されていることを示します。受信を続行します。
  • 送信終了時: 最後の JSON 構造のみが "finish_reason":"stop" を返し、ストリーミングリクエストが完全に完了したことを示します。受信を停止します。
message objectモデルから返されたメッセージ。

プロパティ

rolestringメッセージロールは、assistant に固定されています。contentarray

プロパティ

type string出力タイプ。列挙値:text、image。text string生成されたテキスト。image string生成された画像の PNG 形式の URL。リンクは 24 時間後に有効期限が切れます。画像を速やかにダウンロードして保存してください。
finished boolリクエスト完了フラグ。
  • true
  • false
usage object出力統計。成功した結果のみをカウントします。

プロパティ

image_count integer生成された画像の数。size string生成された画像の解像度。例:1376*768。input_tokens integer画像数ごとに課金されます。
  • 画像編集モードでは、0 に固定されます。
  • テキストと画像のインターリーブモードでは、このフィールドは入力テキストトークンをカウントします (課金されません)。
output_tokens integer画像数ごとに課金されます。
  • 画像編集モードでは、0 に固定されます。
  • テキストと画像のインターリーブモードでは、このフィールドは出力テキストトークンをカウントします (課金されません)。
total_tokensinteger画像数ごとに課金されます。
  • 画像編集モードでは、0 に固定されます。
  • テキストと画像のインターリーブモードでは、このフィールドは合計トークンをカウントします (課金されません)。
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に置き換えてください。
  • タスクの作成後、返された task_id を使用して結果をクエリします。 task_id は 24 時間有効です。 重複したタスクを作成しないでください。 代わりに、ポーリングを使用して結果を取得してください。
  • 初心者向けのガイダンスについては、「Postman または cURL で API を呼び出す」をご参照ください。

リクエストパラメーター

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
    --header 'Content-Type: application/json' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header 'X-DashScope-Async: enable' \
    --data '{
        "model": "wan2.6-image",
        "input": {
            "messages": [
                {
                    "role": "user",
                    "content": [
                        {
                            "text": "画像1のスタイルと画像2の背景に基づいて、トマトと卵の炒め物を生成してください"
                        },
                        {
                            "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
                        },
                        {
                            "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
                        }
                    ]
                }
            ]
        },
        "parameters": {
            "prompt_extend": true,
            "watermark": false,
            "n": 1,
            "enable_interleave": false,
            "size": "1K"
        }
    }'
リクエストヘッダー
Content-Type string (必須)リクエストのコンテンツタイプは application/json である必要があります。
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。
X-DashScope-Asyncstring(必須)非同期モードのスイッチ。設定必須の値: enable。
このヘッダーを省略すると、「current user api does not support synchronous calls」というエラーが返されます。
リクエストボディ
model string (必須)モデル名。例:wan2.6-image
input object (必須)入力設定。

プロパティ

messages array (必須)リクエストコンテンツの配列。シングルターンの会話のみサポートされています — 1 つの role-content ペアを提供してください。マルチターンの会話はサポートされていません。

プロパティ

rolestring (必須)メッセージのロール。 user を指定します。contentarray (必須)メッセージコンテンツの配列。

プロパティ

textstring(必須)希望する画像の内容、スタイル、構成を記述するポジティブプロンプト。中国語と英語をサポートします。最大 2,000 文字 (各漢字、文字、数字、記号は 1 文字としてカウント)。超過した場合は自動的に切り捨てられます。例:この画像のスタイルに基づいてトマトと卵の炒め物を生成します。注: content 配列には、text フィールドを持つオブジェクトを 1 つだけ含める必要があります。imagestring(任意)入力画像の URL または Base64 エンコードされた文字列。画像の制約:
  • 画像フォーマット:JPEG、JPG、PNG (アルファチャンネルはサポートされていません)、BMP、WebP。
  • 画像解像度:幅と高さはそれぞれ 240 から 8,000 ピクセルの間である必要があります。
  • ファイルサイズ:10 MB を超えてはなりません。
画像数の制限:
  • 入力イメージの数は、parameters.enable_interleave パラメーターによって異なります。
    • enable_interleave=true (テキストとイメージのインターリーブ出力) の場合、0~1 個のイメージを入力できます。
    • enable_interleave=false (画像編集) の場合、1~4 個のイメージを入力する必要があります。
  • 複数のイメージを入力する場合、content 配列に複数の image オブジェクトを含め、配列のシーケンスによってイメージの順序を定義します。
サポートされている入力フォーマット:
  1. 公開アクセス可能な URL を使用
    • HTTP または HTTPS プロトコルをサポートします。
    • 例:http://wanx.alicdn.com/material/xxx.jpeg。
  2. Base64 エンコードされた画像文字列を提供
    • フォーマット:data:{MIME_type};base64,{base64_data}
    • 例:data:image/jpeg;base64,GDU7MtCZzEbTbmRZ... (説明のためのみ。実際には完全な文字列を提供してください)
    • Base64 エンコーディングのガイドラインについては、「画像入力メソッド」をご参照ください。
parameters object (任意)生成パラメーター。

プロパティ

negative_prompt string (任意)画像に含めたくないものを記述するネガティブプロンプト。中国語と英語をサポートします。最大長は 500 文字です。超過した文字は自動的に切り捨てられます。例:低解像度、低品質、歪んだ手足、奇形の指、過飽和の色、ワックスのような外観、顔の詳細なし、過度に滑らかな表面、AI 生成の外観。混沌とした構成。ぼやけたまたは歪んだテキスト。size string (任意)出力画像の解像度。入力画像の比率を参照する方法と、ディメンションを直接指定する方法の 2 つをサポートします。enable_interleave=false (画像編集モード) の場合:
  • 方法 1:入力画像の比率を参照 (推奨) 選択可能な出力解像度オプション: 1K(デフォルト)、 2K。
    • 1K: 最後の入力イメージの縦横比を維持し、総ピクセル数が約 1280*1280 になるように出力します。
    • 2K: 最後の入力イメージの縦横比を維持し、総ピクセル数が 2048*2048 に近くなるように出力します。
  • 方法 2:出力画像の幅と高さをピクセルで指定 総ピクセル数は [768768, 20482048] の範囲内、アスペクト比は [1:4, 4:1] の範囲内である必要があります。
    実際の出力ピクセル値は、指定された値に最も近い 16 の倍数になります。
enable_interleave=true (テキストと画像の交互出力モード) の場合:
  • 方法 1:入力画像の比率を参照 (デフォルトの方法)
    • 入力画像の総ピクセル数が 1280*1280 以下の場合、出力は入力の総ピクセル数とアスペクト比に一致します。
    • 入力画像の総ピクセル数が 12801280 より大きい場合、出力の総ピクセル数は 12801280 に近く、入力のアスペクト比を維持します。
    • 入力画像が提供されない場合、出力サイズは 1280*1280 です。
  • 方法 2:出力画像の幅と高さをピクセルで指定 総ピクセル数は [768768, 12801280] の範囲内、アスペクト比は [1:4, 4:1] の範囲内である必要があります。
    実際の出力ピクセル値は、指定された値に最も近い 16 の倍数になります。

一般的なアスペクト比の推奨解像度

  • 1:1: 1280*1280
  • 2:3: 800*1200
  • 3:2: 1200*800
  • 3:4: 960*1280
  • 4:3: 1280*960
  • 9:16: 720*1280
  • 16:9: 1280*720
  • 21:9: 1344*576
enable_interleave bool (任意)画像生成モードを制御します:
  • false (デフォルト):画像編集モードを示します (複数画像の入力と主題の一貫性生成をサポート)。
    • ユースケース:1 から 4 枚の入力画像に基づいて、編集、スタイル変換、または主題の一貫性のある画像を生成します。
    • 入力:少なくとも 1 枚の参照画像を提供する必要があります。
    • 出力:1 から 4 枚の結果画像を生成できます。
  • true:テキストと画像のインターリーブ出力モードを有効にします (1 枚の画像または画像なしの入力をサポート)。
    • ユースケース:テキスト記述に基づいてテキストと画像を組み合わせたコンテンツを生成するか、純粋なテキストからの画像生成を実行します。
    • 入力:画像なし (テキストからの画像生成) または最大 1 枚の参照画像を提供できます。
    • 出力:テキストと画像の両方を含む混合コンテンツを生成します。
n integer (任意)
このパラメーターはコストに影響します (成功した画像ごとに課金されます -- 「料金」をご参照ください)。
生成するイメージの数。動作は enable_interleave によって異なります:
  • enable_interleave=false の場合 (画像編集モード):
    • 生成される画像の数を直接制御します。
    • 範囲:1 から 4。デフォルト値は 4 です。
    • テスト中は、低コストの検証のためにこの値を 1 に設定してください。
  • enable_interleave=true (テキストとイメージのインターリーブモード) の場合:
    • デフォルトは 1 で、1 のままである必要があります。その他の値はエラーを引き起こします。
    • このモードでは、 max_images を使用してイメージ数をコントロールします。
max_images integer (任意)
このパラメーターはコストに影響します (成功した画像ごとに課金されます -- 「料金」をご参照ください)。
テキストとイメージのインターリーブモード (enable_interleave=true) でのみ有効です。
  • モデルが 1 回の応答で生成する画像の最大数。
  • 範囲:1 から 5。デフォルト値は 5 です。
  • 上限を設定します。モデルは要求されたよりも少ない画像を生成する場合があります。
prompt_extend bool (任意)画像編集モード (enable_interleave = false) でのみ有効です。インテリジェントなプロンプトリライトを有効にします。ポジティブプロンプトのみを最適化し、ネガティブプロンプトは変更されません。
  • true (デフォルト)
  • false
watermark bool (任意)画像の右下隅に固定テキスト「AI Generated」のウォーターマークラベルを追加します。
  • false (デフォルト)
  • true
seed integer (任意)乱数シード。有効値: [0,2147483647]。同じ seed を使用すると、同様の出力が得られます。省略した場合、アルゴリズムはランダムなシードを使用します。注: 画像生成は確率的であるため、同じシードを使用しても結果が異なる場合があります。

レスポンスパラメーター

  • 成功した応答
  • エラー応答
タスクステータスと結果をクエリするために、task_id を保存します。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}
output objectタスクの出力。

プロパティ

task_id stringタスク ID。クエリに対して 24 時間有効です。task_status stringタスクのステータス。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN:タスクが存在しないか、ステータスが不明です。
request_id stringトレースとトラブルシューティングのためのユニークなリクエスト識別子。
code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。
message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。

ステップ 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 などの永続ストレージに保存してください。

リクエストパラメーター

  • タスク結果のクエリ
{task_id} を、前の API 呼び出しから返された task_id の値で置き換えます。task_id は 24 時間クエリに対して有効であり、{WorkspaceId} を実際の ワークスペース ID で置き換えます。
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
リクエストヘッダー
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。
URL パスパラメーター
task_id string (必須)タスクの ID。

レスポンスパラメーター

  • タスク実行成功
  • タスク実行失敗
タスクデータ (タスクステータスと画像 URL) は 24 時間のみ保持され、その後自動的にパージされます。生成された画像は速やかに保存してください。
{
    "request_id": "43d9e959-25bc-4dc7-9888-xxxxxx",
    "output": {
        "task_id": "858cad55-4bdc-4ba3-ae6c-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-12-16 04:21:02.275",
        "scheduled_time": "2025-12-16 04:21:02.304",
        "end_time": "2025-12-16 04:24:46.658",
        "finished": true,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            },
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ]
    },
    "usage": {
        "size": "1376*768",
        "total_tokens": 0,
        "image_count": 2,
        "output_tokens": 0,
        "input_tokens": 0
    }
}
output objectタスクの出力情報。

プロパティ

task_id stringタスク ID。クエリに対して 24 時間有効です。task_status stringタスクのステータス。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN:タスクが存在しないか、ステータスが不明です。
ポーリング中の状態遷移:
  • PENDING → RUNNING → SUCCEEDED または FAILED。
  • 初期のクエリステータスは通常 PENDING または RUNNING です。
  • ステータスが SUCCEEDED に変わると、レスポンスには生成された画像の URL が含まれます。
  • ステータスが FAILED の場合は、エラーメッセージを確認してタスクを再試行してください。
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 です。finished boolリクエスト完了フラグ。
  • true
  • false
choices array of objectモデルが生成した出力コンテンツ。

プロパティ

finish_reason stringタスクの終了理由。自然に終了した場合は stop です。message objectモデルから返されたメッセージ。

プロパティ

rolestringメッセージロールは assistant に固定されています。contentarray

プロパティ

type string出力タイプ。列挙値:text、image。text string生成されたテキスト。image string生成された画像の PNG 形式の URL。リンクは 24 時間後に有効期限が切れます。画像を速やかにダウンロードして保存してください。
usage object出力統計。成功した結果のみをカウントします。

プロパティ

image_count integer生成された画像の数。size string生成された画像の解像度。例:1376*768。input_tokens integer入力トークン数。画像数ごとに課金されます。現在は 0 に固定されています。output_tokens integer出力トークン数。画像数ごとに課金されます。現在は 0 に固定されています。total_tokensinteger合計トークン数。画像数ごとに課金されます。現在は 0 に固定されています。
request_id stringトレースとトラブルシューティングのためのユニークなリクエスト識別子。
code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。
message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。

DashScope Python SDK

SDK パラメーターは HTTP インターフェイスと一致しており、言語の規則に従って適応されています。 SDK は内部で非同期呼び出しを処理し、同期呼び出しと非同期呼び出しの両方をサポートします。
実際の持続時間は、キューの長さとサービスの負荷によって異なります。
DashScope Python SDK バージョン 1.25.8 以降が必要です。SDK のインストール。
base_url と API キーは、リージョンごとに異なります。シンガポールリージョンからの呼び出し例:
  • シンガポール
  • 米国 (バージニア)
  • 中国 (北京)
  • ドイツ (フランクフルト)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1呼び出し時、{WorkspaceId} を実際の ワークスペース ID に置き換えてください。
グローバルデプロイメント範囲 (フランクフルトリージョン) は非同期呼び出しのみをサポートします。

画像編集

  • 同期
  • 非同期
リクエスト例
import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# シンガポールリージョンの base_url。ベース URL はリージョンによって異なります。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 環境変数が設定されていない場合は、次の行を api_key="sk-xxx" に置き換えてください。
# API キーはリージョンによって異なります。API キーの取得:https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

message = Message(
    role="user",
    # ローカルファイルをサポートします。例:"image": "file://umbrella1.png"
    content=[
        {
            "text": "画像1のスタイルと画像2の背景に基づいて、トマトと卵の炒め物を生成してください"
        },
        {
            "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
        },
        {
            "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
        }
    ]
)
print("----同期呼び出し、しばらくお待ちください----")
rsp = ImageGeneration.call(
        model='wan2.6-image',
        api_key=api_key,
        messages=[message],
        negative_prompt="",
        prompt_extend=True,
        watermark=False,
        n=1,
        enable_interleave=False,
        size="1K"
    )

print(rsp)
レスポンス例
URL は 24 時間後に有効期限が切れます。画像を速やかにダウンロードしてください。
{
    "status_code": 200,
    "request_id": "b6a4c68d-3a91-4018-ae96-3cf373xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "audio": null,
        "finished": true
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0,
        "image_count": 1,
        "size": "1376*768",
        "total_tokens": 0
    }
}
出力統計は、output と同じレベルのトップレベル usage フィールドで返され、response.usage["image_count"] のように読み取ります。output オブジェクトは統計情報を含まないため、response.output.usage は {} として返され、image_count を含みません。

テキストと画像のインターリーブ出力

  • 同期 (ストリーミングのみ)
  • 非同期
リクエスト例
import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# シンガポールリージョンの URL。ベース URL はリージョンによって異なります。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 環境変数が設定されていない場合は、次の行を api_key="sk-xxx" に置き換えてください。
# API キーはリージョンによって異なります。API キーの取得:https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

def sync_call_with_stream():
    print("\n========== 同期呼び出し - ストリーミングテキスト画像出力 ==========")

    image_message = Message(
        role="user",
        content=[
            {
                "text": "ピーマンと豚肉の炒め物の3枚の画像チュートリアルをください"
            }
        ]
    )

    image_stream_res = ImageGeneration.call(
        model="wan2.6-image",
        api_key=api_key,
        messages=[image_message],
        stream=True,  # ストリーミングのみ
        negative_prompt="",
        enable_interleave=True,
        max_images=3,
        size="1280*1280"
    )

    print("ストリーミング出力結果:")
    for stream_res in image_stream_res:
        print(stream_res)

if __name__ == "__main__":
    sync_call_with_stream()
レスポンス例
URL は 24 時間後に有効期限が切れます。画像を速やかにダウンロードしてください。
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "Chili"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 0, "characters": 0, "total_tokens": 28, "image_count": 0, "size": "0*0"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "Stir-fry"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 1, "characters": 0, "total_tokens": 29, "image_count": 0, "size": "0*0"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "Pork"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 2, "characters": 0, "total_tokens": 30, "image_count": 0, "size": "0*0"}}

......

{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "."}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 398, "characters": 0, "total_tokens": 426, "image_count": 2, "size": "1280*1280"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": "stop", "choices": [{"finish_reason": "stop", "message": {"role": "assistant", "content": [{"type": "image", "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}], "audio": null, "finished": true}, "usage": {"input_tokens": 28, "output_tokens": 523, "characters": 0, "total_tokens": 551, "image_count": 3, "size": "1280*1280"}}

DashScope Java SDK

SDK パラメーターは HTTP インターフェイスと一致しており、言語の規則に従ってカプセル化されています。 SDK は内部で非同期呼び出しを処理し、同期呼び出しと非同期呼び出しの両方をサポートします。
実際の持続時間は、キューの長さとサービスの負荷によって異なります。
DashScope Java SDK バージョン 2.22.6 以降が必要です。
base_url と API キーはリージョン間で互換性がなく、シンガポールリージョンでの例は次のとおりです。
  • シンガポール
  • 米国 (バージニア)
  • 中国 (北京)
  • ドイツ (フランクフルト)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1呼び出す際、{WorkspaceId} を実際のワークスペース ID に置き換えてください。
グローバルデプロイメント範囲 (フランクフルトリージョン) は非同期呼び出しのみをサポートします。

画像編集

  • 同期
  • 非同期
リクエスト例
import com.alibaba.dashscope.aigc.imagegeneration.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.Arrays;
import java.util.Collections;

/**
 * wan2.6-image 画像編集 - 同期呼び出し例
 */
public class Main {

    static {
        // シンガポールリージョンの URL。ベース URL はリージョンによって異なります。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // 環境変数が設定されていない場合は、次の行を apiKey="sk-xxx" に置き換えてください。
    // API キーはリージョンによって異なります。API キーの取得:https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void basicCall() throws ApiException, NoApiKeyException, UploadFileException {
        // 複数画像入力メッセージの構築
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Arrays.asList(
                        // 複数画像入力をサポート。複数の参照画像を提供
                        Collections.singletonMap("text", "画像1のスタイルと画像2の背景に基づいて、トマトと卵の炒め物を生成してください"),
                        Collections.singletonMap("image", "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"),
                        Collections.singletonMap("image", "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp")
                )).build();

        // 画像編集は標準の同期呼び出しを使用。stream や enable_interleave の設定は不要
        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .messages(Collections.singletonList(message))
                .n(1)
                .size("1K")
                .negativePrompt("")
                .promptExtend(true)
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        ImageGenerationResult result = null;
        try {
            System.out.println("---画像編集の同期呼び出し、しばらくお待ちください----");
            result = imageGeneration.call(param);
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            basicCall();
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            System.out.println(e.getMessage());
        }
    }
}
レスポンス例
URL は 24 時間後に有効期限が切れます。画像を速やかにダウンロードしてください。
{
    "requestId": "b148327e-830f-414c-a8df-724dec28exxx",
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "total_tokens": 0,
        "image_count": 1,
        "size": "1376*768"
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "finished": true
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

テキストと画像のインターリーブ出力

  • 同期呼び出し (ストリーミングのみ)
  • 非同期呼び出し
リクエスト例
import com.alibaba.dashscope.aigc.imagegeneration.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;
import io.reactivex.Flowable;

import java.util.Collections;

/**
 * wan2.6-image テキスト画像出力 - ストリーミング呼び出し例
 */
public class Main {

    static {
        // シンガポールリージョンの URL。ベース URL はリージョンによって異なります。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // 環境変数が設定されていない場合は、次の行を apiKey="sk-xxx" に置き換えてください。
    // API キーはリージョンによって異なります。API キーの取得:https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void streamCall() throws ApiException, NoApiKeyException, UploadFileException {
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Collections.singletonList(
                        Collections.singletonMap("text", "ピーマンと豚肉の炒め物の3枚の画像チュートリアルをください")
                )).build();

        // テキスト画像出力にはストリーミング呼び出しが必要
        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .messages(Collections.singletonList(message))
                .stream(true) // ストリーミング出力を有効にする必要があります
                .enableInterleave(true)
                .size("1280*1280")
                .negativePrompt("")
                .maxImages(3)
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        try {
            System.out.println("---画像インターリーブのストリーム呼び出し----");
            Flowable<ImageGenerationResult> resultFlowable = imageGeneration.streamCall(param);
            resultFlowable.blockingForEach(result -> {
                System.out.println(JsonUtils.toJson(result));
            });
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
    }

    public static void main(String[] args) {
        try {
            streamCall();
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}
レスポンス例
URL は 24 時間後に有効期限が切れます。画像を速やかにダウンロードしてください。
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":0,"total_tokens":28,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"Chili"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":1,"total_tokens":29,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"stir-fry"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":2,"total_tokens":30,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"pork"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":73,"total_tokens":101,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"."}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":198,"total_tokens":226,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":199,"total_tokens":227,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"Next"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":245,"total_tokens":273,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"."}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":368,"total_tokens":396,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":369,"total_tokens":397,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"Finally"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":416,"total_tokens":444,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"pot"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":417,"total_tokens":445,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"."}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":541,"total_tokens":569,"image_count":3,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"stop","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":true},"status_code":200,"code":"","message":""}

制限事項

  • データの有効性:タスク task_id とイメージ url は、24 時間のみ保持されます。この期間を過ぎると、これらは照会またはダウンロードできなくなります。
  • コンテンツモデレーション: 入力 prompt と出力イメージの両方がコンテンツモデレーションの対象となります。準拠していないコンテンツは、IPInfringementSuspect または DataInspectionFailed エラーを返します。詳細については、「エラーコード」をご参照ください。

課金とレート制限

  • 無料クォータと料金:モデルの料金。
  • モデルのレート制限については、「通義万相 (Wan)」をご参照ください。
  • 正常に生成された画像ごとに課金されます。失敗した呼び出しは課金されず、無料クォータを消費しません。

エラーコード

モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」で解決策をご確認ください。

よくある質問

Q:モデルの推論コストと呼び出し量を確認するにはどうすればよいですか? A:「請求照会とコスト管理」をご参照ください。 Q:コード例を実行できないのはなぜですか? A:SDK を最新バージョンにアップグレードしてください。SDK のインストール。