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

API 调用说明

规划中
适用于需要在自己的程序、脚本或自动化流程中调用模型的用户。普通用户按“工具配置”接入即可。

调用流程#

创建 API Key → 复制 Base URL → 选择兼容接口 → 发送最短请求
请不要把 API Key 写入公开代码、截图、日志或 Git 仓库。发现泄露后,立即禁用旧 Key 并重新创建。

支持的兼容接口#

兼容方式常见用途状态
OpenAI Chat Completions普通应用、脚本和现有 OpenAI SDK已支持
OpenAI ResponsesCodex 等 Responses API 客户端已支持
Anthropic MessagesClaude Code 等 Messages API 客户端已支持
Responses WebSocket需要实时事件的客户端以控制台状态为准
新模型、新参数和新客户端持续适配灰度中 / 规划中
最终可用范围取决于账户、模型和控制台状态。请以控制台当前显示的接口和模型列表为准。

请求地址和认证#

Base URL:直接复制控制台显示的服务地址。
接口路径:根据兼容方式使用 /v1/chat/completions、/v1/responses 或 /v1/messages。
认证:OpenAI 兼容接口通常使用 Authorization: Bearer 你的 API Key;Anthropic Messages 通常使用 x-api-key。
模型:使用控制台当前显示的模型名称,区分大小写。
/v1 注意:如果控制台复制的 Base URL 已经包含 /v1,请不要再次拼接;如果没有,再按接口路径补充。

OpenAI Chat Completions#

OpenAI Responses#

Anthropic Messages#

建议的接入顺序#

1.
用最短请求确认 API Key、Base URL 和模型名正确。
2.
再开启 stream: true,确认客户端支持流式事件。
3.
最后接入工具调用、多模态和长上下文等高级参数。
4.
生产环境使用环境变量或密钥管理服务,不要硬编码密钥。

状态说明#

已支持:可以按本文示例接入,具体模型以控制台为准。
灰度中:部分账户或模型可用,行为可能变化。
规划中:已纳入兼容方向,尚未承诺上线时间。
规划方向会围绕 OpenAI、Anthropic 兼容协议,以及 Codex、Claude Code、OpenCode、OpenClaw、Hermes 等工具的真实接入需求推进,优先完善认证、流式输出、模型选择和错误信息。

错误排查#

401:检查 API Key 和认证头。
403:检查 Key、账户或接口权限。
404:检查路径和 /v1 是否重复。
429:检查余额、额度、并发和频率限制。
超时:先关闭流式输出,用最短请求测试网络和模型。
相关页面:工具配置、账户与用量、常见问题。

协议选择示意图#

私库云接口协议选择示意图

完成标志#

你已经用最短请求确认认证、接口路径和模型均可用,再开始接入 SDK、流式输出、多模态或工具调用。

下一步#

配置终端工具:查看 工具接入。
查看 Key、余额和请求记录:查看 账户与用量。
请求报错:查看 常见问题。
上一页
Hermes 配置
下一页
账户与用量总览
Built with