Developer Documentation

基础 URL 和认证

使用 https://api.caiapi.cc/v1 作为您的基础 URL。通过在 Authorization 头部。这种标准方法允许您无缝接入任何 OpenAI 兼容的 SDK，而无需重写连接逻辑。

Copycurl https://api.caiapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Get user_id 99 for account settings."}]
  }'

您的密钥可访问无审查模型。请妥善保管，因为它会直接跟踪您的 token 使用量和计费情况。

首次使用Python的请求

使用您的密钥和正确的基础 URL 初始化客户端。发送一个简单的提示以验证连接性和响应质量。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.caiapi.cc/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)

预计直接文本响应。该模型忽略标准内容过滤，非常适合角色扮演或创意写作。

Node SDK 集成

安装官方 SDK 并将其配置为指向我们的端点。这确保了与现有 TypeScript 或 JavaScript 项目的兼容性。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.caiapi.cc/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);

处理响应对象以提取生成的文本。其结构与标准 OpenAI 输出匹配。

流式响应

通过将 stream: true. 接收实时生成的 Token，从而降低长输出时的感知延迟。

Copystream = 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)

Token 用量详情出现在最后一个 chunk 中。此方法适用于实时聊天界面。

函数调用与 JSON 模式

在请求中定义工具以获取结构化输出。使用 response_format: {"type": "json_object"} 用于强制执行严格的 JSON 格式。

此功能允许您的应用以编程方式解析模型输出。它与 uncensored 模型在创意和逻辑任务中均能可靠工作。

速率限制与错误

限制：每分钟 300 次请求。并发：每个密钥 8 个请求。错误 401 表示密钥无效。错误 402 表示无余额。错误 429 表示超过速率限制。上下文窗口：100,000 个令牌。最大输出：16,000 个令牌。

错误不消耗余额。请相应地调整您的重试逻辑。