API 文档 - KimiCode

基础 URL 和认证

通过更新基础 URL 并在头中提供密钥将代码连接到我们的 API。我们支持标准身份验证，因此现有的 OpenAI SDK 客户端无需复杂设置即可立即工作。通过 Google 或电子邮件注册后，您的 API 密钥将即时出现，无需电话号码。

每个账户同时仅持有一个有效密钥；生成新密钥将替换旧密钥。请求通过 Authorization 头部进行身份验证，确保您的预付费余额安全访问。

首次请求

使用带有简单 POST 请求的标准聊天补全端点发送第一条消息。在深入研究高级功能或流式数据之前，这将确认您的集成正常工作。响应将返回来自无审查模型的文本输出。

• 将 YOUR_API_KEY 替换为您从仪表板获取的密钥。
• 将模型设置为 'uncensored' 以使用我们特定的开源权重模型。

Copycurl https://api.kimicodepricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
  }'

Python SDK 集成

使用官方 OpenAI Python 库通过将其指向我们的 base URL 与我们的 API 交互。这种方法利用了熟悉的语法，使您能够在不重写整个应用程序逻辑的情况下切换提供商。库会自动处理分词和请求格式化。

• 通过 pip 安装 openai 包。
• 将基础 URL 配置为指向我们的服务。

Copyfrom openai import OpenAI

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

Node SDK 集成

使用 Node SDK 将我们的 API 集成到您的 JavaScript 或 TypeScript 应用中。这确保了前端和后端环境行为的一致性。您可以像使用任何标准 OpenAI 兼容服务一样传递消息并接收响应。

Copyimport OpenAI from "openai";

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

流式传输与 token 使用情况

启用流式传输以通过服务器发送事件（SSE）接收实时 Token 生成。这降低了用户的感知延迟，并允许立即显示部分结果。Token 用量数据（包括输入和输出计数）嵌入在流的最后一个数据块中。

此方法非常适合需要即时反馈的聊天界面。你可以解析流以渐进式更新 UI，而无需等待整个响应。

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)

限制、错误和上下文

通过了解速率限制和常见错误代码来管理您的用量。API 支持 100,000 令牌的上下文窗口，允许深度的对话历史。您每分钟限制为 300 次请求，每个密钥限制为 8 个并发请求。

• 401 表示 API 密钥无效或缺失。
• 402 表示您的预付费余额已耗尽。
• 429 表示您已超出速率限制。

错误不会消耗您的信用余额，因此您可以重试失败的请求而无需承担罚金。