Kimi API:5 分钟发起首次请求
通过标准的 OpenAI 兼容接口,在 5 分钟内获得首次响应。本指南涵盖无审查模型的设置、认证和基本用法。
前置条件
首先,您需要来自 kimiapikey.com 的 API 密钥。只需邮箱和密码即可注册;试用无需信用卡。您还需要已安装官方或兼容 SDK 的受支持语言环境。我们的 API 遵循 OpenAI chat-completions 格式,因此 GPT-3.5/4 的现有代码通常只需少量修改即可使用。确保您的 SDK 版本足够新,以支持 base_url 参数。
基础 URL 与认证
我们的 API 位于 https://api.kimiapikey.com/v1。认证通过标准的 Authorization 头处理。将你的密钥作为 Bearer 令牌传递。任何接受 OpenAI 兼容接口的客户端均可使用。如果你使用代理或自定义客户端,请确保其正确转发 Authorization 头。你将请求的模型 ID 为 uncensored。
首次请求
发送简单的聊天补全请求以验证设置。使用下方的 curl 命令,将 YOUR_API_KEY 替换为你的实际密钥。此请求向 uncensored 模型发送简短提示词。若成功,你将收到包含模型回复的 JSON 响应。检查 choices 数组以获取生成的文本。若出现 401 错误,表示密钥无效或已过期。
Python SDK
使用官方 OpenAI Python 库可实现最简便的集成。将 base_url 设置为我们的接口并提供密钥。此示例演示基本的文本生成调用。如有需要可调整 model 参数,尽管 uncensored 是默认值。此方法使代码在不同 OpenAI 兼容服务间保持可移植性。
Node SDK
对于 JavaScript/TypeScript 项目,使用 openai npm 包。使用我们的基础 URL 和 API 密钥配置客户端。这允许你直接从 Node 环境发起请求。语法与 Python SDK 镜像一致,确保切换语言时保持一致性。记得使用 await 正确处理异步响应。
流式响应
对于实时输出,请在 SDK 中启用流式输出。这会生成文本时发送文本块,从而降低感知延迟。在请求中使用 stream 标志。SDK 将产生部分响应,允许你逐步更新 UI。这对于聊天界面或需要即时反馈的长文本生成非常理想。
限制与错误
每个密钥每分钟限制 300 次请求。如果超出此限制,你将收到 429 错误。你的请求体不得超过 8 MB。100,000 token 的上下文窗口适用于提示词和补全的总和。常见错误包括 401(密钥无效)和 402(额度不足)。通过仪表板充值以继续使用 API。额度永不过期,且无月费。
cURL
curl https://api.kimiapikey.com/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.kimiapikey.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.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapikey.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);流式输出
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)问答
API 支持函数调用吗?
是的,该接口支持标准 OpenAI 格式的 tool/function calling。你可以在请求中定义工具,模型将返回结构化参数。
超出速率限制会怎样?
你将收到 429 Too Many Requests 错误。稍等片刻后重试,或升级你的预付额度层级以维持更高的吞吐量。
模型使用我的数据进行训练吗?
不会。发送给 API 的提示词不会用于训练。你的数据保持私密,不会用于改进基础模型。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。
技术规格
购买额度前,请先确认接口是否满足你的需求——以下是全部真实参数。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 模型 ID | uncensored |
| 认证 | Authorization: Bearer YOUR_KEY |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| JSON 模式 | response_format: {"type": "json_object"} |
| 并发 | 每个密钥同时最多 8 个请求 |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 请求大小 | 每次请求不超过 8 MB |
| 价格 | 输入 $0.15 / 百万 tokens · 输出 $0.50 / 百万 tokens |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10%,满 $200 送 15% |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 充值 | USDT(TRC20)或 USDC(Base),$20–$500 任意整数金额 |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 登录 | 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 | 模型繁忙——几秒后重试 |