更新模型限流 - 阿里云百炼

前提条件

已创建 API Key 并配置为环境变量 DASHSCOPE_API_KEY。配置方法请参见配置API Key到环境变量。

请求说明

HTTP 方法：POST
请求地址
调用时请将 {WorkspaceId} 替换为您的业务空间 ID。

地域
Endpoint
华北2（北京）
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/limits
认证方式 在请求 Header 中设置 Authorization: Bearer {API_KEY}。

地域	Endpoint
华北2（北京）	`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/limits`

请求参数

所有参数均通过请求 Body 传递。

参数	类型	必选	描述
models	Array[Object]	是	逐模型限流项列表。必填，数量需为 1~200。示例：`[{"model":"qwen-plus","request_limit":60}]`
models[].model	String	是	模型 ID，不能为空。如 `qwen-plus`、`qwen3-max`。
models[].operation_type	String	否	操作类型。可选值： `OVERLAY`：合并覆盖（只覆盖传入字段，未传字段回填当前值）。 `DELETE`：删除限流（此时限流值字段需全部为空）。默认值：`OVERLAY`。
models[].request_limit	Number	否	请求次数上限（QPM），非负。每分钟最大请求数，单位次/分钟。`operation_type=DELETE` 时必须为空。默认值：null（不变更）。示例：`60`
models[].request_limit_period	Number	否	请求限流时间周期，正整数，单位秒，如 `60`=1 分钟。默认值：null（不变更）。
models[].usage_limit	Number	否	用量上限（TPM），非负。每分钟最大 Token 用量。`operation_type=DELETE` 时必须为空。默认值：null（不变更）。示例：`100000`
models[].usage_limit_period	Number	否	用量限流时间周期，正整数，单位秒，如 `60`=1 分钟。默认值：null（不变更）。

返回参数

参数	类型	描述
request_id	String	请求 ID。示例：`d5f5201f-ee7a-9e3d-8569-bc0eedec21f9`
code	String	错误码，成功为 `null`。
message	String	错误信息，成功为 `null`。
success	Boolean	是否成功。示例：`true`
output	Object	业务数据，本接口为 `null`。

TPM 豁免场景

若需"只限制 RPM、豁免 TPM"，推荐两步法——先调用本接口对目标模型传 {"model":"X","operation_type":"DELETE"} 删除全部限流，再传 {"model":"X","operation_type":"OVERLAY","request_limit":60,"request_limit_period":60} 只设置 QPM。两步非原子，中间有短暂无限制窗口。

请求示例

示例一：设置 QPM=60、TPM=100000

curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/limits" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{
        "models": [
            {
                "model": "qwen-plus",
                "operation_type": "OVERLAY",
                "request_limit": 60,
                "request_limit_period": 60,
                "usage_limit": 100000,
                "usage_limit_period": 60
            }
        ]
    }'

示例二：删除限流

curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/limits" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{
        "models": [
            {"model": "qwen-plus", "operation_type": "DELETE"}
        ]
    }'

返回示例

成功示例

{
    "code": null,
    "message": null,
    "success": true,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

失败示例

{
    "code": "InvalidParameter",
    "message": "Cannot set TPM without QPM for model qwen-plus: no existing QPM limit, please set QPM first",
    "success": false,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

错误码

如果调用失败，会返回错误信息。更多错误码及解决方法，请参见错误信息。

​前提条件

​请求说明

​请求参数

​返回参数

​TPM 豁免场景

​请求示例

​返回示例

​错误码