Skip to main content
本指南会带你完成第一次 AIsa API 调用。完成后,你可以用一个统一 endpoint 访问 AIsa 的实时模型目录,并继续使用熟悉的 OpenAI 兼容 SDK。

准备工作

开始前你需要:
  1. 一个 AIsa 账号。
  2. 一个从 AIsa 控制台生成的 API Key。
  3. 基本了解 OpenAI 风格的 Chat Completions API。
新注册账号会获得免费测试额度,可在浏览器里的 Model Playground 或直接通过 REST API 使用。

第 1 步:创建账号并获取 API Key

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

第 2 步:发起第一次 API 请求

AIsa 的统一 endpoint 是:
如果你已经在使用 OpenAI SDK,通常只需要替换三个值:
  • base_url:指向 AIsa endpoint。
  • api_key:使用你的 AIsa API Key。
  • model:填写 AIsa 支持的模型 ID。

cURL 示例

返回结构与 OpenAI Chat Completions 类似,包含 choices、生成的 message 和用量统计。

第 3 步:使用官方 SDK

AIsa 兼容 OpenAI SDK,因此不需要额外安装专用客户端。

下一步

完成基础调用后,可以继续查看 身份认证模型目录API 参考