API 基础
认证与 API Key
所有需要鉴权的接口请求都应由可信的服务端发起，并在 Authorization 请求头中携带控制台创建的 API Key。
1
章节 1
创建密钥
注册或登录控制台后，进入“API 令牌”页面，点击“添加令牌”创建 API Key。请根据实际用途管理密钥；密钥权限与可用额度以控制台显示为准。
- 不要把密钥放进网页源码或公开仓库
- 泄露后立即在控制台停用并重新创建
- 不同项目尽量使用不同密钥，便于排查用量
2
章节 2
添加认证请求头
使用 Bearer 方式传递密钥。以下示例中的占位符需要替换为你自己的 API Key。
HTTP
Authorization: Bearer YOUR_AINN_API_KEY
Content-Type: application/json
3
章节 3
确认接口地址
OpenAI 兼容接口的 Base URL 为 https://api.ainn.cc/v1。使用 SDK 时填写 Base URL，直接发送 HTTP 请求时还需拼接具体接口路径。
客户端是否自动添加 /v1 因软件而异；遇到 404 时先检查地址是否变成 /v1/v1。