牛API 文档

外观

牛API 文档统一 API 接入指南

面向 AI 编程、聊天和自动化工具。创建专用 API Key、确认接口地址、选择客户端与协议、检查用量，并排查常见错误。

5 分钟快速开始
接口地址
打开控制台
牛API
快速开始快速开始

5 分钟快速开始

注册、创建 Key、选择协议、发送测试请求，一次走通最小接入流程。

开始接入

Cherry StudioCherry Studio

Cherry Studio

自定义服务商、Responses 与 Compatible 的区别、模型 ID 手动添加。

查看配置

CodexCodex

Codex

config.toml 自定义 provider、Responses 协议、环境变量与重启要点。

查看配置

Claude CodeClaude Code

Claude Code

ANTHROPIC_BASE_URL 与 Messages 网关接入，当前为实验性方案。

查看配置

模型与渠道模型与渠道

模型与渠道

数据驱动的模型清单、协议范围与计费说明，未录入不推测。

查看模型

故障排查故障排查

故障排查

快速诊断树、400–503 错误码、流式中断与连接失败处理。

开始排查

邀请制内测

OpenAI 风格接口客户端独立 Key状态明确标记
项目值说明
OpenAI Base URLhttps://api.reniuniu.win/v1OpenAI 风格客户端通常填写此地址
认证方式Authorization: Bearer YOUR_API_KEY使用牛API控制台创建的专用 Key
推荐流程注册 → 查模型 → 创建 Key → 配置 → 测试首次测试保持并发 1
不同客户端、模型和协议的支持程度不同。未经完整验证的能力会标记为“待验证”或“实验性”。

接口地址 ​

用户侧只需配置牛API公开地址，不需要了解或填写任何内部上游地址。

API 根地址https://api.reniuniu.win
OpenAI Base URLhttps://api.reniuniu.win/v1
认证方式Authorization: Bearer YOUR_API_KEY

协议入口 ​

POST/v1/responses待验证
OpenAI Responses
适合支持 Responses 的 Agent 客户端；牛API能力待逐项验证。
POST/v1/chat/completions待验证
Chat Completions
适合 OpenAI Compatible 客户端；不要假设所有模型均可用。
POST/v1/messages实验性
Anthropic Messages
Claude Code 候选入口；当前为实验性。

查看请求模板与 Base URL 拼接规则 →

API Key ​

  • 按用途拆分：Cherry Studio、Codex、Claude Code 分别使用不同 Key；
  • 设置限制：若控制台支持，设置额度、有效期和模型权限；
  • 安全保存：完整 Key 不放进截图、浏览器前端、Git 仓库或工单正文；
  • 泄露处理：立即删除或禁用旧 Key，创建新 Key，并检查异常用量。

Key 可能只显示一次

创建后立即保存到系统密钥管理器或安全的环境变量中。该控制台行为仍待牛API实测截图确认。

查看 API Key 完整安全说明 →

客户端配置 ​

每个客户端都需要分别确认协议、Base URL、模型 ID 和环境变量生效范围。不要笼统认为全部模型使用同一协议。

客户端推荐协议Base URL基础调用流式工具调用状态最后验证
Cherry StudioOpenAI Responseshttps://api.reniuniu.win/v1待验证待验证待验证待验证待验证
Codex CLIOpenAI Responseshttps://api.reniuniu.win/v1待验证待验证待验证待验证待验证
Claude CodeAnthropic Messageshttps://api.reniuniu.win实验性待验证待验证实验性待验证

模型与服务状态 ​

真实模型、价格和能力必须来自牛API控制台及实测记录。当前数据未提供，因此文档不展示推测数字。

控制台待人工确认
待验证
API 网关待人工确认
待验证
Responses待协议实测
待验证
Chat Completions待协议实测
待验证
Anthropic Messages实验性
待验证
支付待完整闭环验收
待验证
邮件待完整闭环验收
待验证

用量、充值与限速 ​

  • 普通用户建议并发 1；编程 Agent 可能自动产生多次请求；

  • 每个客户端使用独立 Key，便于定位异常消耗；

  • 收到 429 时降低并发并退避重试，不要立即并行补发；

  • 链动小铺支付闭环仍待完整验收，不承诺固定到账时间或退款结果；

  • 充值未到账时保留用户 ID、两侧订单号、金额、时间、渠道和脱敏截图。

  • 检查用量时优先按 Key、模型、日期、费用和请求 ID 对照；实际筛选字段待控制台实测。

  • 并发、RPM、TPM 与 429 →

  • 链动小铺充值与未到账信息 →

  • 邮箱验证码与找回密码 →

常见问题 ​

400：请求格式或协议不匹配

改用最小请求，检查模型 ID、请求体字段和协议矩阵。不要通过删除未知字段来盲目试错后直接用于生产。

401：认证失败

检查 Key 是否缺失、粘贴不完整或已失效；确认环境变量已被当前客户端进程继承。客户端只要求填写 Key 时，不要手动添加 Bearer 前缀。仍失败时创建新的专用 Key。

404：接口或模型不存在

检查 Base URL 是否重复或遗漏 /v1，并逐字核对控制台展示的模型 ID；不同供应商的模型 ID 不要混用。

402：余额或资源异常

先检查余额、Key 额度和资源状态。需要人工核查时提供发生时间与请求 ID，不要提供完整 API Key。

429：请求受到限制

停止并行任务和激进重试，将并发降到 1，等待后再发起最小请求。

502、503 或流式中断

用短提示词复现，记录客户端版本、协议、模型 ID、时间和请求 ID，再检查服务状态。

模型列表有名称，但调用仍失败

客户端模型缓存、Key 权限和协议可能不一致。重启客户端，手动填写控制台真实模型 ID，并检查是否只有该模型失败。

用量高于一次可见操作

编程 Agent 可能自动重试、读取上下文和调用工具。暂停任务，按时间、专用 Key、模型和请求 ID 对照控制台记录。

查看完整错误码与诊断流程 →

邀请制内测阶段。请使用控制台创建的专用 Key，不要填写上游官方 Key；未经验证的能力均明确标记。

牛API 文档