部署映像產生微調模型API - Alibaba Cloud Model Studio

將訓練好的映像產生模型發布為線上 API 服務。

適用範圍

適用地區：當前模型部署 API 僅在新加坡地區開放。如您使用其他地區，請通過該地區的百鍊控制台完成模型部署操作。
開通帳號許可權：若使用阿里雲子帳號（RAM使用者），需要為子帳號授予模型調用、訓練和部署許可權。
配置環境變數：已成功擷取 API Key，並配置到環境變數。
前提條件：已完成模型微調訓練。請先調用查詢調優任務介面，確認任務狀態 status 為 SUCCEEDED 後再進行部署。

部署模型

新加坡

POST https://dashscope-intl.aliyuncs.com/api/v1/deployments

Windows CMD 請將$DASHSCOPE_API_KEY替換為%DASHSCOPE_API_KEY%，PowerShell請替換為 $env:DASHSCOPE_API_KEY

請求參數

要求標頭（Headers）

Content-Type string （必選）

固定值：application/json

Authorization string （必選）

API Key鑒權，格式為Bearer sk-xxxx。

請求體（Request Body）

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": "<替換為模型名稱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

阿里雲百鍊API Key所屬的業務空間ID。請參見擷取Workspace ID。

charge_type string

付費模式。post_paid表示後付費。

creator string

建立人的阿里雲帳號ID。

modifier string

修改人的阿里雲帳號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"
}

下一步

部署為非同步作業，調用本介面後可通過查詢和管理部署介面查詢部署狀態。