Kimi K3 能本地运行吗?硬件、GGUF 与 vLLM 部署指南(2026)
可以。Moonshot AI(月之暗面)在 Hugging Face 上公开了 Kimi K3 的权重,因此它能本地运行;但它是一个 2.8 万亿参数的模型,所谓"本地"意味着:最小的 1-bit GGUF 需要约 610 GB 的内存加显存,原生权重则需要一整台 8 卡 Blackwell 节点。 在内存更小的单台工作站上它仍能从磁盘加载,只是非常慢。对大多数开发者来说,在租用的 GPU 上运行 K3 或通过 API 调用,都比自购硬件更便宜。
本指南介绍截至 2026年10月24日 在自有机器上运行 Kimi K3 所需的一切:许可条款、各量化版本的准确内存需求、llama.cpp 与 vLLM 的分步命令、如何在代码中调用本地服务,以及与租用 GPU 和托管 API 的成本对比。数据来自 Moonshot AI 的模型卡、vLLM 与 SGLang 的官方部署配方以及 Unsloth 文档;凡是我们估算的数字都会标注为估算。
Kimi K3 概览
| 规格 | 数值 |
|---|---|
| 开发方 | Moonshot AI |
| 权重 | Hugging Face 上的 moonshotai/Kimi-K3 |
| 架构 | 混合专家(MoE):总参数 2.8T,每个 token 激活 104B |
| 专家 | 896 个路由专家,每个 token 选 16 个,另有 2 个共享专家 |
| 层数 | 93 层(69 层 KDA 线性注意力层和 24 层门控 MLA 层) |
| 上下文窗口 | 1,048,576 tokens |
| 输入 | 文本和图像(MoonViT-V2 视觉编码器,4.01 亿参数) |
| 原生精度 | MXFP4 权重 + MXFP8 激活(量化感知训练) |
| 推理 | 始终开启思考;reasoning_effort 可选 low、high 或 max(默认 max) |
| 许可 | Kimi K3 License(修改版 MIT) |
来源:Kimi K3 模型卡,查阅于 2026年10月24日。
开始之前有两点说明。第一,Moonshot AI 的 API 现已提供 Kimi K3.1 Pro,并将 K3 称为"上一代旗舰";但截至 2026年10月24日,Hugging Face 上最新的开放权重仍是 Kimi K3,所以 K3 才是你能自己运行的模型。第二,K3 只有思考模式:按照模型卡的说明,多轮对话中客户端必须回传 reasoning_content 和工具调用。
Kimi K3 可以商用吗?
根据 Hugging Face 上的许可文件(2026年10月),Kimi K3 License 是 MIT 风格许可,外加两个条件:
- 如果你以模型即服务(MaaS)的形式提供 K3,且过去 12 个月收入超过 2000 万美元,需要与 Moonshot AI 另行签订协议。
- 如果你的产品月活用户超过 1 亿或月收入超过 2000 万美元,必须在用户界面中显示"Kimi K3"。
公司内部使用不受这些条件限制。对大多数初创公司和团队而言,本地或自托管使用是允许的;上线前请阅读完整许可文本。
Kimi K3 需要多少硬件?
GGUF 量化版本(llama.cpp)
Unsloth 发布了动态 GGUF 量化版本。它的经验法则是:内存加显存至少要等于量化文件的大小,否则模型会卸载到磁盘,运行速度大幅下降。
| 量化 | 所需内存(内存 + 显存) | 说明 |
|---|---|---|
动态 1-bit S(UD-IQ1_S) |
约 610 GB | 文件 594 GB;Unsloth 推荐的体积与质量平衡点,top-1 准确率约 79% |
| 动态 1-bit M | 约 665 GB | |
| 动态 2-bit XXS | 约 726 GB | |
| 动态 2-bit XL | 约 880 GB | Unsloth 报告其 861 GB 动态 2-bit 准确率约 90% |
Q8(UD-Q8_K_XL,无损) |
约 1.6 TB | 文件 1.56 TB;与原生 MXFP4 权重一致 |
Unsloth 报告,当 1-bit 量化完全装入 B200 GPU 时,生成速度约为每秒 20 个 token。在大部分权重放在系统内存中的 CPU 为主的机器上,速度会低得多;我们没有实测,所以在你自己测试硬件之前,看到的任何数字都应视为估算。
实际意味着什么? 一些现实的本地配置:
| 配置 | 能装下 1-bit(610 GB)吗? | 预期(估算) |
|---|---|---|
| 游戏 PC:1 张 RTX 4090(24 GB)+ 128 GB 内存 | 否 | 只能靠大量磁盘卸载运行;非常慢,仅适合测试 |
| 工作站或服务器:1-2 张 GPU + 768 GB DDR5 | 是 | 可用于单用户低速实验 |
| 8 张 80-141 GB GPU 的多卡服务器 | 是,全部在显存中 | 一个或少数用户可获得交互式速度 |
| 8x B300 / GB300 级节点 | 原生 MXFP4 权重 | 用 vLLM 或 SGLang 进行生产级服务 |
原生权重(vLLM 与 SGLang)
对于官方权重,vLLM 的 Kimi K3 部署配方要求至少 8 张 GB300 GPU(AMD ROCm 上至少 8 张 MI355X 或 MI350X),使用 vllm/vllm-openai:kimi-k3 镜像,需要 CUDA 13 和 NVIDIA r580 或更新的驱动。SGLang cookbook 列出了 B300 1x8、GB300 2x4、B200 2x8、GB200 4x4、H200 2x8、H100 4x8 以及 MI350X/MI355X 1x8 等节点形态,但截至 2026年10月,只有 B300 1x8 配置被标记为已验证。换句话说,H100 部署需要四台 8 卡节点,这几乎超出了所有"本地"运行者的能力范围。
更深入的容量规划,请参阅我们的 LLM GPU 显存需求指南和 vLLM 专家并行部署指南。
用 llama.cpp(GGUF)本地运行 Kimi K3
以下步骤参照 Unsloth 的指南。K3 的视觉支持目前需要 Unsloth 维护的 llama.cpp 分支;纯文本使用步骤相同。
1. 编译 llama.cpp。 如果没有 NVIDIA GPU,请使用 -DGGML_CUDA=OFF。
git clone https://github.com/unslothai/llama.cpp
cd llama.cpp
git fetch origin pull/48/head:kimi-k3-fullsize-vision
git checkout kimi-k3-fullsize-vision
cd ..
cmake llama.cpp -B llama.cpp/build -DBUILD_SHARED_LIBS=OFF -DGGML_CUDA=ON
cmake --build llama.cpp/build --config Release -j --clean-first \
--target llama-cli llama-mtmd-cli llama-server llama-gguf-split
cp llama.cpp/build/bin/llama-* llama.cpp
2. 下载 1-bit 量化(约 594 GB)和视觉投影文件。 先检查磁盘剩余空间。
pip install -U huggingface_hub
df -h . # need roughly 650 GB free
hf download unsloth/Kimi-K3-GGUF \
--local-dir unsloth/Kimi-K3-GGUF \
--include "*mmproj-BF16*" \
--include "*UD-IQ1_S*"
3. 在终端中对话。 使用 Moonshot 推荐的采样参数:temperature 1.0、top_p 0.95(智能体任务用 top_p 1.0)。
FIRST=$(ls unsloth/Kimi-K3-GGUF/UD-IQ1_S/*00001-of-*.gguf | head -1)
./llama.cpp/llama-cli --model "$FIRST" \
--mmproj unsloth/Kimi-K3-GGUF/mmproj-BF16.gguf \
--temp 1.0 --top-p 0.95
4. 提供 OpenAI 兼容 API。 llama-server 会暴露 /v1/chat/completions。较小的上下文长度可以为 KV cache 节省内存。
./llama.cpp/llama-server --model "$FIRST" \
--mmproj unsloth/Kimi-K3-GGUF/mmproj-BF16.gguf \
--ctx-size 32768 --temp 1.0 --top-p 0.95 \
--host 127.0.0.1 --port 8080
用 vLLM 部署 Kimi K3(整机节点)
如果你拥有或租用了受支持的 8 卡节点,vLLM 能提供生产级吞吐、工具调用和完整的 1M 上下文。官方配方中的基础命令:
docker run --gpus all --ipc=host -p 8000:8000 \
-v ~/.cache/huggingface:/root/.cache/huggingface \
vllm/vllm-openai:kimi-k3 \
moonshotai/Kimi-K3 --trust-remote-code \
--tensor-parallel-size 8 \
--tool-call-parser kimi_k3 --reasoning-parser kimi_k3 \
--enable-auto-tool-choice \
--max-model-len 1048576 \
--enable-prefix-caching --kv-cache-dtype fp8
该配方还指出,工具调用格式偶尔会出错,因此需要校验工具参数,并在解析失败时重试。我们的 vLLM 部署指南和多 GPU 推理指南介绍了监控和调优方法。
调用本地 Kimi K3 服务
llama-server(上文的 8080 端口)和 vLLM(8000 端口)都支持 OpenAI API,因此任何 OpenAI SDK 都能使用。
curl
curl -s http://127.0.0.1:8000/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"moonshotai/Kimi-K3","temperature":1.0,"top_p":0.95,
"messages":[{"role":"user","content":"Write a bash one-liner that finds the 5 largest files in a directory."}]}'
Python
from openai import OpenAI
# Local vLLM server; use base_url="http://127.0.0.1:8080/v1" for llama-server
client = OpenAI(base_url="http://127.0.0.1:8000/v1", api_key="local")
r = client.chat.completions.create(
model="moonshotai/Kimi-K3",
temperature=1.0, top_p=0.95,
messages=[{"role": "user", "content": "Explain MoE routing in 3 sentences."}],
)
msg = r.choices[0].message
print(getattr(msg, "reasoning_content", None)) # thinking trace, when the server returns it
print(msg.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "http://127.0.0.1:8000/v1", apiKey: "local" });
const r = await client.chat.completions.create({
model: "moonshotai/Kimi-K3",
temperature: 1.0,
top_p: 0.95,
messages: [{ role: "user", content: "Give me a regex for ISO 8601 dates." }],
});
console.log(r.choices[0].message.content);
在多轮对话中,按照模型卡的要求,在下一轮之前把包含 reasoning_content 和 tool_calls 的 assistant 消息追加到历史记录中。
本地、租用 GPU 还是 API:Kimi K3 的成本是多少?
租用 GPU。 Flatkey GPU 价格指数(2026年10月24日 更新)列出的实时价格为:B200 每 GPU 小时 7.49 美元,B300 7.34 美元,H200 3.60 美元,H100 2.48 美元。因此一台 8x B200 节点每小时约 59.92 美元,全天候运行每月约 43,700 美元(我们的估算:8 x 7.49 美元 x 730 小时)。
托管 API。 Moonshot 官方平台上 Kimi K3 的价格为每百万输入 token 3.00 美元、缓存输入 0.30 美元、每百万输出 token 15.00 美元。在 Flatkey 模型页上,Kimi K3 每百万 token 输入 1.80 美元、缓存输入 0.18 美元、输出 9.00 美元,上下文同样为 1,048,576 tokens(均查阅于 2026年10月24日)。
盈亏平衡点(估算)。 按 3:1 的输入输出比计算,Flatkey 的混合价格约为每百万 token 3.60 美元。每月 43,700 美元约可购买 120 亿混合 token,即每天约 4 亿 token。低于这个用量时,在不计工程人力成本的前提下,API 比专用的 8x B200 节点更便宜。
| 方案 | 前期成本 | 最适合 |
|---|---|---|
| 大内存工作站上的本地 1-bit GGUF | 自有硬件 | 隐私敏感的实验、离线工作、学习 |
| 租用 8 卡节点运行 vLLM 或 SGLang | 按小时租用 | 数据可控且需要生产级吞吐、微调研究 |
| 托管 API(Moonshot 或 Flatkey) | 无 | 大多数应用、原型和波动流量 |
只需更换 base URL,就能用上面同样的代码调用托管模型:
import os
from openai import OpenAI
client = OpenAI(base_url="https://router.flatkey.ai/v1", api_key=os.environ["FLATKEY_API_KEY"])
r = client.chat.completions.create(model="kimi-k3",
messages=[{"role": "user", "content": "Summarize the Kimi K3 license in two sentences."}])
print(r.choices[0].message.content)
延伸阅读:自托管 LLM 每百万 token 成本分析、GPU 云与模型 API 对比,以及 Kimi K3 API 接入指南。
故障排查
| 问题 | 可能原因 | 解决方法 |
|---|---|---|
| 生成速度极慢 | 模型装不进内存 + 显存,正在从磁盘读取 | 使用更小的量化、加内存,或换到 GPU 服务器 |
启动 llama-server 时 out of memory |
KV cache 过大 | 调低 --ctx-size |
| 图像输入被忽略 | 缺少投影文件或使用了上游 llama.cpp 版本 | 传入 --mmproj 并编译 Unsloth 分支 |
| vLLM 镜像无法启动 | CUDA 或驱动版本过旧 | 使用 CUDA 13 和 r580 或更新的驱动 |
| 工具调用出错 | 偶发的工具调用格式错误 | 校验参数并重试 |
| 第二轮对话表现异常 | 没有回传思考内容 | 在历史中包含 reasoning_content |
| 下载卡住 | 大型多文件传输 | 重新运行 hf download,会断点续传 |
常见问题
Kimi K3 能本地运行吗?
能。权重是公开的,最小的 1-bit GGUF 需要约 610 GB 内存加显存才能以合理速度运行。内存更少时仍能运行,但会很慢,因为 llama.cpp 需要从磁盘读取权重。
游戏 PC 能跑 Kimi 吗?
基本没法实用。单张 24 GB GPU 加 64-128 GB 内存,远低于最小量化所需的约 610 GB,只能依赖磁盘卸载。建议改用 API 或租用 GPU 服务器。
Kimi K3 需要多少显存?
原生权重方面,官方 vLLM 配方要求至少 8 张 GB300 GPU。GGUF 方面,关键是内存与显存之和:1-bit 约 610 GB,2-bit 约 880 GB(Unsloth,2026年10月)。
Kimi K3 真的比其他模型便宜吗?
通过 API 使用时价格处于中等水平:截至 2026年10月,Moonshot 平台每百万 token 3 / 15 美元,Flatkey 为 1.80 / 9 美元。只有在用量非常大且稳定时,自托管才比 API 更划算。
Kimi K3 是开源的吗?
权重以 Kimi K3 License 开放,这是一个附带署名和大规模商用条件的修改版 MIT 许可。
Kimi K3.1 Pro 能本地运行吗?
不能。截至 2026年10月24日,Kimi K3.1 Pro 只通过 Moonshot 的 API 提供,Kimi K3 是 Hugging Face 上有权重的最新模型。
参考来源
- Kimi K3 模型卡与许可(2026年10月)
- Unsloth Kimi K3 指南和 Kimi-K3-GGUF 文件(2026年10月)
- vLLM Kimi K3 部署配方(2026年10月)
- SGLang Kimi K3 cookbook(2026年10月)
- Kimi API 平台价格(2026年10月)
- Flatkey GPU 价格指数(2026年10月24日 更新)



