画像生成のファインチューニング済みモデルをデプロイする API - Alibaba Cloud Model Studio

トレーニング済みの画像生成モデルをオンライン 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/json

Authorization string (必須)

API キー認証。Bearer sk-xxxx の形式です。

リクエストボディ

model_name string (必須)

デプロイするモデル ID (ベースモデル名ではなく、ファインチューニングまたはエクスポート後に生成されたモデル識別子) です。取得方法：

ファインチューニング済みモデル: ファインチューニングジョブの作成レスポンスの output.finetuned_output の値を使用します。
エクスポートされたモデル：エクスポートされたモデルの詳細を照会するレスポンスの output[].model_name の値を使用します。

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 string

Alibaba 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"
    }
}

エラーレスポンスの例

{
    "code": "InvalidParameter",
    "request_id": "BE213CDD-8A5C-59EE-9A67-055EAB0CB59B",
    "message": "The model xxx does not exist or is not deployable"
}

次のステップ

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