API 文档：OpenAI 兼容端点

认证与基础 URL

通过在环境变量中设置您的唯一密钥和 base URL 来访问 API。端点位于 https://api.apikeykimi.com/v1. 您必须包含标头 Authorization: Bearer YOUR_API_KEY 每次请求都会生成此密钥。该密钥在通过 Google 或电子邮件注册后立即生成。它是认证所需的唯一凭证。无需配置作用域或权限。

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

聊天完成端点

使用标准 /v1/chat/completions 端点。将模型 ID 指定为 uncensored 在请求体中。API 根据您的提示历史记录返回生成的文本。您可以调整 temperature 和 top_p 等参数来控制创造性。该模型支持函数调用和 JSON 模式以生成结构化输出。

Copyfrom openai import OpenAI

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

流式响应（SSE）

通过设置启用实时 token 交付 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)

函数调用 & JSON 模式

使用 response_format 参数。设置 json_object 以确保有效的 JSON 响应。您还可以传递工具定义以进行函数调用。模型会严格遵循这些约束。这使得与外部服务的集成更加可靠。使用 tool_choice 控制工具如何被调用。

Token 限制 & 约束

上下文窗口支持最多 100,000 个 token，包括输入和输出的总和。每次请求的最大输出为 16,000 个 token。如果你未设置 max_tokens, 限制默认为 2,048 个 token。请求体大小限制为 8 MB。您被限制为每分钟 300 次请求。每个密钥最多只能同时运行 8 个请求。

错误处理 & 使用限制

通过检查 HTTP 状态码来处理错误。401 表示 API 密钥无效或已过期。402 错误表示您的预付费余额已耗尽。429 响应表示您已超过每分钟 300 次请求的速率限制。错误和拒绝不会消耗 token。在仪表板上检查您的余额以避免中断。

Node.js

Copyimport OpenAI from "openai";

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