在 Hermes Agent 中使用
Hermes Agent 是 Nous Research 开源的自我改进型 AI Agent，内置学习闭环，支持终端、Telegram、Discord 等多种入口。本文介绍如何在 Hermes Agent 中接入 Kimi Code 会员，使用 Kimi 提供的模型推理能力。
准备工作
开始前，请完成以下准备工作。安装和账号相关操作请按照对应的官方指引完成，本文不再展开。
第一步：设置 API Key
Hermes 通过环境变量 KIMI_API_KEY 读取会员 Key，在当前终端设置：
export KIMI_API_KEY="sk-kimi-你的会员Key"该设置仅对当前终端会话有效。要长期生效，把同一行追加到 shell 配置文件（如 ~/.zshrc），或写入 ~/.hermes/.env（Hermes 启动时自动加载该文件）。
第二步：写入完整配置
配置前先确认当前会员档位可用的模型和上下文上限，详见 会员权益。使用超出权限的模型和上下文会触发报错：
| 会员档位 | 可用模型 | 上下文窗口 |
|---|---|---|
| Go（新套餐） | 无 coding 额度 | — |
| Andante（老套餐） | kimi-for-coding | 1048576 |
| Plus / Moderato | k3.1-prok3k3-256kkimi-for-coding | k3.1-pro：262144k3：262144k3-256k：262144kimi-for-coding：1048576 |
| Pro 及以上 / Allegretto 及以上 | k3.1-prok3.1-pro-highspeedk3k3-256kkimi-for-codingkimi-for-coding-highspeed | k3.1-pro：1048576k3.1-pro-highspeed：1048576k3：1048576k3-256k：262144kimi-for-coding：1048576kimi-for-coding-highspeed：262144 |
K3.1 Pro 系列模型全新上线
K3.1 Pro 现已全量上线 Kimi Code，是我们迄今能力最强的三万亿级参数模型，支持 100 万上下文，在代码、3D 创作、金融研究和其他长程 Agent 能力上的提升尤为显著。
我们还同步推出了 Kimi K3.1 Pro Highspeed，在相同的模型效果下，其速度是 K3.1 Pro 的约 2–3 倍，具有更快的交互响应。
注意：K3.1 Pro 系列仅支持思考模式，关闭思考的请求会被拒绝，同时推荐新建会话并使用 Kimi Coding Plan 原生接口协议，以获得最佳效果稳定性，代理协议转换可能引起效果波动。
运行：
hermes config edit
hermes config edit只是用默认终端编辑器打开~/.hermes/config.yaml。不习惯 nano/vim 的话，也可以直接用 VS Code 等任意编辑器打开这个文件修改，效果相同。
打开后把下面的完整配置合并进去：model 和 agent 段通常已存在，只修改所示字段（model 段可整体替换）；custom_providers 和 auxiliary 段一般不存在，直接追加到文件末尾。文件中已有的其他自定义 Provider 保持原样。
custom_providers:
- name: kimi-coding-plan
base_url: https://api.kimi.com/coding/v1
key_env: KIMI_API_KEY
api_mode: chat_completions
model: k3.1-pro
extra_body:
reasoning_effort: high
models:
k3.1-pro:
context_length: 262144
supports_vision: true
model:
provider: custom:kimi-coding-plan
default: k3.1-pro
context_length: 262144
supports_vision: true
agent:
reasoning_effort: high
auxiliary:
vision:
provider: main
model: k3.1-pro
extra_body:
reasoning_effort: high编辑完成后保存退出（nano 按 Ctrl+O 回车保存、Ctrl+X 退出；vim 输入 :wq；VS Code 直接保存即可）。
代码块中几个关键字段的说明：
reasoning_effort：思考程度，这里显式设为high，取值与实际档位的映射见下表context_length和supports_vision：启用 256K 上下文和原生图片理解；auxiliary区域让图片分析复用同一个主 Providerkey_env：引用第一步设置的KIMI_API_KEY，Key 不需要写进配置文件base_url：只填到/coding/v1，Hermes 会自动追加/chat/completions，不要把完整请求地址写进去
reasoning_effort 传入值 | 实际 effort |
|---|---|
| 未设置（默认） | high（K3.1 Pro 系列默认）/ high（K3 系列默认）/ max（K2.8 Preview 默认） |
low | low |
high | high |
max | max |
K3.1 Pro 系列仅支持思考模式，关闭思考会返回 400；K3 系列、K2.8 Preview 与 K2.7 Code HighSpeed 关闭 thinking 后，请求均由 K2.8 Preview（无思考）处理。
使用其他模型
上面的配置默认使用 k3.1-pro。如需 1M 上下文的 K3.1 Pro 或 K3.1 Pro Highspeed（Allegretto / Pro 及以上档位可用），把配置中的模型 ID 全部替换为对应 ID，并将两处 context_length 改为 1048576；Moderato / Plus 档位使用 K3.1 Pro 时上下文上限为 256K，无需修改。如需 k3-256k，同样替换全部模型 ID 即可，两处 context_length 保持 262144。
第三步：启用视频分析（可选）
Hermes Agent 内置官方视频分析工具，启用一次即可：
hermes tools enable video启用后，Hermes 可以调用官方 video_analyze 工具。对于本地视频，该工具会读取完整文件，编码为 data:video/...;base64,...，再以 video_url 内容块发送给模型，不会先在本地使用 FFmpeg 抽帧。
之后在对话中提供视频的绝对路径，并明确要求调用 video_analyze，无需使用 /video 命令：
调用 video_analyze 分析 /绝对路径/demo.mp4，概括视频内容，并列出三个能从画面确认的细节。支持 MP4、WebM、MOV、AVI、MKV、MPEG 等常见格式，Base64 编码后的视频载荷上限约 50 MB——这是 Hermes 客户端视频工具的硬编码上限，不是 Kimi API 的限制，较大的视频请先裁剪或压缩。也可以直接提供可公开访问的 HTTP/HTTPS 视频 URL。
视频分析依赖模型的多模态能力，
k3-256k不支持视频输入。如果第二步配置的是k3-256k，分析视频前请先把默认模型切换为k3。
第四步：使用图片（可选）
在对话中使用本地图片的绝对路径：
/image /图片的绝对路径/example.png也可以把图片复制到剪贴板后输入 /paste，再输入问题。图片会作为原生视觉内容发送给第二步配置的模型。
第五步：启动并验证
配置完成后启动新会话，让供应商和模型配置生效：
hermes启动后确认底部状态栏显示的模型名和上下文窗口符合预期（例如 k3.1-pro + 256K），然后发送一个简单请求验证连通性。
常见问题
返回 401 或 Key 被拒绝
确认第一步设置的 KIMI_API_KEY 是在 Kimi Code 控制台 创建的 sk-kimi- 会员 Key，且会员档位支持所选模型（见第二步的档位表）。如果之前运行过 hermes model 配置向导，检查 ~/.hermes/.env 中是否残留旧的 Key，如有残留请删除或更新后重试。
返回 403 错误
触发了额度或频率限制。请留意每 5 小时的滚动频率窗口；老会员的订阅额度每 7 天刷新（新会员已取消每周额度限制），等窗口重置后自动恢复；额度使用情况可在 Kimi Code 控制台 查看。具体报错文案与处理方式见错误参考。
视频工具没有被调用
确认已执行 hermes tools enable video，并在提问中明确要求调用 video_analyze，且本地视频使用绝对路径。编码后的负载需小于约 50 MB。