Perbarui batas laju model - Alibaba Cloud Model Studio

Prasyarat

Kunci API telah dibuat dan dikonfigurasi sebagai variabel lingkungan DASHSCOPE_API_KEY. Untuk informasi selengkapnya, lihat Konfigurasikan kunci API dalam variabel lingkungan.

Permintaan

Metode HTTP: POST
URL Permintaan
Ganti {WorkspaceId} dengan ID ruang kerja Anda.

Region
Endpoint
China (Beijing)
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/limits
Otentikasi Tetapkan Authorization: Bearer {API_KEY} di header permintaan.

Region	Endpoint
China (Beijing)	`https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models/limits`

Parameter permintaan

Semua parameter dikirim melalui badan permintaan.

Parameter	Type	Required	Description
models	Array[Object]	Yes	Daftar item batas laju per model. Wajib diisi. Jumlah item harus antara 1 hingga 200. Contoh: `[{"model":"qwen-plus","request_limit":60}]`
models[].model	String	Yes	ID model. Tidak boleh kosong. Contoh: `qwen-plus`, `qwen3-max`.
models[].operation_type	String	No	Jenis operasi. Nilai yang valid: `OVERLAY`: Merge overlay (hanya mengganti bidang yang dikirim; bidang yang tidak dikirim akan diisi kembali dengan nilai saat ini). `DELETE`: Hapus batas laju (dalam kasus ini, semua bidang nilai batas laju harus kosong). Nilai default: `OVERLAY`.
models[].request_limit	Number	No	Batas jumlah permintaan (QPM), bernilai non-negatif. Jumlah maksimum permintaan per menit, dalam satuan permintaan/menit. Harus kosong ketika `operation_type=DELETE`. Nilai default: null (tidak berubah). Contoh: `60`
models[].request_limit_period	Number	No	Periode waktu untuk batas laju permintaan, berupa bilangan bulat positif dalam detik. Misalnya, `60` = 1 menit. Nilai default: null (tidak berubah).
models[].usage_limit	Number	No	Batas penggunaan (TPM), bernilai non-negatif. Penggunaan token maksimum per menit. Harus kosong ketika `operation_type=DELETE`. Nilai default: null (tidak berubah). Contoh: `100000`
models[].usage_limit_period	Number	No	Periode waktu untuk batas penggunaan, berupa bilangan bulat positif dalam detik. Misalnya, `60` = 1 menit. Nilai default: null (tidak berubah).

Parameter respons

Parameter	Type	Description
request_id	String	ID permintaan. Contoh: `d5f5201f-ee7a-9e3d-8569-bc0eedec21f9`
code	String	Kode kesalahan. `null` jika berhasil.
message	String	Pesan kesalahan. `null` jika berhasil.
success	Boolean	Apakah pemanggilan berhasil. Contoh: `true`
output	Object	Data bisnis. `null` untuk endpoint ini.

Skenario pengecualian TPM

Untuk membatasi hanya RPM dan mengecualikan TPM, gunakan pendekatan dua langkah berikut: pertama, panggil endpoint ini dengan {"model":"X","operation_type":"DELETE"} untuk menghapus semua batas laju model target; kemudian, kirim {"model":"X","operation_type":"OVERLAY","request_limit":60,"request_limit_period":60} untuk mengatur hanya QPM. Kedua langkah ini tidak bersifat atomik, sehingga terdapat jendela singkat tanpa batas di antaranya.

Contoh permintaan

Contoh 1: Atur QPM=60 dan 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
            }
        ]
    }'

Contoh 2: Hapus batas laju

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"}
        ]
    }'

Contoh respons

Contoh sukses

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

Contoh Kegagalan

{
    "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"
}

Kode kesalahan

Jika pemanggilan gagal, pesan kesalahan akan dikembalikan. Untuk informasi selengkapnya tentang kode kesalahan dan solusi, lihat Pesan kesalahan.

​Prasyarat

​Permintaan

​Parameter permintaan

​Parameter respons

​Skenario pengecualian TPM

​Contoh permintaan

​Contoh respons

​Kode kesalahan