部署语音合成微调模型API-大模型服务平台百炼(Model Studio)-阿里云帮助中心

将训练好的语音合成模型发布为在线 API 服务。

适用范围

适用地域：本文描述的功能仅在华北2（北京）地域可用，且必须使用该地域的API Key。
开通账号权限：若使用阿里云子账号（RAM用户），需要为子账号授予模型调用、训练和部署权限。
配置环境变量：已成功获取 API Key，并配置到环境变量。
前提条件：已完成模型微调训练。请先调用查询调优任务接口，确认任务状态 status 为 SUCCEEDED 后再进行部署。

部署模型

华北2（北京）

POST https://dashscope.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 的值。

plan string （必选）

部署方式。CosyVoice 系列调优模型仅支持mu（模型单元部署）。

deploy_spec string （必选）

部署模板规格。可通过查询可部署模型接口返回的 template_id 字段获取。CosyVoice 当前支持：

MU5：单机部署，capacity 须为 1 的整数倍。
MU2：单机部署-旗舰级复杂推理版，capacity 须为 8 的整数倍。

capacity integer （必选）

部署使用的资源单元数量，需为 base_capacity 的整数倍。取值约束取决于 deploy_spec，详见上方说明。

billing_method string （必选）

计费方式。当前支持 POST_PAY（后付费）。

name string （可选）

模型的控制台显示名称。不传则自动使用 model_name 的值。

部署模型

curl --location 'https://dashscope.aliyuncs.com/api/v1/deployments' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "<替换为模型名称model_name>",
    "plan": "mu",
    "deploy_spec": "MU5",
    "capacity": 1,
    "billing_method": "POST_PAY"
}'

响应参数

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": "cosyvoice-v3-flash-ft-202507011122-xxxx",
        "gmt_create": "2025-07-01T10:30:00.000",
        "gmt_modified": "2025-07-01T10:30:00.000",
        "status": "PENDING",
        "model_name": "cosyvoice-v3-flash-ft-202507011122-xxxx",
        "base_model": "cosyvoice-v3-flash",
        "workspace_id": "llm-xxxxxxxxx",
        "charge_type": "post_paid",
        "creator": "12xxxxxxx",
        "modifier": "12xxxxxxx",
        "plan": "mu"
    }
}

错误响应示例

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

下一步

部署为异步操作，调用本接口后可通过查询和管理部署接口查询部署状态。