跳转到主要内容
AIsa 的每个 API 请求都通过 Bearer token 认证，也就是你的 AIsa API Key。同一个 key 可以用于 LLM 推理、搜索、金融数据、Twitter、预测市场等接口。

​
工作方式

1

生成 API Key

在 控制台 的 API Keys 页面创建 key。每个 key 都有 sk-aisa-... 前缀，并且只展示一次，请立即复制到安全位置。
2

作为 Bearer token 发送

在每次请求的 Authorization header 中携带 key：
Authorization: Bearer ***
3

按请求计费

每次调用都会从工作区钱包中扣费。你可以在 Usage Logs 中查看实时用量和成本。

​
使用 SDK 认证

AIsa 兼容 OpenAI SDK。通常只需要替换 base_url 和 api_key： 
from openai import OpenAI

client = OpenAI(
    base_url="https://api.aisa.one/v1",
    api_key="sk-aisa-..."
)
建议通过环境变量 AISA_API_KEY 传入 key，不要把 key 写死在代码里。

​
API Key 生命周期

​
创建 key

  • 进入 console.aisa.one → API Keys。
  • 点击 Create Key，设置名称并复制 key。
  • 建议为不同环境和服务创建不同 key，例如 dev、staging、prod、ci-tests。

​
配额和限制

创建或编辑 key 时，可以设置：
  • 消费上限：限制该 key 每天、每周或每月最多可消费的金额。
  • 速率限制：为特定 key 设置更低的 RPM / TPM。
  • 模型白名单：限制该 key 只能调用指定模型。

​
轮换 key

建议至少每 90 天轮换一次 key。如果怀疑 key 泄露，应立即轮换。
1

创建新 key

使用相同用途的名称创建新 key，例如 prod-web-app-v2。
2

部署新 key

将新 key 更新到 secret manager，等待服务完成部署。
3

撤销旧 key

确认没有请求继续使用旧 key 后，在控制台撤销旧 key。

​
安全建议

不要把 API Key 提交到代码仓库、公开 issue、共享文档或截图中。AIsa key 具备消费权限，泄露后应立即撤销。
  • 每个服务使用独立 key，避免多个项目共用。
  • 为 key 设置消费上限，降低泄露后的风险。
  • 定期轮换 key，人员变动或怀疑泄露时立即轮换。
  • 通过 Usage Logs 监控异常调用。
  • 浏览器、移动端或任何用户可检查的客户端中不要直接放置 API Key，应通过后端代理转发请求。

​
相关页面

快速开始

完成第一次 AIsa API 调用。

错误码

查看 401、403 等认证相关错误。