Skip to main content

Generar una clave de API temporal

Para llamar a servicios de modelo desde entornos no confiables, como navegadores y aplicaciones móviles, utilice un servicio backend seguro para generar claves de API temporales. Esto evita que su clave de API permanente quede expuesta.

Una clave de API temporal hereda todos los permisos de la clave de API utilizada para crearla, incluidas las restricciones de acceso para modelos o bases de conocimiento específicos.

Requisitos previos

Obtenga una clave de API permanente en la página Gestión de claves (Singapore), Gestión de claves (Virginia), Gestión de claves (Pekín) o Gestión de claves (China (Hong Kong)). Luego, configure la clave como la variable de entorno DASHSCOPE_API_KEY. Para obtener más información, consulte Configurar una clave de API como variable de entorno.

Ejemplo de solicitud

De forma predeterminada, una clave de API temporal es válida durante 60 segundos. Establezca un tiempo de vida (TTL) personalizado entre 1 y 1,800 segundos mediante el parámetro expire_in_seconds.
Las claves de API varían según la región.
El siguiente ejemplo utiliza el endpoint de la región de Singapur. Reemplace WorkspaceId con su ID de espacio de trabajo real. Para la región de Pekín, reemplace la URL con: https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800 
# This is the Singapore region URL. Replace WorkspaceId with your actual workspace ID. URLs differ by region.
curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"

Ejemplo de respuesta

  • Ejemplo de respuesta exitosa
  • Ejemplo de respuesta de error
{
    "token":"st-****",
    "expires_at":1744080369
}

Parámetros de respuesta

Parámetro

Tipo

Descripción

Ejemplo

token

String

Clave de API temporal generada.

st-****

expires_at

Número

Hora de caducidad como marca de tiempo UNIX, en segundos.

1744080369

FAQ

P: ¿Puedo eliminar manualmente una clave de API temporal? R: No. Las claves de API temporales tienen un ciclo de vida fijo y caducan automáticamente. No puede eliminarlas antes de que caduquen.