如何访问Kimi K2.5:网页、API、Claude Code、自托管

如何访问Kimi K2.5:网页、API、Claude Code、自托管

访问最前沿的AI模型不应需要数周的基础设施搭建。Kimi K2.5可通过四种路径获取:网页游乐场(零配置)、Novita AI API(三行代码)、代码工具集成(Claude Code、Cursor、Continue)以及本地部署(375GB+基础设施)。

本指南涵盖所有访问方式——从最简单到最复杂——设置时间从约30秒(网页访问)到数天(自托管)。API访问定价为每1M tokens $0.60 / $3.00,提供生产级性能,无需管理GPU集群的运营开销。

Kimi K2.5 模型介绍

Kimi K2.5 的新特性

Kimi K2.5 引入了Agent Swarm模式,该模式可协调多达100个专业子代理并行执行工作流。通过动态生成代理执行并发任务,相比顺序处理,执行速度可提升高达4.5倍。该模型还能在200–300次连续工具调用中保持稳定性能而不漂移,解决了许多模型在长代理会话中容易丧失连贯性的常见问题。

来自Kimi

核心规格

开发者 Moonshot AI
参数 1 trillion 总量,32B 活跃(MoE 架构)
上下文窗口 256K tokens
模态 文本、视觉
操作模式 即时(3-8秒)、思考(推理痕迹)、代理(搜索/代码/网页)、Agent Swarm(并行协调)

基准性能

总体而言,Kimi K2.5 在以下方面尤为突出:

  • 代理搜索与自主研究
  • 数学推理
  • 基于文档/OCR的视觉任务
  • 长视频多模态理解
类别 基准 Kimi K2.5 GPT-5.2
推理 HLE-Full 30.1 34.5
HLE-Full(带工具) 50.2 45.5
AIME 2025 96.1 100
HMMT 2025 95.4 99.4
IMO-AnswerBench 81.8 86.3
GPQA-Diamond 87.6 92.4
MMLU-Pro 87.1 86.7
视觉/多模态 MMMU-Pro 78.5 79.5
MathVision 84.2 83.0
MathVista 90.1 82.8
OCRBench 92.3 80.7
InfoVQA 92.6 84.0
SimpleVQA 71.2 55.8
视频理解 VideoMMMU 86.6 85.9
MotionBench 70.4 64.8
LongVideoBench 79.8 76.5
编程 SWE-Bench Verified 76.8 80.0
SWE-Bench Pro 50.7 55.6
TerminalBench 50.8 54.0
LiveCodeBench 85.0
代理搜索 BrowseComp 60.6 65.8
BrowseComp(Agent Swarm) 78.4
DeepSearchQA 77.1 71.3

立即尝试Kimi K2.5!

访问方式一:Novita AI 游乐场

Novita 的游乐场提供了一种无需设置开销即可探索和使用Kimi K2.5的直接方式。你可以直接在聊天或生成界面中与模型交互,实时调整温度和最大token等参数,并立即观察输出如何变化。它允许你在集成到应用程序之前测试提示词、优化系统指令并评估回复质量。

在免费游乐场上尝试Kimi K2.5。

立即尝试Kimi K2.5!

访问方式二:Novita AI API 访问(面向开发者)

生产级程序化访问,兼容OpenAI端点。 Novita AI 提供Kimi K2.5的即时API访问,输入token每1M $0.60,输出token每1M $3.00——比Claude Opus 4.5同等推理任务便宜76%。兼容OpenAI端点意味着你现有代码只需更改两项配置:base URL和API密钥。

立即尝试Kimi K2.5!

获取API密钥

  1. 在novita.ai创建账户
  2. 导航至Key Management
  3. 生成新的API密钥(妥善保管——像对待密码一样对待它)

与API集成

安装OpenAI SDK并连接到Novita的端点:

pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="<Your API Key>",
    base_url="https://api.novita.ai/openai"
)

