Kimi K3 API 接入文档
模型 ID kimi-k3 · 月之暗面 · 走 OpenAI Chat Completions,可用率 100.0%,8 条线路自动切换。
月之暗面(Moonshot AI)新一代旗舰思考大模型,1M 超长上下文,始终开启深度思考,原生支持图片与视频理解,代码编写、复杂推理与智能体(Agent)能力全面升级。
协议与端点endpoint
https://api.lk888.ai/v1/chat/completions推荐 SDK:openai(Python) / openai(Node)。OpenAI 兼容 接口,把 SDK 的 base_url 换成 https://api.lk888.ai、model 换成 kimi-k3,其余保持不变。
鉴权auth
Authorization: Bearer sk-xxxxxxxx本站同时兼容 Authorization: Bearer、x-api-key、x-goog-api-key、?key= 四种方式,按你的 SDK 习惯填即可;同时带多个头时以 Bearer 为准。
密钥可在控制台设置 IP 白名单(单个 IP 或 CIDR 网段)。名单外的来源调用会返回 403、error.code = ip_not_allowed,报错里带平台看到的来源 IP,不扣费;把该 IP 加进白名单或清空白名单即可。
请求示例example
下面是最小可用请求,直接 POST 到上面的端点即可。要流式,把 stream 置为 true。
curl -X POST 'https://api.lk888.ai/v1/chat/completions' \
-H 'Authorization: Bearer $LK_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "kimi-k3",
"messages": [
{
"role": "user",
"content": "用一句话解释什么是 Base URL。"
}
],
"max_tokens": 1024,
"stream": false
}'import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["LK_API_KEY"],
base_url="https://api.lk888.ai/v1",
)
resp = client.chat.completions.create(
model="kimi-k3",
messages=[{"role": "user", "content": "用一句话解释什么是 Base URL。"}],
max_tokens=1024,
)
print(resp.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.LK_API_KEY,
baseURL: "https://api.lk888.ai/v1",
});
const resp = await client.chat.completions.create({
model: "kimi-k3",
messages: [{ role: "user", content: "用一句话解释什么是 Base URL。" }],
});
console.log(resp.choices[0].message.content);{
"model": "kimi-k3",
"messages": [
{
"role": "user",
"content": "用一句话解释什么是 Base URL。"
}
],
"max_tokens": 1024,
"stream": false
}流式输出streaming
请求体里加上 stream: true 即可开启流式返回。
curl -X POST 'https://api.lk888.ai/v1/chat/completions' \
-H 'Authorization: Bearer $LK_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "kimi-k3",
"messages": [
{
"role": "user",
"content": "用一句话解释什么是 Base URL。"
}
],
"max_tokens": 1024,
"stream": true
}'返回标准 SSE 事件流(data: {...} 逐块下发,以 data: [DONE] 收尾),与 OpenAI 协议完全一致。
查本次花费billing
想知道这一次调用实际花了多少:响应头 X-Task-Id 是本平台任务号,流式与非流式都带。拿它调下面的接口,is_final = true 时的 cost 就是本次实际结算金额。
https://api.lk888.ai/v1/skills/task-status?task_id={task_id}返回里同时带 input_tokens / output_tokens。响应体里的 id 由上游生成,不能用来查询。平台是先把响应交付给你、随后立即结算,收到响应马上查若 is_final 仍是 false,隔 1~2 秒重查即可。
官方 SDK 读响应头:Python 用 .with_raw_response,JS 用 .withResponse()。
第三方工具接入clients
Cursor、Cline / Roo Code、Cherry Studio、LobeChat、NextChat、OpenWebUI、Continue 等支持自定义端点的客户端,都按下面四项填。
| 填什么 | 值 |
|---|---|
| Base URL | https://api.lk888.ai/v1 |
| API Key | sk- 开头,在控制台创建(可设 IP 白名单) |
| 模型 ID | kimi-k3 |
| 协议 | OpenAI Chat Completions |
填完保存后发一条测试消息即可验证;若报 401 检查 Key,报 403 检查 IP 白名单。
常见错误errors
| 状态码 | error.code | 怎么处理 |
|---|---|---|
401 | invalid_api_key | Key 不存在或已删除,回控制台重新创建 |
402 | insufficient_balance | 余额不足,主站充值后即时生效(余额与主站共用) |
403 | ip_not_allowed | 来源 IP 不在白名单,报错里带平台看到的 IP,不扣费 |
404 | model_not_found | 模型 ID 写错,或该模型已下线;用本页顶部的 ID 精确复制 |
429 | rate_limited | 并发或频率超限,退避重试;也可换用同系列其它线路 |
5xx | upstream_error | 上游渠道异常,平台会自动切换同模型的其它线路,重试即可 |
一个 Key 可同时用于多台服务器。建议按环境各建一把并配 IP 白名单,便于审计与随时停用;余额与主站共用,每一笔调用都能在控制台按条查到。
批量采购、对公结算、商务合作请走主站联系入口。
联系商务合作 →