五分钟配置 Codex
准备专用 Key，通过自动脚本或 CC Switch 完成安装、配置和最小验证。
开始接入
外观
牛API面向 AI 工具的 API 接入文档
用专用 Key、真实模型 ID 和清晰的协议路径，完成聊天、编程 Agent 与自动化工具的可靠接入。
Skip to content
API 接入中心
$ curl https://api.reniuniu.win/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"200 从控制台复制真实模型 ID 后，再逐项开启流式、工具调用和图片输入。
不同客户端、模型和协议的支持程度不同。先完成最小文本请求，再逐项开启流式、工具调用和图片输入。
接口地址
用户侧只需配置牛API公开地址，不需要了解或填写任何内部上游地址。
API 根地址
https://api.reniuniu.winOpenAI Base URL
https://api.reniuniu.win/v1认证方式
Authorization: Bearer YOUR_API_KEY协议入口
POST
OpenAI Responses/v1/responses配置后测试适合支持 Responses 的 Agent 客户端；先用短消息确认连接。
POST
Chat Completions/v1/chat/completions配置后测试适合 OpenAI Compatible 客户端；按控制台模型 ID 测试。
POST
Anthropic Messages/v1/messages兼容模式Claude Code 接入入口；按兼容模式从并发 1 起步。
API Key
- 按用途拆分：Cherry Studio、Codex、Claude Code 分别使用不同 Key；
- 设置限制：若控制台支持，设置额度、有效期和模型权限；
- 安全保存：完整 Key 不放进截图、浏览器前端、Git 仓库或工单正文；
- 泄露处理：立即删除或禁用旧 Key，创建新 Key，并检查异常用量。
Key 可能只显示一次
创建后立即保存到系统密钥管理器或安全的环境变量中，不要依赖控制台长期显示完整 Key。
客户端配置
先按你正在使用的工具进入对应教程，再回到兼容性矩阵查看完整状态。每个客户端都需要分别确认协议、Base URL、模型 ID 和环境变量生效范围。
统一配置管理CC Switch：集中切换多个 AI CLI 的 Provider，并管理 MCP、Prompts、Skills、备份和用量。查看 CC Switch 教程 →桌面聊天Cherry Studio、ChatBox 等：通常使用 OpenAI Base URL。查看聊天客户端教程 →编程 AgentCodex、OpenCode 等：先确认 Responses 或兼容协议。查看 Agent 教程 →命令行开发Claude Code：按 Messages 兼容模式配置根地址。查看 CLI 教程 →
- CC Switch：集中管理 Provider、MCP、Prompts、Skills 与配置备份
- Cherry Studio：自定义服务商和协议切换
- Codex：Responses 自定义 provider
- Claude Code：Messages 网关兼容模式接入
- 通用客户端与 SDK：NextChat、Open WebUI、ChatBox、OpenAI SDK、团队多 Key
模型与服务检查
模型、价格和能力可能随控制台更新。开始调用前，在控制台确认真实模型 ID 与价格；出现异常时再进入服务检查。
用量、充值与限速
普通用户从并发 1 开始，每个客户端使用独立 Key。这样出现 429、异常消耗或充值问题时，更容易定位对应记录。
常见问题
401：认证失败
检查 Key 是否缺失、粘贴不完整或已失效；确认环境变量已被当前客户端进程继承。客户端只要求填写 Key 时，不要手动添加 Bearer 前缀。仍失败时创建新的专用 Key。
404：接口或模型不存在
检查 Base URL 是否重复或遗漏 /v1，并逐字核对控制台展示的模型 ID；不同供应商的模型 ID 不要混用。
429：请求受到限制
停止并行任务和激进重试，将并发降到 1，等待后再发起最小请求。
502、503 或流式中断
用短提示词复现，记录客户端版本、协议、模型 ID、时间和请求 ID，再打开服务检查逐项排除。