Alibaba Cloud Model Studio:Créer une clé API

Créer une clé API UAC.

Prérequis

Vous avez obtenu l'AccessKey d'un compte Alibaba Cloud ou d'un utilisateur RAM, et l'identité s'est vu accorder les autorisations RAM nécessaires pour appeler cette opération. Nous vous recommandons de définir l'AccessKey comme variables d'environnement ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET plutôt que de le coder en dur.

Description de la requête

• Méthode HTTP : POST

• URL de la requête

  Région	Point de terminaison
  Singapour	POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/api-keys

• Authentification

  Cette opération est une opération OpenAPI Alibaba Cloud qui utilise des signatures basées sur AccessKey (l'algorithme ACS3-HMAC-SHA256). Le schéma Authorization: Bearer {API_KEY} n'est pas pris en charge. Une requête doit comporter les en-têtes communs x-acs-action: CreateTokenPlanKey, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce et Authorization.

  Nous vous recommandons d'appeler cette opération avec un SDK Alibaba Cloud ou OpenAPI Explorer afin de ne pas avoir à calculer la signature vous-même.

Paramètres de la requête

Tous les paramètres sont transmis dans la chaîne de requête.

Paramètre	Type	Obligatoire	Description
AccountId	string	Oui	ID du compte.
Description	string	Non	Description de la clé.

Paramètres de réponse

Paramètre	Type	Description
Success	boolean	Indique si la requête a réussi.
Code	string	Code d'erreur (vide en cas de succès).
Message	string	Message d'erreur (vide en cas de succès).
Data	object	Données métier.
ApiKeyId	string	ID de clé API (généré par le système).
SourceId	string	ID source retourné par BaiLian.
PlainApiKey	string	Clé API en texte brut retournée par BaiLian (retournée une seule fois lors de la création).
MaskedApiKey	string	Clé API masquée retournée par BaiLian (par exemple, sk_***cdef).
Description	string	Description de la clé.
CreatedAt	string	Heure de création de la clé.

Exemple de requête

Cette opération utilise les signatures OpenAPI d'Alibaba Cloud. Dans l'exemple suivant, ${SIGNATURE} doit être calculé avec l'algorithme ACS3-HMAC-SHA256, et x-acs-date ainsi que x-acs-signature-nonce doivent être remplacés par des valeurs réelles.

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: ${SIGNATURE_NONCE}" \
    --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}"

Exemple de réponse

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

Codes d'erreur

Si l'appel échoue, un message d'erreur est renvoyé. Pour plus de codes d'erreur et de solutions, consultez Codes d'erreur.