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

適用範圍

適用地區：當前模型部署 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/jsonAuthorization 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"
    }
}

下一步

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

​適用範圍

​部署模型