Skip to main content

Actualizar límites de tasa de modelos

Llama al endpoint POST /api/v1/models/limits para actualizar las cuotas de límite de tasa (QPM/TPM) de los modelos en un espacio de trabajo específico. Se admiten operaciones de fusión superpuesta y eliminación de límites de tasa.

Requisitos previos

Se ha creado una clave API y se ha configurado como la variable de entorno DASHSCOPE_API_KEY. Para obtener más información, consulte Configurar una clave API en variables de entorno.

Solicitud

  • Método HTTP: POST
  • URL de solicitud Reemplace {WorkspaceId} con su ID de espacio de trabajo.
    RegiónEndpoint
    China (Beijing)https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/limits
  • Autenticación Establezca Authorization: Bearer {API_KEY} en el encabezado de la solicitud.

Parámetros de solicitud

Todos los parámetros se pasan a través del cuerpo de la solicitud.

Parámetro

Tipo

Obligatorio

Descripción

models

Array[Object]

Sí

Lista de elementos de límite de tasa por modelo. El número de elementos debe ser de 1 a 200. Ejemplo: [{"model":"qwen-plus","request_limit":60}]

models[].model

String

Sí

El ID del modelo. No puede estar vacío. Ejemplos: qwen-plus, qwen3.7-plus.

models[].operation_type

String

No

Tipo de operación. Valores válidos:

  • OVERLAY: Fusión superpuesta. Solo se sobrescriben los campos pasados; los campos no pasados se rellenan con sus valores actuales.

  • DELETE: Eliminar el límite de tasa. Todos los campos de valor de límite de tasa deben estar vacíos.

Valor predeterminado: OVERLAY.

models[].request_limit

Número

No

Límite de recuento de solicitudes (QPM), no negativo. Número máximo de solicitudes por minuto, en solicitudes/minuto. Debe estar vacío cuando operation_type=DELETE. Valor predeterminado: null (sin cambios). Ejemplo: 60.

models[].request_limit_period

Número

No

Periodo de tiempo para el límite de tasa de solicitudes, un entero positivo en segundos. Por ejemplo, 60 = 1 minuto. Valor predeterminado: null (sin cambios).

models[].usage_limit

Número

No

Límite de uso (TPM), no negativo. Uso máximo de tokens por minuto. Debe estar vacío cuando operation_type=DELETE. Valor predeterminado: null (sin cambios). Ejemplo: 100000.

models[].usage_limit_period

Número

No

Periodo de tiempo para el límite de uso, un entero positivo en segundos. Por ejemplo, 60 = 1 minuto. Valor predeterminado: null (sin cambios).

Parámetros de respuesta

Parámetro

Tipo

Descripción

request_id

String

El ID de la solicitud. Ejemplo: d5f5201f-ee7a-9e3d-8569-bc0eedec21f9.

code

String

Código de error. null en caso de éxito.

message

String

Mensaje de error. null en caso de éxito.

success

Boolean

Indica si la llamada fue exitosa. Ejemplo: true.

output

Object

Datos comerciales. null para este endpoint.

Escenario de exención de TPM

Para limitar solo RPM y eximir TPM, primero llame a este endpoint con {"model":"X","operation_type":"DELETE"} para eliminar todos los límites de tasa del modelo objetivo. Luego pase {"model":"X","operation_type":"OVERLAY","request_limit":60,"request_limit_period":60} para establecer solo el QPM. Los dos pasos no son atómicos, por lo que hay una breve ventana sin ningún límite entre ellos.

Ejemplos de solicitudes

Ejemplo 1: Establecer QPM=60 y 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
            }
        ]
    }'
Ejemplo 2: Eliminar límites de tasa 
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"}
        ]
    }'

Respuesta de ejemplo

Ejemplo de éxito 
{
    "code": null,
    "message": null,
    "success": true,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}
Ejemplo de fallo 
{
    "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"
}

Códigos de error

Si la llamada falla, se devuelve un mensaje de error. Para obtener más información sobre códigos de error y soluciones, consulte Mensajes de error.