response = client.chat.completions.create(
    model="moonshotai/kimi-k2.5",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, how are you?"}
    ],
    max_tokens=262144,
    temperature=0.7
)

print(response.choices[0].message.content)

访问方式三:代码工具集成

将Kimi K2.5集成到你的开发环境中,用于代理式编程工作流。这些工具提供终端自动化、IDE集成以及多步骤任务执行能力,利用Kimi的扩展工具调用稳定性。

通过官方集成和分步指南,轻松将Novita AI与合作伙伴平台如 TraeContinueCodexOpenCodeAnythingLLMLangChainDifyLangflowOpenclaw 连接。

Claude Code

最适合: 基于终端的工作流、Git操作、文件系统任务,以及偏好键盘驱动开发的开发者。

Claude Code 是 Anthropic 的官方 CLI 代理。虽然它是为 Claude 模型设计的,但通过环境变量支持自定义模型端点。设置只需2分钟:

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 通过 Novita 配置为 Kimi K2.5
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="YOUR_NOVITA_API_KEY"
export ANTHROPIC_MODEL="moonshotai/kimi-k2.5"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2.5"

# 在项目目录启动会话
cd ~/my-project
claude .

完整设置指南:Novita AI Claude Code 集成

Cursor

最适合: 多文件编辑、感知代码库的上下文、基于GUI的开发,以及希望获得VS Code熟悉度和AI超能力的开发者。

Cursor 是专为AI原生开发构建的 VS Code 分支。集成步骤:

  1. cursor.sh 下载 Cursor
  2. 打开 设置模型
  3. 取消勾选默认模型
  4. 添加自定义模型:
    • 提供商: OpenAI-compatible
    • Base URL: https://api.novita.ai/v3/openai
    • API Key: 你的 Novita API 密钥
    • 模型名称: moonshotai/kimi-k2.5
  5. 使用 Cmd+K(内联编辑)、Cmd+L(聊天)或 Composer(多文件)功能

完整设置指南:Novita AI Cursor 集成

NovitaClaw CLI

先决条件

  • 已安装 Python
  • 一个 Novita API 密钥——获取方法如下:
    • 登录 novita.ai ——使用 Google 或 GitHub 登录(首次登录会自动创建新账户),或使用邮箱注册
    • 创建 API 密钥 ——前往 Key Management 设置页面创建或管理你的 API 密钥。将其复制到方便的地方——下一步会用到。
如何安装 Python

Windows

  1. 下载 Python 安装程序
  2. 运行安装程序——在点击任何其他内容之前勾选“Add Python to PATH”。跳过这一步是初学者后续遇到错误最常见的原因
  3. 点击 Install Now 并等待“Setup was successful”消息
macOS

打开终端(Command + Space,搜索“Terminal”),运行:

python3 --version

如果看到 Python 3.10 或更高版本,即可继续。如果版本较旧,或终端提示你安装 Command Line Developer Tools,点击 Install 并等待几分钟后再继续。

Linux(Ubuntu / Debian)

如果你使用的是基于 Debian 的发行版,运行:

sudo apt update && sudo apt install python3 python3-pip -y
#### 安装与启动

步骤 1:安装 NovitaClaw

macOS / Linux:

sudo pip3 install novitaclaw

Windows PowerShell:

pip install novitaclaw

如果已安装旧版本,请升级到最新版本:

Bash

pip3 install novitaclaw --upgrade

如果升级失败,尝试强制重新安装:

Bash

pip3 install novitaclaw --upgrade --force-reinstall

安装后,通过输入 novitaclaw --help 验证。如果看到说明列表,表示成功!

novitaclaw --help

Mac 用户特别说明

如果安装后遇到 zsh: command not found: novitaclaw 错误,依次运行以下两个命令来修复环境路径:

source ~/.zshrc

echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc

#### 步骤 2:在终端中设置环境变量

