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.
ImportanteUna 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 API Key (Singapore), API Key (Virginia), API Key (Beijing) o API Key (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
WorkspaceIdcon 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
{
"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 |
Ejemplo de respuesta de error
{
"code":"InvalidApiKey",
"message":"Invalid API-key provided.",
"request_id":"902fee3b-f7f0-9a8c-96a1-6b4ea25af114"
}
Parámetros de respuesta
Parámetro | Tipo | Descripción | Ejemplo |
|---|---|---|---|
code | String | Código de error. Para conocer las causas y soluciones, consulte Códigos de error. | InvalidApiKey: La clave de API no es válida. |
message | String | Mensaje de error. | Se proporcionó una clave de API no válida. |
request_id | String | ID de solicitud. | 902fee3b-f7f0-9a8c-96a1-6b4ea25af114 |
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.