Daftar 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: GET
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 query string.

Parameter	Type	Wajib	Deskripsi
name	String	Tidak	Pencarian kabur berdasarkan nama model. Melakukan pencocokan kabur terhadap `name` dan `model_id`. Contoh: `qwen`
model	String	Tidak	Pencocokan eksak berdasarkan ID model. Melakukan pencocokan eksak terhadap `model_id`. Contoh: `qwen-plus`
page_no	Integer	Tidak	Nomor halaman, bilangan bulat positif yang dimulai dari 1. Nilai default: `1`.
page_size	Integer	Tidak	Jumlah entri per halaman, berkisar antara 1 hingga 200 (maksimum 200). Nilai default: `20`.
authorization_scope	String	Tidak	Filter cakupan otorisasi. Nilai yang valid: `AUTHORIZABLE`: Model yang dapat diotorisasi (default). `AUTHORIZED`: Model yang telah diotorisasi. Nilai default: `AUTHORIZABLE`. Contoh: `AUTHORIZED`
action	String	Tidak	Dimensi aksi izin. Nilai yang valid: `INFERENCE` - inferensi (saat ini satu-satunya nilai yang didukung). Hanya berlaku sebagai dimensi filter ketika `authorization_scope=AUTHORIZED`. Nilai default: `INFERENCE`.

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.total	Number	Jumlah total. Contoh: `5`
output.page_no	Number	Nomor halaman. Contoh: `1`
output.page_size	Number	Jumlah entri per halaman. Contoh: `20`
output.permissions	Array[Object]	Daftar izin. Lihat contoh respons.
output.model	String	ID model. Contoh: `qwen-plus`
output.name	String	Nama tampilan model. Contoh: `通义千问-Plus`
output.permissions[].permissions	Object	Detail izin. Contoh: `{"inference":true,"fine_tune":false,"deploy":false}`. Berisi bidang-bidang berikut: `inference` (Boolean): Apakah model memiliki izin pemanggilan model. Contoh: `true` `finetune` (Boolean): Apakah model memiliki izin pelatihan model. Contoh: `false` `deploy` (Boolean): Apakah model memiliki izin penerapan model. Contoh: `false`

Contoh permintaan

curl "https://dashscope.aliyuncs.com/api/v1/models/permissions?authorization_scope=AUTHORIZED&action=INFERENCE&page_no=1&page_size=20" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json'

Contoh respons

{
    "code": null,
    "message": null,
    "success": true,
    "output": {
        "total": 3,
        "page_no": 1,
        "page_size": 20,
        "permissions": [
            {
                "model": "qwen-plus",
                "name": "通义千问-Plus",
                "permissions": {
                    "inference": true,
                    "fine_tune": false,
                    "deploy": false
                }
            },
            {
                "model": "qwen3-max",
                "name": "通义千问3-Max",
                "permissions": {
                    "inference": true,
                    "fine_tune": true,
                    "deploy": false
                }
            },
            {
                "model": "qwen-turbo",
                "name": "通义千问-Turbo",
                "permissions": {
                    "inference": true,
                    "fine_tune": false,
                    "deploy": false
                }
            }
        ]
    },
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

Kode kesalahan

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

​Prasyarat

​Permintaan

​Parameter permintaan

​Parameter respons

​Contoh permintaan

​Contoh respons