Kimi 用户快速上手
替换基础 URL 和 API 密钥,即可将现有的 OpenAI SDK 调用路由至无审查 LLM。本指南展示启动聊天、流式输出和使用工具所需的精确三行代码。
前置条件:API 密钥
发送请求前需要 API 密钥。在获取 API 密钥页面,使用使用 Google 登录或邮箱和密码注册。密钥会立即显示。新账户获得有效期 7 天的$0.50试用额度;无需信用卡。付费使用可通过USDT (TRC20)或USDC (Base)充值。充值金额为 $10 至 $500。充值 $50 及以上可获得 +5% 奖励,充值 $100 及以上可获得 +10% 奖励。额度永不过期,仅按实际 token 用量计费。错误和拒绝不收费。每个账户只能保留一个活跃密钥;生成新密钥将替换旧密钥。在所有请求的Authorization标头中使用此密钥。
基础聊天补全
kimi api 接口接受标准的 OpenAI 聊天补全请求。将客户端的 base URL 设置为 https://api.kimiapi.cc/v1 并提供你的密钥。我们提供单一的专用无审查模型,其 ID 为 uncensored。该模型为开放权重模型,运行在我们的服务器上,不会拒绝合法的成人内容、虚构内容或争议性话题。它不是 GPT、Claude、Gemini 或其他厂商的模型。你可以发送提示词并接收文本响应。该模型支持 100,000 个 token 的上下文窗口(提示词 + 补全)。每次请求的最大输出为 32,000 个 token;若未设置 max_tokens,则上限为 2,048 个 token。不生成嵌入向量、图片或音频。
流式响应
使用 Server-Sent Events (SSE) 进行流式输出。API 会在生成 token 时进行流式传输。token 用量信息包含在流的最后一个数据块中。这允许您实时监控成本,而无需等待完整响应。所有标准的 OpenAI 兼容 SDK 均支持流式输出。在请求中设置stream=true。客户端将收到包含文本的一系列 delta 对象。您可以拼接这些 delta 以重建完整响应。这对于期望即时反馈的聊天界面非常理想。kimi api通过避免代理开销确保可预测的延迟。
函数调用(工具)
API 支持函数调用(也称为 tools)。您可以在请求中定义工具,模型在适当时会返回结构化参数。使用tools参数传递工具定义列表。您还可以使用tool_choice强制或自动选择工具。模型返回带有函数调用的响应,您可以将其传回 API 以继续对话。这有助于构建智能体或自动化工作流。工具定义遵循标准的 OpenAI 格式。无审查模型能够准确处理工具定义,不会因有效用例而拒绝使用。JSON 模式也可用于更严格的输出格式。
JSON 模式
对于需要严格输出的应用程序,请使用 JSON 模式。将response_format设置为{"type": "json_object"}。模型将尝试返回有效的 JSON 对象。这对于解析数据、生成配置文件或将结构化数据输入其他系统非常有用。JSON 模式与函数调用同时工作。您还可以设置temperature、top_p、stop、seed、presence_penalty和frequency_penalty等参数来控制创造力和确定性。这些参数是 OpenAI 兼容客户端的标准参数。根据您的用例调整它们,以平衡一致性和创造性。
限制、错误与上下文
每个 API 密钥限制为每分钟 300 个请求和 8 个并发请求。请求体不得超过 8 MB。如果密钥无效,您将收到 401 错误。如果没有额度,您将收到 402 错误。如果超出速率限制,您将收到 429 错误。错误和拒绝不收费,因此您无需为失败的请求付费。上下文窗口总共为 100,000 个 token。有严格的内容限制:涉及未成年人性内容的请求始终会被拒绝。API 仅支持文本。不提供嵌入、图像或微调功能。对于其他供应商的模型,请查看其文档以获取当前价格和限制。该服务是独立的替代方案,与它们无关。
cURL
curl https://api.kimiapi.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
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapi.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapi.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);流式输出
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)接口能力与限制
购买额度前,请先确认接口是否满足你的需求——以下是全部真实参数。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| Base URL | https://api.kimiapi.cc/v1 |
| 模型 ID | uncensored |
| 认证 | Authorization: Bearer YOUR_KEY |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| JSON 模式 | response_format: {"type": "json_object"} |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 请求大小 | 每次请求不超过 8 MB |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 并发 | 每个密钥同时最多 8 个请求 |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 充值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整数金额 |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10% |
| 价格 | 输入 $0.25 / 百万 tokens · 输出 $1.00 / 百万 tokens |
| 登录 | Google 或邮箱 + 密码 |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
错误代码
错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。
| 状态码 | 类型 | 含义 |
|---|---|---|
400 | bad_request | JSON 无效、消息为空、参数错误或超出上下文窗口 |
401 | missing_key · invalid_key · key_revoked | 缺少密钥、密钥错误或已被新密钥替换 |
402 | no_credit | 余额不足——充值后立即恢复 |
403 | content_blocked | 涉及未成年人的性内容——拒绝且不计费 |
404 | not_found | 未知接口 |
413 | request_too_large | 请求体超过 8 MB |
429 | rate_limited · concurrency | 超过每分钟 300 次或 8 个并发——稍后重试 |
503 | upstream_busy | 模型繁忙——几秒后重试 |
问答
上下文窗口和输出限制是多少?
上下文窗口为 100,000 token(提示词与补全之和)。每次请求的最大输出为 32,000 token。若未设置 <code>max_tokens</code>,限制为 2,048 token。
如何为我的额度充值?
仅使用加密货币充值:USDT (TRC20) 或 USDC (Base)。接受的金额为 $10 至 $500 的整数金额。充值 $50 及以上可获得 +5% 奖励,充值 $100 及以上可获得 +10% 奖励。额度永不过期。
这是官方的 Kimi API 吗?
不是。这是一个提供 OpenAI 兼容接口的独立服务。我们提供单一的无审查模型。我们与 Moonshot AI 或其他供应商均无关联。请查阅各供应商文档以获取其官方 API。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。