Perbarui izin 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/permissions
Otentikasi Tetapkan Authorization: Bearer {API_KEY} di header permintaan.

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

Parameter permintaan

Semua parameter diteruskan melalui badan permintaan.

Parameter	Type	Wajib	Deskripsi
models	Array[Object]	Wajib bersyarat	Daftar item otorisasi per model. Dapat kosong ketika `access_all_entities` bernilai `OPEN`/`CLOSE`; wajib diisi ketika nilainya `KEEP` atau tidak ditentukan, dalam hal ini jumlah item harus antara 1 hingga 20. Contoh: `[{"model":"qwen-plus","inference":true}]`
models[].model	String	Ya	ID model. Tidak boleh kosong. Contoh: `qwen-plus`, `qwen3-max`.
models[].inference	Boolean	Tidak	Izin pemanggilan model. `true` = berikan izin inferensi, `false` = cabut, tidak ditentukan = tetap tidak berubah. Nilai default: null (tidak ada perubahan).
models[].finetune	Boolean	Tidak	Izin pelatihan model. `true` = berikan izin fine-tuning, `false` = cabut, tidak ditentukan = tetap tidak berubah. Nilai default: null (tidak ada perubahan).
models[].deploy	Boolean	Tidak	Izin penerapan model. `true` = berikan izin penerapan, `false` = cabut, tidak ditentukan = tetap tidak berubah. Nilai default: null (tidak ada perubahan).
access_all_entities	String	Tidak	Sakelar otorisasi-semua. Nilai yang valid: `OPEN`: Otorisasi semua model inferensi di ruang kerja saat ini dengan satu klik (termasuk model yang ditambahkan nanti). `CLOSE`: Batalkan otorisasi-semua dan hapus otorisasi inferensi historis. `KEEP`: Pertahankan perilaku otorisasi per model asli (default). Ketika nilai `OPEN`/`CLOSE` diberikan, parameter `models` dapat diabaikan. Nilai default: `KEEP`. Contoh: `OPEN`

Parameter respons

Parameter	Type	Deskripsi
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 panggilan berhasil. Contoh: `true`
output	Object	Data bisnis. `null` untuk titik akhir ini.

Contoh permintaan

Contoh 1: Otorisasi per model

curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/permissions" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{
        "models": [
            {"model": "qwen-plus", "inference": true, "fine_tune": true, "deploy": false},
            {"model": "qwen3-max", "inference": true}
        ]
    }'

Contoh 2: Izinkan semua

curl -X POST "https://dashscope.aliyuncs.com/api/v1/models/permissions" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{"access_all_entities": "OPEN"}'

Contoh respons

Contoh keberhasilan

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

Contoh kegagalan

{
    "code": "InvalidParameter",
    "message": "Model qwen-xxx is not authorized for Inference",
    "success": false,
    "output": null,
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

Kode kesalahan

Jika panggilan gagal, pesan kesalahan akan dikembalikan. Untuk informasi lebih lanjut mengenai kode kesalahan dan solusinya, lihat Pesan kesalahan.

​Prasyarat

​Permintaan

​Parameter permintaan

​Parameter respons

​Contoh permintaan

​Contoh respons