macOS / Linux:

export NOVITA_API_KEY=sk_your_api_key

Windows PowerShell:

$env:NOVITA_API_KEY = "sk_your_api_key"

步骤 3:启动实例

novitaclaw launch

成功时,CLI 会返回三个用于访问和管理代理的值:

  • Web UI URL
  • Gateway WebSocket URL & Token
  • Web Terminal URL(用于沙箱的终端访问)
  • File Manager URL(用于浏览和管理工作区文件)
  • 登录凭据(用于 Web Terminal 和 File Manager)

openclaw 截图

打开返回的 Web UI URL,进入 Chat 标签页使用你的代理。使用 Web Terminal URL 在沙箱内打开终端会话,使用 File Manager URL 浏览和管理沙箱工作区中的文件。

完整设置指南:NovitaClaw 集成

访问方式四:本地部署

自托管需要大量基础设施。Kimi K2.5 是一个1万亿参数的混合专家模型,具有320亿活跃参数。

VRAM 需求

基于 Unsloth 的 GGUF 量化数据:

量化级别 文件大小 质量影响
Q2_K 373.8 GB 显著质量损失
Q4_K_M 621.2 GB 中等质量损失,可接受用于测试
Q6_K 842.9 GB 极小质量损失
BF16 2053.2 GB 完整精度

访问方式对比

方式 设置时间 成本 最适合
网页游乐场 30秒 免费(有限制) 快速评估、Agent Swarm 测试、非生产原型
Novita AI API 5分钟 每1M tokens $0.60/$3.00 生产应用、可变工作负载、成本敏感项目
代码工具 10-15分钟 免费 + API 成本 希望 IDE/终端集成实现代理工作流的开发者
本地部署 数天 $5,000-15,000 硬件 + 电费 每月 2B+ tokens 的企业、严格的数据驻留要求

Kimi K2.5 的四条访问路径适用于不同的部署场景。通过网页游乐场探索能力 → 使用 Novita API 构建应用 → 集成代码工具用于开发工作流。仅在你拥有企业级工作负载和严格的数据驻留要求时才自托管。

总结

Kimi K2.5 提供四种灵活的访问路径以适应任何工作流。从网页游乐场开始进行零设置评估,转向 Novita AI API 以获得生产级集成(输入 token 每1M $0.60),接入 Claude Code 或 Cursor 进行 AI 辅助开发,或自托管以实现完全数据控制。对于大多数开发者,API 路径在无需基础设施开销的情况下提供了性能、成本和可靠性的最佳平衡。

关键要点: 使用 Novita AI API 是最快进入生产的路径——兼容 OpenAI 端点,无需管理 GPU,定价有竞争力。立即在 Novita AI 上开始使用 Kimi K2.5

常见问题

Kimi K2.5 API 访问的费用是多少?

Novita AI 收费为 每1M 输入 tokens $0.60,每1M 输出 tokens $3.00——比 Claude Opus 4.5 同等推理任务便宜76%。

Agent Swarm 模式是否通过 API 可用?

不。Agent Swarm(100个代理并行协调)目前仅需 kimi.com 上提供的自定义系统提示词。标准 API 端点提供基础能力;复制 Agent Swarm 行为需要提示工程。

我应该自托管 Kimi K2.5 还是使用 API?

自托管需要大量基础设施。Kimi K2.5 是一个1万亿参数的混合专家模型,具有320亿活跃参数。在最低量化(Q2_K)下,你需要约374GB存储和多个高端 GPU。对于大多数开发者,Novita AI API 访问以每1M 输入 tokens $0.60 的价格提供相同能力,无需管理 GPU 集群。仅在你拥有企业级工作负载和严格的数据驻留要求时才自托管。

Novita AI 是一个 AI 和代理云平台,帮助开发者和初创公司构建、部署和扩展模型及代理应用,具有高性能、高可靠性和成本效益。

推荐阅读