接口地址

大多数 OpenAI Compatible 客户端只需要一个 Base URL。先按客户端提示选择地址，再把模型 ID 和 Key 从控制台原样复制。

OpenAI Base URL（常用）https://api.reniuniu.win/v1

API 根地址（需自行拼端点）https://api.reniuniu.win

怎么选

Cherry Studio、ChatBox、Open WebUI 和 OpenAI SDK 通常填写第一项；只有客户端明确要求 API root，或会自动拼接 /v1 时，才填写第二项。

地址用途

用途	地址	说明
API 根地址	https://api.reniuniu.win	Claude Code 等需要自行拼接端点的客户端使用
OpenAI Base URL	https://api.reniuniu.win/v1	OpenAI 风格客户端和 SDK 通常填写此地址
用户控制台	https://api.reniuniu.win	注册、创建 Key、查看模型和检查用量
文档站	https://docs.reniuniu.win	本指南，接入与排查说明
图片服务	打开图片服务	查看当前图片模型、价格和 API 接入信息
服务检查	文档内检查页	按服务选择检查入口并判断响应结果

控制台与 API 当前使用同一域名，但用途不同。不要把控制台页面 URL 当作具体请求端点。请求路由到后台资源的过程对用户透明，用户侧只需要使用上表中的公开地址。

协议端点

POSTPOST /v1/responses配置后测试

OpenAI Responses

先测试纯文本，再按模型开启流式、工具调用和图片输入。

POSTPOST /v1/chat/completions配置后测试

Chat Completions

OpenAI Compatible 调用入口，使用控制台中的真实模型 ID。

POSTPOST /v1/messages兼容模式

Anthropic Messages

Claude Code 接入入口，按兼容模式从并发 1 起步。

端点用于配置请求路径；模型、客户端版本和高级能力是否适用，请按兼容性矩阵和一次最小请求确认。

能力范围说明

同类 API 网关可能额外提供嵌入、重排序、音频、图像、视频等 OpenAI 风格接口，但不能据此推断牛API也提供相同端点。本页只记录上面三种文本协议；图片生成的接入条件见图片生成 API。

最小 cURL 模板

以下模板用于检查协议结构、认证和地址。先把 MODEL_ID_FROM_CONSOLE 替换为控制台真实模型 ID，并以并发 1 发送短消息。

Responses

curl "https://api.reniuniu.win/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_CONSOLE",
    "input": "请只回复：牛API连接正常"
  }'

Chat Completions

curl "https://api.reniuniu.win/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_CONSOLE",
    "messages": [
      { "role": "user", "content": "请只回复：牛API连接正常" }
    ]
  }'

Anthropic Messages

curl "https://api.reniuniu.win/v1/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_CONSOLE",
    "max_tokens": 64,
    "messages": [
      { "role": "user", "content": "请只回复：牛API连接正常" }
    ]
  }'

先做最小连接测试

请求结构分别依据对应协议示意。基础文本请求成功后，再按实际模型逐项增加流式、工具调用和其他字段；完成业务场景测试前不要接入生产自动化。

通用 SDK

支持自定义 baseURL 的 OpenAI 风格 SDK 可以使用同一地址。以下示例采用 Chat Completions；运行前替换模型 ID，并从非流式短消息开始。

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NIUAPI_API_KEY"],
    base_url="https://api.reniuniu.win/v1",
)

response = client.chat.completions.create(
    model="MODEL_ID_FROM_CONSOLE",
    messages=[{"role": "user", "content": "请只回复：牛API连接正常"}],
)

print(response.choices[0].message.content)

JavaScript

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.NIUAPI_API_KEY,
  baseURL: 'https://api.reniuniu.win/v1',
})

const response = await client.chat.completions.create({
  model: 'MODEL_ID_FROM_CONSOLE',
  messages: [{ role: 'user', content: '请只回复：牛API连接正常' }],
})

console.log(response.choices[0].message.content)

服务端脚本应从环境变量读取 Key。浏览器前端不得直接保存或发送长期有效的 API Key。

图片生成能力

图片服务入口https://image.reniuniu.win

图片生成有独立页面说明。只有控制台明确展示图片模型和接口说明时才开始接入；具体边界见图片生成 API。

Base URL 拼接规则

• 客户端要求 OpenAI Base URL：通常填写 https://api.reniuniu.win/v1；
• 客户端要求 API root，并明确会自动拼 /v1：填写 https://api.reniuniu.win；
• 出现 404：检查实际请求 URL 是否出现 /v1/v1/... 或完全缺少 /v1；
• Claude Code 的 ANTHROPIC_BASE_URL：填写根地址，由客户端请求 /v1/messages。

认证安全

认证请求头Authorization: Bearer YOUR_API_KEY

所有示例使用 YOUR_API_KEY。不要把真实 Key 放在浏览器前端、公开仓库、截图、工单正文或第三方调试网站中。

客户端输入框如果只要求“API Key”，只填写 Key 本身，不要手动添加 Bearer 前缀；只有完整请求头才写成 Authorization: Bearer YOUR_API_KEY。