云筑Hub 文档

从创建 API Key 到完成第一次模型调用，这里集中提供云筑Hub的客户接入说明、客户端配置、接口参考与故障排查。

API 地址

OpenAI 兼容客户端通常填写 https://www.yunzhuhub.cn/v1。完整接口地址示例：https://www.yunzhuhub.cn/v1/chat/completions。

快速开始注册、充值、创建密钥并发起第一个请求。配置客户端接入 Codex、Claude Code、Gemini CLI 和 Cherry Studio。API 参考查看从 OpenAPI 规范自动生成的 28 个已实现接口。排查错误按状态码定位认证、余额、模型和请求格式问题。

常用入口

入口	地址	用途
云筑Hub	www.yunzhuhub.cn	登录、注册与查看公告
控制台	进入控制台	密钥、余额、用量与日志
模型广场	查看实时模型与价格	选择当前可用的模型 ID
模型列表 API	`GET /v1/models`	通过 API 获取密钥可用模型

接入原则

只使用当前模型 ID。 模型可用性和价格会调整，请以模型广场及 GET /v1/models 的实时结果为准。
不要共享密钥。 每个应用或设备使用独立 API Key，发生泄露时可单独停用。
先做最小请求。 新客户端先用短文本、非流式请求验证地址、密钥和模型，再开启复杂功能。
保留请求 ID 与时间。 排查问题时提供发生时间、接口、模型和脱敏后的错误信息，不要发送完整密钥。

兼容说明

云筑Hub提供 OpenAI、Claude、Gemini 等兼容接口。兼容接口会尽量保持请求与响应结构一致，但不同上游模型的能力、参数范围和行为仍可能存在差异。调用前请确认目标模型支持所需能力。

底层项目基于 New API，相关署名和开源许可证保持不变。