5 分钟发起首个请求

安装 OpenAI Python/Node SDK

首先安装标准的 OpenAI 客户端库。这之所以可行，是因为我们的 API 遵循相同的 OpenAI 兼容接口。你不需要专用的供应商 SDK。只需运行 pip install openai（Python）或 npm install openai（Node.js）。该库会自动处理 JSON 序列化和 HTTP 请求。

配置 Base URL 和 API 密钥

将你的客户端指向我们的接口。将 base URL 设置为 https://api.kimiapi.top/v1，并提供来自仪表板的 API 密钥。此密钥用于验证你的预付额度。你可以在注册页面通过 Google 或电子邮件即时生成新密钥。开始使用无需信用卡。

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

发送首个聊天补全请求

向 uncensored 模型发送简单消息。该模型经过调整，可在合法成人用途下无拒绝地回答。它支持 100,000-token 的上下文窗口，但最大输出为 32,000 个 token。响应直接返回文本。错误和拒绝不会消耗你的额度。

Copyfrom openai import OpenAI

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

启用 SSE 流式输出

对于实时响应，请启用流式输出。SDK 通过 Server-Sent Events (SSE) 流式传输 token。最后一个 chunk 包含用于计费的总 token 用量。这种方法降低了长输出的感知延迟。你可以在应用逻辑中处理到达的每个 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 设置为 {"type": "json_object"} 来确保一致的可机器读取输出。这会强制模型返回有效的 JSON。它非常适合数据提取或配置生成。模型不会破坏结构，使你在代码中解析响应变得更加容易。

Copyimport OpenAI from "openai";

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

查看用量和成本

通过仪表板监控你的用量。输入成本为每百万 token 0.25 美元；输出为每百万 token 1.00 美元。如果收到 401，请检查你的密钥。402 表示你需要使用 USDT 或 USDC 充值。429 表示你达到了每分钟 300 次请求的速率限制。额度永不过期，因此方便时再充值。