准备工作
开始前你需要:- 一个 AIsa 账号。
- 一个从 AIsa 控制台生成的 API Key。
- 基本了解 OpenAI 风格的 Chat Completions API。
第 1 步:创建账号并获取 API Key
- 打开 AIsa 控制台 并注册账号。你可以使用邮箱注册(需先验证邮箱再设置密码),也可以通过 Google 或 GitHub 登录。注册完成后会直接进入控制台。
- 注册完成后进入 API Keys 页面。系统会为你生成一个可用的 key。请立即复制并安全保存,它会用于后续所有 API 请求和用量计费。
- 如果需要为不同项目、环境或成员创建独立 key,可以随时回到 API Keys 页面新增。新建或编辑 key 时,可以为它设置 quota(该 key 的消费上限),也可以开启不限额度取消这个上限。
注意:key 的 quota 是这个 key 自身的消费上限,不等于账号总余额。实际可用额度取决于 key quota 和钱包余额中较低的一项。共享 key 给不同项目或成员时,这可以避免单个 key 花光全部余额。推荐的做法是「一个服务或环境一个 key」,例如开发环境用小额度 key、生产环境用大额度 key,这样吊销或轮换任何一个 key 都不会影响其他集成。完整的 key 管理建议见 身份认证。 API Key 会用于认证所有请求,并直接关联你的用量计费,因此务必妥善保管:不要写进客户端代码,不要提交到公开仓库,也不要放在未加保护的环境变量里。
第 2 步:发起第一次 API 请求
AIsa 的统一 endpoint 是:base_url:指向 AIsa endpoint。api_key:使用你的 AIsa API Key。model:填写 AIsa 支持的模型 ID。
cURL 示例
choices、生成的 message 和用量统计。