私库云 - 开发文档
  1. 开始使用
  • 开始使用
    • 入门指南
    • 模型价格
  • 工具接入
    • 工具接入总览
    • CC Switch 配置
    • Codex 配置
    • Claude Code 配置
    • OpenCode 配置
    • OpenClaw 配置
    • Hermes 配置
  • 开发者 API
    • API 调用说明
  • 账户与用量
    • 账户与用量总览
  • 故障处理
    • 问题排查
  • 合作咨询
    • 合作需求提交
  1. 开始使用

入门指南

从注册到第一次成功请求，只需要 3 步：创建 API Key、选择工具、发送测试请求。

先选择你的路径#

你想做什么先看哪一页
在 AI 工具中直接使用工具接入总览
在程序或脚本中调用开发者 API
查看余额、订单和请求记录账户与用量
遇到请求或配置问题故障处理
团队接入、私有化或定制合作合作咨询

3 步开始#

第 1 步：创建 API Key
登录控制台，进入 API密钥 页面，点击创建密钥、选择使用的模型分组，点击创建后即可。
第 2 步：选择接入方式
使用开发工具：按 Codex、Claude Code、OpenCode、OpenClaw 或 Hermes 页面配置。
不熟悉配置文件：优先使用 CC Switch 工具进行配置。
直接改配置文件：让免费AI帮助修改，或者按各工具的官方文档修改配置。
自己写程序：阅读开发者 API，先用最短请求验证。
第 3 步：发送测试请求
第一次只发送一条短消息，确认认证、模型和网络都正常，再运行长任务、流式输出或工具调用。

开始前准备#

一个私库云账号
一个有效的 API Key
账户中有余额，或已开通可用订阅
你准备使用的客户端工具或开发环境

通用接入参数#

配置项填写内容
Base URL在控制台的API密钥页面列表上方的API端点地址
API Key在控制台的API密钥页面创建的 API Key
Model在AI工具里的可用模型列表中选择
不要凭旧截图填写地址和模型名。服务地址、模型和价格可能都会更新。

第一次测试检查清单#

1.
API Key 没有多余空格，也没有被禁用。
2.
Base URL 没有不要拼接V1等版本号。
3.
Model 使用控制台当前显示的名称。
4.
工具或终端配置好后、已完成重启。
5.
控制台请求记录中能看到测试请求。

能力状态#

文档中的能力会标记为：
已支持：当前可以按页面说明使用。
灰度中：仅部分模型、账户或用户可用。
规划中：已纳入开发方向，不建议作为生产依赖。
规划方向会优先围绕 OpenAI 兼容协议，以及主流开发工具的实际接入需求推进。新能力上线前，以控制台显示状态为准。

API Key 安全#

不要把 API Key 放进前端网页、公开仓库、截图或聊天记录。
不要提交包含密钥的配置文件。
怀疑泄露时，立即禁用旧 Key 并创建新 Key。
排查问题时只提供脱敏后的错误信息和请求时间。
普通用户阅读“工具接入”即可；只有需要自行写程序或调用 SDK 时，才需要阅读“开发者 API”。

配置流程示意图#

私库云首次接入流程示意图

完成标志#

你已经可以：
创建并安全保存 API Key。
确认 Base URL 和模型名称。
发出第一条短请求并在控制台看到记录。

下一步#

直接配置工具：查看 工具接入。
自己写程序：查看 开发者 API。
查看余额和请求记录：查看 账户与用量。
下一页
模型价格
Built with