接口地址

客户端配置时最常见的错误是 `/v1` 重复或遗漏。先区分 API 根地址、OpenAI Base URL 和实际请求端点。

API 根地址https://api.reniuniu.win

OpenAI Base URLhttps://api.reniuniu.win/v1

认证方式Authorization: Bearer YOUR_API_KEY

地址用途

用途	地址	说明
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	本指南，接入与排查说明
服务状态	https://status.reniuniu.win	计划域名，尚未启用；当前以人工维护的状态页为准

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

协议端点

POSTPOST /v1/responses待验证

OpenAI Responses

流式、工具调用、图片输入与模型范围待牛API实测。

POSTPOST /v1/chat/completions待验证

Chat Completions

传统 OpenAI Compatible 调用入口，需按模型验证。

POSTPOST /v1/messages实验性

Anthropic Messages

Claude Code 候选入口，当前实验性。

端点预留不等于已验证可用，实际状态以兼容性矩阵和控制台公告为准。

能力范围说明

同类 API 网关可能额外提供嵌入、重排序、音频、图像、视频等 OpenAI 风格接口。牛API 是否支持这些能力、支持哪些模型，均以控制台展示和实测为准；在确认前，本页只记录上面三种文本协议，不虚构其他端点。图片生成见图片生成 API。

最小 cURL 模板

以下模板只展示协议结构、认证和地址。必须先把 MODEL_ID_FROM_CONSOLE 替换为控制台真实模型 ID。三个端点均尚待牛API完整实测。

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连接正常" }
    ]
  }'

请求模板待实测

请求结构分别依据对应协议示意；牛API对具体字段、模型和返回格式的兼容性尚未验证。不要未经测试用于生产自动化。

通用 SDK

支持自定义 baseURL 的 OpenAI 风格 SDK 可以使用同一地址进行受控测试。以下示例采用 Chat Completions，模型和牛API兼容性仍待验证。

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。

图片生成能力

图片生成有独立页面说明。当前能力待确认，请先看图片生成 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。

认证安全

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

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