Kimicode 用户快速入门

前提条件

在编写代码之前，使用 Google 或电子邮件在 kimicode.cc 创建账户。您将立即获得一个 API 密钥。无需手机验证，也无需信用卡。您的账户初始拥有 $0.50 的试用额度，有效期为七天。如果需要更多容量，可通过加密货币（TRC20 上的 USDT 或 Base 上的 USDC）进行充值，最低 $10。额度永不过期，错误或被拒绝的请求不会消耗 token。

确保你的开发环境已安装 Node.js（v18+）或 Python 3.8+。本 API 严格遵循 openai 客户端规范，因此你可以直接替换接口，而无需修改库逻辑。我们提供 ID 为 uncensored 的无审查模型。

安装 SDK

为您首选的语言安装官方 OpenAI SDK。这确保了与我们的流式输出、函数调用和 JSON 模式功能的兼容性。

对于 Python，使用 pip 安装标准库：

• pip install openai

对于 Node.js，安装 npm 包：

• npm install openai

这些库会自动处理 HTTP 格式。您不需要特定供应商的客户端。kimicode API 接受标准参数，如 temperature、top_p 和 max_tokens。

初始化客户端

使用 kimicode 基础 URL 和您的 API 密钥配置客户端对象。基础 URL 为 https://api.kimicode.cc/v1。将 api_key 设置为注册时获得的值。此配置将替换默认的 api.openai.com 接口。

• 基础 URL： https://api.kimicode.cc/v1
• 模型： uncensored
• 认证： 通过 api_key 传递 Bearer 令牌

不要将此密钥与其他供应商混合使用。它仅适用于 kimicode 接口。客户端将在首次请求时验证密钥。如果密钥无效，您将立即收到 401 错误。

发起请求

发送标准的聊天补全请求。模型 ID 必须为 uncensored。您可以将 max_tokens 调整至最高 32,000。如果省略，默认值为 2,048。上下文窗口总计为 100,000 token（包含提示词和补全）。

• 输入： messages 数组中的文本消息。
• 输出： choices[0].message.content 中的文本响应。

此接口通过 response_format: {"type": "json_object"} 支持 JSON 模式。它不支持嵌入、图像或音频。专注于无内容拒绝的高质量文本生成，适用于合法的成人主题。

流式响应

通过设置 stream: true 启用流式输出。API 返回服务器发送事件 (SSE)。每个块包含部分文本。Token 使用统计信息包含在流的最后一个块中。这允许实时显示输出，而无需等待完整响应。

• 流标志： 在请求正文中设置为 true。
• 事件类型： chat.completion.chunk
• 数据： 包含文本部分的 delta.content。

流式输出不会改变定价。您为处理的总 token 付费。流式传输期间的错误会优雅处理。如果连接断开，您可以重新启动请求。无审查模型在 100k 限制内的长流中保持连贯性。

限制、错误与上下文

监控您的使用限制：每个密钥每分钟 300 个请求，8 个并发请求，以及 8 MB 的请求体。如果超过速率限制，您将收到 429 错误。如果预付额度耗尽，您将收到 402 错误；通过加密货币充值以恢复。401 错误表示 API 密钥无效或缺失。请注意，失败的请求和被拒绝的请求不会消耗 token。硬性内容限制会拦截涉及未成年人的性内容。所有其他合法的成人内容均被允许。

函数调用

在 tools 参数中定义工具。模型会在响应中返回工具调用。使用 tool_choice 来强制执行特定行为。此功能与 OpenAI 标准完全一致。在你的代码中解析工具调用并执行它们。在后续消息中发送结果。kimicode API 能高效处理工具定义。确保你的 JSON 模式有效。函数调用不会在 token 使用量之外产生额外费用。它非常适合构建智能体或结构化数据提取工作流。

cURL

Copycurl https://api.kimicode.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

流式输出

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)