更新于
OpenAI 兼容 API 网址:基础 URL 和请求头
基础 URL 是 https://api.chinesellmapi.com/v1。将其放入你的 OpenAI 客户端期望的基础 URL 位置,将密钥作为 Bearer token 添加,并使用模型 ID uncensored。

简短回答
如果你正在寻找此服务的 openai compatible api url,请复制此值:
https://api.chinesellmapi.com/v1
这是基础 URL。任何具有名为“base URL”、“API base”、“endpoint”或“host”字段的 OpenAI SDK、桌面客户端和代理框架都接受此字符串。密钥放入匹配的“API key”字段中,模型名称为 uncensored。
其后有两个接口:用于聊天的 POST /v1/chat/completions 和用于列出模型的 GET /v1/models。不提供 OpenAI 接口中的其他功能,因此没有嵌入路由、图像路由和微调路由。如果你需要先获取密钥,API 密钥页面 将引导你完成注册。
基础 URL 与完整接口 URL
大多数错误发生在这里。客户端分为两类:一类希望使用基础 URL 并自行添加路径,另一类希望使用完整的调用 URL。下表展示了两种形式。
| 字段要求的内容 | 输入的值 |
|---|---|
| Base URL、API 基础地址、OpenAI 主机 | https://api.chinesellmapi.com/v1 |
| 完整的聊天补全 URL | https://api.chinesellmapi.com/v1/chat/completions |
| 模型列表 URL | https://api.chinesellmapi.com/v1/models |
官方 OpenAI SDK、LangChain 的 OpenAI 包装器、LiteLLM 和大多数聊天前端属于第一类。允许粘贴原始请求 URL 的工具属于第二类。当字段标签未指明是哪一种时,请阅读占位符文本:如果它显示以 /v1 结尾的内容,则它需要基础 URL。
尾部斜杠
大多数 SDK 处理尾部斜杠,但有些通过纯字符串连接构建最终路径。如果你遇到 404 错误且 URL 以 /v1/ 结尾,请删除最后一个斜杠并重试。
API 期望的请求头
请求需要一个用于身份验证的请求头和一个用于正文类型的请求头:
Authorization: Bearer YOUR_KEYContent-Type: application/json
SDK 会自动为你设置两者。如果你手动构建请求,这里是最小的有效调用:
curl https://api.chinesellmapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Say hello in one sentence."}]
}'
响应包含一些值得记录的头信息:X-Request-Id 用于支持问题,X-Balance-USD 用于剩余额度,以及 X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency 用于适用于你密钥的限制。
在 OpenAI SDK 中设置
与标准 OpenAI 设置相比,只有两个值需要更改:基础 URL 和密钥。代码中的其余部分保持不变。
Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Translate 'good morning' into Chinese."}],
)
print(resp.choices[0].message.content)
Node
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.chinesellmapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Translate 'good morning' into Chinese." }],
});
console.log(resp.choices[0].message.content);
流式输出工作方式相同:添加 stream: true 并读取数据块。使用情况数据在流结束时到达。请注意,流式请求在流关闭前会占用一个并发槽位。
使用环境变量而非代码
当前的 Python 和 Node.js OpenAI SDK 会在未通过代码传递时从环境变量中读取 OPENAI_BASE_URL 和 OPENAI_API_KEY。这是将现有项目指向新接口而无需修改代码的最快方法:
export OPENAI_BASE_URL="https://api.chinesellmapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py
许多第三方工具使用相同的两个变量名,尽管有些使用自己的变量名,例如旧项目中的 API_BASE 或 OPENAI_API_BASE。请查看工具的文档以获取确切名称。如果项目中硬编码了 api.openai.com,请在源代码中搜索该主机名并替换它。
模型名称通常位于单独的设置中,因此请记住将其更改为 uncensored。保留默认的 OpenAI 模型名称是导致错误的第二个最常见原因(仅次于 URL 错误)。
在调试应用之前检查连接
使用零成本调用来测试 URL 和密钥。列出模型不需要 token:
curl https://api.chinesellmapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
如果返回包含 uncensored 的 JSON 列表,则 URL 和密钥正常,任何剩余问题都在客户端设置中。如果失败,请使用此表。
| 症状 | 可能原因 | 修复方法 |
|---|---|---|
| 404 未找到 | 路径重复(/v1/v1/...)或 /v1 缺失 | 精确输入基础 URL,以 /v1 结尾 |
| 401 未授权 | 密钥缺失、复制时带有空格或发送到了错误的请求头 | 发送 Authorization: Bearer YOUR_KEY 并重新复制密钥 |
429 错误,代码为 rate_limited | 每分钟请求过多 | 降低速度或排队请求 |
429 错误,代码为 concurrency | 同一时刻请求过多 | 限制并行调用,记住流式请求会占用槽位 |
429 且 Retry-After: 5 | 临时过载 | 等待五秒并重试 |
| 未找到模型 | 残留的 OpenAI 模型名称 | 将模型设置为 uncensored |
在生产环境使用前应知的限制
完整密钥支持 8 个并发请求和每分钟 300 个请求。试用密钥支持 2 个并发请求和每分钟 60 个请求。请求体最大为 8 MB,上下文窗口大小为 100,000 个 token(包含提示词和补全),因此 max_tokens 是可选的。
该服务仅支持文本,并由独立提供商运行单一开放权重模型。它不是任何模型供应商的官方 API,也不在供应商之间路由。如果你的应用是中文产品,中文应用快速入门 展示了如何构建提示词,翻译 API 指南 涵盖了术语表和占位符。
计费为按量付费,从预付额度扣除:每 1M 输入 token $0.15,每 1M 输出 token $0.50。失败或被拒绝的请求不收费。定价页面 列出了充值大小和奖金,新用户可以在密钥页面一键领取 $0.50 的试用额度,有效期 7 天且无需绑卡。有关客户端设置的更详细指南,请参阅 快速入门文档。
将未成年人作为性对象的内容始终不允许;除此之外,该模型经过调整,可在合法成人使用中无需内容拒绝即可回答。
URL 的其他去向
不同框架对字段的命名方式不同,但值相同。以下是三个常见示例:
# LangChain
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
model="uncensored",
)
# LiteLLM
import litellm
r = litellm.completion(
model="openai/uncensored",
api_base="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
messages=[{"role": "user", "content": "ping"}],
)
在 LiteLLM 中,openai/前缀指示库使用 OpenAI 线格式向你的基础 URL 发起请求,斜杠后的部分是模型 ID。SillyTavern 等聊天前端具有“自定义 OpenAI 兼容”源,包含三个输入框:URL、密钥和模型。同样是这三个值。
将密钥与浏览器隔离
不要从面向访客的前端 JavaScript 中调用 API。任何人都可以从页面中读取密钥并消耗你的额度。在中间放置一个小型服务器路由,将密钥存储在该处的环境变量中,让你的站点调用该路由。
无需代码更改即可在接口之间切换
如果你测试多个提供商,请将这三个值放入配置文件中,而不是源代码中。一个小型设置块即可完成工作,并使 URL 成为你唯一需要编辑的内容:
import os
from openai import OpenAI
client = OpenAI(
base_url=os.getenv("LLM_BASE_URL", "https://api.chinesellmapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.getenv("LLM_MODEL", "uncensored")
这也使得测试环境和生产环境易于分离:为每个环境使用不同的密钥,X-Balance-USD响应头将显示各自的剩余预付额度。
更多指南
问答
我需要在 Base URL 中包含 /chat/completions 吗?
不需要。输入 https://api.chinesellmapi.com/v1 并让 SDK 自动追加 /chat/completions。只有需要完整请求 URL 的工具才需要更长的形式。
我可以在多个应用中使用同一个 URL 吗?
可以。URL 和密钥可以放入任意数量的客户端中。它们共享你密钥的限制:8 个并发请求和每分钟 300 个请求(完整密钥)。
我应该输入什么模型名称?
使用 uncensored。你可以通过使用密钥调用 GET /v1/models 来确认。
这是 OpenAI 风格供应商的官方 API 吗?
不是。这是一个托管 API,背后是由独立提供商运营的单一开放权重模型,旨在兼容 OpenAI 请求格式。
我如何在不消耗额度的情况下测试密钥?
调用 GET /v1/models 并附带 Authorization 请求头。它将返回模型列表且不消耗 token。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。