Skip to main content

Crear clave de API

Crear una clave de API de UAC.

Requisitos previos

Ha obtenido la AccessKey de una cuenta de Alibaba Cloud o de un usuario RAM, y a la identidad se le han otorgado los permisos RAM necesarios para invocar esta operación. Le recomendamos que configure la AccessKey como las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET en lugar de codificarla directamente.

Descripción de la solicitud

  • Método HTTP: POST
  • URL de solicitud

    Región

    Endpoint

    Singapur

    POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/api-keys

  • Autenticación Esta operación es una operación de OpenAPI de Alibaba Cloud que utiliza firmas basadas en AccessKey (el algoritmo ACS3-HMAC-SHA256). No se admite el esquema Authorization: Bearer {API_KEY}. Una solicitud debe llevar los encabezados comunes x-acs-action: CreateTokenPlanKey, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce y Authorization. Le recomendamos que invoque esta operación con un SDK de Alibaba Cloud o OpenAPI Explorer para no tener que calcular la firma usted mismo.

Parámetros de solicitud

Todos los parámetros se pasan en la cadena de consulta.

Parámetro

Tipo

Obligatorio

Descripción

AccountId

string

Sí

ID de la cuenta.

Description

string

No

Descripción de la clave.

Parámetros de respuesta

Parámetro

Tipo

Descripción

Success

boolean

Indica si la solicitud se realizó correctamente.

Code

string

Código de error (vacío si tiene éxito).

Message

string

Mensaje de error (vacío si tiene éxito).

Data

object

Datos comerciales.

ApiKeyId

string

ID de clave de API (generado por el sistema).

SourceId

string

ID de origen devuelto por BaiLian.

PlainApiKey

string

Clave de API en texto plano devuelta por BaiLian (solo se devuelve una vez durante la creación).

MaskedApiKey

string

Clave de API enmascarada devuelta por BaiLian (por ejemplo, sk_***cdef).

Description

string

Descripción de la clave.

CreatedAt

string

Hora de creación de la clave.

Ejemplo de solicitud

Esta operación utiliza firmas de OpenAPI de Alibaba Cloud. En el siguiente ejemplo, ${SIGNATURE} debe calcularse con el algoritmo ACS3-HMAC-SHA256, y x-acs-date y x-acs-signature-nonce deben reemplazarse con valores reales. 
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}"

Ejemplo de respuesta 

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

Códigos de error

Si la llamada falla, se devuelve un mensaje de error. Para obtener más códigos de error y soluciones, consulte Códigos de error.