用户与平台接口
接口鉴权说明 (Auth)
疾旋Token 开放平台接口认证与鉴权方式
概述
疾旋Token 开放平台接口分为 AI 模型推理接口 与 用户与平台管理接口:
- AI 模型推理接口 (
/v1/*):用于大语言模型、语音、图像与向量等能力调用,使用在「令牌管理」中创建的 API Key 进行鉴权。 - 用户与平台接口 (
/api/*):用于个人账号管理、充值记录、令牌维护与使用日志查询,支持 Access Token 或登录 Session。
认证方式
1. API 令牌认证(推荐)
在 HTTP 请求头中添加 Authorization 字段:
Authorization: Bearer sk-your-astrumflow-token-key2. 账号访问令牌 (Access Token)
针对个人设置、安全选项等需要确认用户身份的接口,可以在控制台「个人设置 - 安全设置」中生成个人 Access Token,并在请求头中携带:
Authorization: Bearer {your_access_token}
New-Api-User: {your_user_id}错误状态码
| HTTP 状态码 | 含义 | 说明 |
|---|---|---|
401 Unauthorized | 鉴权失败 | 缺少令牌、令牌无效或已过期 |
403 Forbidden | 权限不足 | 令牌无权访问指定模型或分组 |
429 Too Many Requests | 频次超限 / 额度耗尽 | 触发速率限制或账户余额不足 |