Skip to main content

画像生成 - モデルのデプロイ

トレーニング済みの画像生成モデルをオンライン API サービスとして公開します。

前提条件

  • サポート対象リージョン：現在、モデルデプロイ API は Singapore リージョンでのみ利用可能 です。他のリージョンをご利用の場合は、そのリージョンの Model Studio コンソールからモデルをデプロイしてください。
  • アカウント権限： Alibaba Cloud サブアカウント (RAM ユーザー) を使用する場合、サブアカウントにモデルの呼び出し、トレーニング、デプロイの 権限 を付与する必要があります。
  • 環境変数の設定： API キーを正常に取得し、 環境変数として設定しておく必要があります。
  • 前提条件：モデルのファインチューニングが完了している必要があります。デプロイを進める前に、まず ファインチューニングジョブの照会 API を呼び出し、ジョブのステータス status が SUCCEEDED であることを確認してください。

モデルのデプロイ

  • Singapore
POST https://dashscope-intl.aliyuncs.com/api/v1/deployments
Windows CMD の場合は、 $DASHSCOPE_API_KEY を %DASHSCOPE_API_KEY% に置き換えてください。PowerShell の場合は、 $env:DASHSCOPE_API_KEY に置き換えてください。

リクエストパラメーター

ヘッダー
Content-Type string (必須)固定値： application/jsonAuthorization string (必須)API キー認証。Bearer sk-xxxx の形式です。
リクエストボディ
model_name string (必須)デプロイするモデル ID (ベースモデル名ではなく、ファインチューニングまたはエクスポート後に生成されたモデル識別子) です。取得方法：capacity integer (必須)デプロイするモデルインスタンスの数。推奨値：1。plan string (必須)デプロイ方法。LoRA 効率的ファインチューニングの推奨値: lora。
  • モデルのデプロイ
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/deployments' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "<replace with model_name>",
    "capacity": 1,
    "plan": "lora"
}'

レスポンスパラメーター

request_id stringリクエストの一意の識別子です。output objectタスクの詳細です。

プロパティ

deployed_model stringデプロイされたモデルの一意の識別子。モデルのデプロイステータスの照会やモデルの呼び出しに使用します。model_name stringリクエストで指定された、デプロイ対象のモデル識別子です。status stringデプロイステータス：
  • PENDING：デプロイ中。
  • RUNNING：実行中。
  • FAILED：デプロイ失敗。
base_model string使用されたベースモデルです。gmt_create stringデプロイタスクの作成時刻です。gmt_modified stringデプロイタスクの更新時刻です。workspace_id stringAlibaba Cloud Model Studio API キーに関連付けられたワークスペース ID です。 ワークスペース ID の取得をご参照ください。charge_type string課金モード。post_paid は従量課金を示します。creator string作成者の Alibaba Cloud アカウント ID です。modifier string変更者の Alibaba Cloud アカウント ID です。plan stringデプロイ方法です。
code stringエラーコード。呼び出しが失敗した場合に返されます。message string詳細なエラー内容。呼び出しが失敗した場合に返されます。
  • 成功レスポンスの例
  • エラーレスポンスの例
キーフィールド： output.deployed_model (デプロイされたモデルの一意の識別子)、 output.status (デプロイステータス)。
{
    "request_id": "96020b2e-9072-4c8a-9981-xxxxxxxxx",
    "output": {
        "deployed_model": "wan2.7-image-pro-ft-202507011122-xxxx",
        "gmt_create": "2025-07-01T10:30:00.000",
        "gmt_modified": "2025-07-01T10:30:00.000",
        "status": "PENDING",
        "model_name": "wan2.7-image-pro-ft-202507011122-xxxx",
        "base_model": "wan2.7-image-pro",
        "workspace_id": "llm-xxxxxxxxx",
        "charge_type": "post_paid",
        "creator": "12xxxxxxx",
        "modifier": "12xxxxxxx",
        "plan": "lora"
    }
}

次のステップ

デプロイは非同期操作です。この API を呼び出した後、 デプロイの照会と管理 API を通じてデプロイステータスを照会できます。