Kimicode：5 分钟发起首个请求

基础 URL 与认证

首先将客户端指向我们的基础 URL：https://api.kimicode.top/v1。每次请求都需要 API 密钥。点击网站上的 获取 API 密钥 即可生成。支持 Google 登录，或使用邮箱和密码。无需手机号。密钥在创建后立即显示。请妥善保管；每个账户仅有一个有效密钥。若生成新密钥，旧密钥将失效。将密钥作为 Bearer token 传入 Authorization 请求头。

首次请求

向聊天补全接口发送首个提示词。使用模型 ID uncensored。API 接受标准的 OpenAI 兼容格式。输入提示词，输出文本。错误和拒绝不收费，你只需为成功的 token 使用付费。使用简单提示词测试连通性。

复制curl https://api.kimicode.top/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."}]
  }'

如果密钥无效，你会收到 401 错误。如果额度不足，你会收到 402。如果请求意外失败，请检查账户余额。

Python SDK 集成

使用官方 OpenAI Python SDK。将基础 URL 设置为我们的接口。传递你的 API 密钥。客户端会自动处理请求格式。这适用于任何支持 OpenAI 兼容客户端的语言。通过 pip 安装库。使用你的基础 URL 和密钥配置客户端。使用聊天补全接口发送消息。响应包含生成的文本。你可以直接从响应对象中解析内容。

复制from openai import OpenAI

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

Node.js SDK 工作方式相同。导入客户端。配置基础 URL 和 API 密钥。调用聊天补全方法。传递模型 ID 和消息数组。响应结构与 OpenAI 格式匹配。提取助手消息内容。此方法适用于服务器端生成或边缘函数。除了更改基础 URL 外，无需其他配置。

复制import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimicode.top/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。资金不足返回 402。

流式响应

通过设置 stream: true 启用流式输出。API 返回 Server-Sent Events (SSE)。每个块包含部分文本。token 使用详情出现在最后一个块中。这降低了长输出的感知延迟。正确处理流终止。当流结束或发生错误时关闭连接。支持 SSE 的所有标准客户端均支持流式输出。

复制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)

确保你的客户端正确缓冲块。将内容连接以形成最终响应。

限制、错误与上下文

上下文窗口总计 100,000 token。每次请求最大输出 32,000 token。如果未设置 max_tokens，请设为 2,048。速率限制为每个密钥每分钟 300 次请求。并发限制为 8 个并发请求。请求体最大 8 MB。错误包括：401（密钥无效）、402（无额度）和 429（速率限制）。额度永不失效。错误不计费。无订阅陷阱。