聊天机器人 API 快速入门指南
几分钟内即可开始使用聊天机器人 API。本指南涵盖身份验证、基本请求、流式输出和函数调用,使用我们兼容 OpenAI 的接口。
基础 URL 与身份验证
将标准 OpenAI 基础 URL 替换为 https://api.chatbotapis.com/v1 以将请求路由至我们的无审查 LLM。使用标准 API 密钥通过 Authorization 标头进行身份验证。您的密钥在注册后立即生成,位于获取 API 密钥页面,并与一个账户绑定。您可以随时重新生成密钥,这将立即撤销旧密钥。无需信用卡即可开始,试用额度有效期为 7 天。
基本补全请求
发送标准的 chat/completions 请求以获取文本输出。模型 ID 始终为 uncensored。此 API 支持文本输入和文本输出,上下文窗口为 100,000 token。使用此接口进行直接的 LLM 交互,无需嵌入或图像生成。
curl https://api.chatbotapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'响应会在 content 字段中包含生成的文本。如果你的密钥无效,会收到 401 错误。如果你没有预付额度,会收到 402 错误。
Python SDK 快速入门
安装官方 OpenAI Python 库并将其指向我们的基础 URL。这允许您使用已熟悉的 OpenAI SDK,但直接访问我们的无审查模型。在发出请求前设置 api_key 和 base_url。
from openai import OpenAI
client = OpenAI(base_url="https://api.chatbotapis.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)此设置适用于简单补全和复杂的函数调用。SDK 会自动处理 JSON 格式。请记住,提示词不会用于训练您的账户数据。
Node.js SDK 集成
对于 JavaScript 开发者,Node.js OpenAI SDK 工作方式相同。使用您的密钥和 ChatBotApis 的特定基础 URL 初始化客户端。这对于需要原始 LLM 输出的后端服务或无服务器函数构建非常有用。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatbotapis.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);确保正确处理错误。429 状态代码表示您已达到每分钟 300 次请求的速率限制。400 错误通常表示请求正文格式错误或超过 8 MB 限制。
通过 SSE 进行流式响应
使用服务器发送事件 (SSE) 进行低延迟文本生成。在请求中设置 stream: true。API 在生成时返回文本块,允许您的应用程序实时显示 token。与等待完整响应相比,这显著降低了感知延迟。
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)流式模式适用于 Python 和 Node SDK。它非常适合期望即时反馈的聊天界面。上下文窗口仍适用于总提示词加补全 token。
速率限制、错误与上下文
我们的 API 执行严格限制以确保稳定性。每个密钥每分钟允许 300 次请求。最大请求体大小为 8 MB。如果超出限制,你将收到 429 错误。上下文窗口为 100,000 个 token,同时计算输入和输出。该模型在合法成人用途方面无审查,但会屏蔽涉及未成年人的性内容。没有 SLA 保证或认证,但价格透明,预付额度永不失效。
问答
这是官方的 OpenAI API 吗?
不是。我们是一家独立服务,采用 OpenAI 兼容的 API 格式。我们的模型是托管在自有服务器上的开放权重模型,而非 GPT-4 或 GPT-3.5。
奖励额度是如何运作的?
充值 $50 或以上可获得 +5% 奖励额度,充值 $100 或以上可获得 +10% 奖励额度。额度将添加到您的预付余额中,且永不过期。
如果我重新生成 API 密钥会发生什么?
旧密钥将立即被撤销且无法再使用。新密钥立即生效。更改密钥不会导致任何预付额度或历史记录丢失。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。
ChatBotApis
chatbotapis.com
接口能力与限制
所有限制、功能与价格一览。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 模型 ID | uncensored |
| 认证 | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.chatbotapis.com/v1 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| JSON 模式 | response_format: {"type": "json_object"} |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 请求大小 | 每次请求不超过 8 MB |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 并发 | 每个密钥同时最多 8 个请求 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 价格 | 输入 $0.25 / 百万 tokens · 输出 $1.00 / 百万 tokens |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10% |
| 充值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整数金额 |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 登录 | Google 或邮箱 + 密码 |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
错误代码
错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。
| 状态码 | 类型 | 含义 |
|---|---|---|
400 | bad_request | JSON 无效、消息为空、参数错误或超出上下文窗口 |
401 | missing_key · invalid_key · key_revoked | 缺少密钥、密钥错误或已被新密钥替换 |
402 | no_credit | 余额不足——充值后立即恢复 |
403 | content_blocked | 涉及未成年人的性内容——拒绝且不计费 |
404 | not_found | 未知接口 |
413 | request_too_large | 请求体超过 8 MB |
429 | rate_limited · concurrency | 超过每分钟 300 次或 8 个并发——稍后重试 |
503 | upstream_busy | 模型繁忙——几秒后重试 |