创建 API Key
在开始集成 AI 服务之前，您需要先在控制台创建一个 API Key。该密钥将作为您调用接口时的身份验证凭证。
1. 进入控制台
- 访问链接：https://app.aiproxy.shop
- 登录方式：使用手机号码登录。输入手机号并发送验证码，完成验证后即可登录。
- 说明：未注册的手机号将自动注册。登录即代表你已阅读并同意平台的《用户服务协议》和《隐私政策》。
2. 访问 API Key 管理页面
Tip
遇到 404 错误？ 若页面提示「错误 404」，通常是由于登录状态刷新延迟。请点击页面中的 「返回控制台」 按钮，或从侧边导航栏重新进入即可。
3. 配置并创建 API Key
点击页面上的 「创建 API Key」 按钮，在弹出的窗口中根据需求填写以下配置：
| 配置项 | 必填 | 说明 | 建议 |
|---|---|---|---|
| 名称 | 是 | API Key 的标识名称 | 设置为项目名或用途，如 Chat-Bot-Prod |
| 模型 | 是 | 选择该 Key 支持调用的模型范围 | 注意：未勾选的模型将无法发起请求 |
| 请求上限 | 否 | 设置单次或周期内的请求次数限制 | 用于防止程序异常导致的消耗过快 |
| 额度 | 否 | 设置该 Key 可使用的最高额度 | 建议根据项目预算分配独立额度 |
| 过期时间 | 否 | 设置 Key 的有效期限 | 临时测试建议设置有效期，长期项目可留空 |
⚠️ 重要：安全与存储说明
Important
关于密钥可见性 为了保障您的账户安全，所有 API Key 在数据库中均经过加密处理。
- 仅限创建时查看：API Key 仅在点击“完成创建”后的弹出窗口中完整显示一次。
- 后续不可找回：一旦关闭弹窗，您将无法再次在控制台查看到完整的 Key 内容。
- 若丢失怎么办：如果您遗失了该 Key，将无法找回，必须通过「删除旧 Key 并重新创建」的方式来获取新的密钥。
4. 管理建议
- 即时保存：创建成功后，请立即点击“复制”按钮，将其保存至安全的密码管理器或环境变量中。
- 环境变量：建议将 API Key 存储在服务器的
.env文件或环境变量中，切勿直接硬编码在前端代码或上传至 GitHub。 - 权限最小化：建议针对不同的应用场景创建独立的 Key，以便精准控制额度和排查问题。