当应用需要在浏览器、移动 App 等不可信环境中调用模型服务时,为避免永久 API Key 泄露,应通过安全的后端服务来提供临时 API Key。
重要
临时 API Key 将继承生成它的 API Key 所拥有的权限。(例如:限制访问特定模型、知识库)
请求示例
需要先获取并配置 API Key 到环境变量。临时 API Key 默认有效期为60秒,支持设置超时时间范围为[1, 1800] 秒。
curl -X POST "https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"
响应示例
正常响应示例
{
"token":"st-****",
"expires_at":1744080369
}
响应参数
参数名称 | 参数类型 | 说明 | 示例 |
token | String | 生成的临时 API Key。 | st-**** |
expires_at | Number | 过期时间,时间戳(Unix Timestamp),单位为秒。 | 1744080369 |
错误响应示例
{
"code":"InvalidApiKey",
"message":"Invalid API-key provided.",
"request_id":"902fee3b-f7f0-9a8c-96a1-6b4ea25af114"
}
响应参数
参数名称 | 参数类型 | 说明 | 示例 |
code | String | 错误码。 请前往错误信息页面查询更多的原因和解决方法。 | InvalidApiKey:无效API-Key错误码 |
message | String | 错误消息。 | Invalid API-key provided. |
request_id | String | 请求ID。 | 902fee3b-f7f0-9a8c-96a1-6b4ea25af114 |
常见问题
问:我能手动删除一个已经创建的临时 API Key 吗?
答:不能。临时 API Key 有固定的生命周期,到期后会自动失效。
该文章对您有帮助吗?