API 密钥基础

API 密钥是什么

API 密钥（API Key）用于识别调用者、计算用量和检查权限。它的作用类似密码，任何拿到完整密钥的人都可能消耗你的额度。

创建和使用

在API 密钥页面创建密钥后：

• Codex、Claude Code：点击使用密钥，让控制台生成适合当前操作系统的一键配置。
• 其他客户端：打开对应客户端页面，复制动态生成的 API 地址与配置示例。

公开文档中的示例统一使用：

sk-your-api-key

使用手动配置时，必须将它替换为自己的完整 API 密钥。

Base URL 怎么填写

当前站点配置的 API 地址为：

不同客户端对 /v1 的要求不完全相同，不要凭经验自行添加或删除。一键配置或手动配置都应完整复制对应客户端页面给出的地址。

安全建议

• 不要把 API 密钥提交到 Git 仓库。
• 不要通过截图、群聊或工单发送完整密钥。
• 不要把密钥放进文档站 URL 查询参数。
• 怀疑泄露时立即删除旧密钥，并创建新密钥。
• 不同设备建议使用不同密钥，方便单独停用和查看用量。