使用 API 密钥进行编码
使用 Coderen API 密钥可以使用与 OpenAI 兼容的 API 的编码工具。该工具向 AI-Public 发送请求。AI-Public 会检查密钥、预算、有效期和允许的模型。
随后 AI-Public 通过环境的技术对接处理请求。
你需要什么?
你需要三项信息:
| 信息 | 在哪里可以找到? |
|---|---|
| API 密钥 | 由管理员提供 |
| 端点 (Endpoint) | https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| 模型名称 | 例如 gpt-5.6-luna、gpt-5.6-terra 或 gpt-5.6-sol |
API 密钥以 aip. 开头。请将此密钥当作密码来对待。
你应该选择哪种工具?
AI-Public 建议多数用户使用 OpenCode。OpenCode 是一个面向终端、桌面和 IDE 的具备代理能力的编码工具。该工具可以独立执行步骤、编辑文件并继续扩展任务。
Aider 与 OpenAI 兼容的端点技术上兼容,但在 Public 环境中并不作为默认工具推荐。
另请参见 OpenCode 官方文档。
安全处理密钥
不要在公共场合分享你的 API 密钥,也不要将其放在你分享的代码中。
优先使用:
- 环境变量
- 不随代码一起提交到 Git 的本地
.env - 工具的内置配置
注意
切勿将 API 密钥放在公共仓库、聊天、共享文档或截图中。
如果密钥无法工作
请检查:
- 是否已为该环境开启 Coderen
- 密钥是否仍在有效
- 预算是否用完
- 密钥是否落在设定的有效期内
- 是否使用的是被允许的模型
- 端点是否正确配置
如有疑问,请向管理员请示以检查密钥。
环境变量与 OpenCode
对于 OpenCode,可以将 Coderen API 密钥保存在项目文件夹中的本地 .env 文件中:
AI_SCHOOL_CODEREN_API_KEY=你的-api-密钥
确保 OpenCode 也确实加载了该环境变量。在 PowerShell 中,你也可以将变量临时设置在当前终端中:
$env:AI_SCHOOL_CODEREN_API_KEY="你的-api-密钥"
如果你看到 Authorization header with Bearer token is required,则工具没有将密钥作为 Authorization: Bearer ... 发送。若看到 Unknown parameter,请删除 AI-Public 的 Coderen 端点不支持的供应商特定设置。