Membuat Kunci API - Alibaba Cloud Model Studio

Prasyarat

Anda telah memperoleh AccessKey dari akun Alibaba Cloud atau pengguna RAM, dan identitas tersebut telah diberikan izin RAM yang diperlukan untuk memanggil operasi ini. Kami menyarankan Anda menetapkan AccessKey sebagai variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET alih-alih meng-hardcode-nya.

Deskripsi permintaan

Metode HTTP: POST
URL Permintaan
Wilayah
Endpoint
Singapura
POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/api-keys
Autentikasi Operasi ini adalah operasi Alibaba Cloud OpenAPI yang menggunakan tanda tangan berbasis AccessKey (algoritma ACS3-HMAC-SHA256). Skema Authorization: Bearer {API_KEY} tidak didukung. Permintaan harus menyertakan header umum x-acs-action: CreateTokenPlanKey, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce, dan Authorization. Kami menyarankan Anda memanggil operasi ini dengan Alibaba Cloud SDK atau OpenAPI Explorer sehingga Anda tidak perlu menghitung tanda tangan sendiri.

Wilayah	Endpoint
Singapura	`POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/api-keys`

Parameter permintaan

Semua parameter diteruskan dalam query string.

Parameter	Tipe	Wajib	Deskripsi
AccountId	string	Ya	ID Akun.
Description	string	Tidak	Deskripsi kunci.

Parameter respons

Parameter	Tipe	Deskripsi
Success	boolean	Apakah permintaan berhasil.
Code	string	Kode kesalahan (kosong jika berhasil).
Message	string	Pesan kesalahan (kosong jika berhasil).
Data	object	Data bisnis.
ApiKeyId	string	ID kunci API (dihasilkan sistem).
SourceId	string	ID Sumber yang dikembalikan oleh BaiLian.
PlainApiKey	string	Kunci API teks biasa yang dikembalikan oleh BaiLian (hanya dikembalikan sekali selama pembuatan).
MaskedApiKey	string	Kunci API yang disamarkan yang dikembalikan oleh BaiLian (misalnya, sk_***cdef).
Description	string	Deskripsi kunci.
CreatedAt	string	Waktu pembuatan kunci.

Contoh permintaan

Operasi ini menggunakan tanda tangan Alibaba Cloud OpenAPI. Dalam contoh berikut, ${SIGNATURE} harus dihitung dengan algoritma ACS3-HMAC-SHA256, dan x-acs-date serta x-acs-signature-nonce harus diganti dengan nilai aktual.

curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/api-keys?AccountId=acc_123456789&Description=API%20key%20description" \
    --header "x-acs-action: CreateTokenPlanKey" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

Contoh respons

{
  "Success": true,
  "Data": {
    "ApiKeyId": "ak-123456",
    "SourceId": "123",
    "PlainApiKey": "sk-ws.abc123456",
    "MaskedApiKey": "sk_***6",
    "Description": "APIKEY描述",
    "CreatedAt": "2025-07-18T03:19:17Z"
  }
}

Kode kesalahan

Jika pemanggilan gagal, pesan kesalahan akan dikembalikan. Untuk kode kesalahan dan solusi selengkapnya, lihat Kode kesalahan.

​Prasyarat

​Deskripsi permintaan

​Parameter permintaan

​Parameter respons

​Contoh permintaan

​Contoh respons