新手使用指南

3 分钟接入全球大模型 · 兼容 OpenAI API

1拿密钥

登录控制台 → API 密钥 → 添加令牌 → 复制
密钥格式 sk-xxxx，仅创建时可见，务必当场保存，关闭弹窗后无法再次查看（丢失只能重新创建）。

2记住这三个值

Base URLhttps://heronx.io/v1
接口路径/v1/chat/completions
鉴权Authorization: Bearer 你的密钥

3在 Hermes 中使用

Hermes 桌面客户端 → 设置 → 模型 / Provider → 添加自定义提供商
填入上面的 Base URL 和 API Key，再填一个「模型名称」（从下方模型清单里复制，如 claude-opus-4-8）。保存后即可在对话框里选中该模型使用。需要多个模型，重复添加模型名称即可。

4代码接入（可选）

换掉 OpenAI SDK 的两行配置即可
python from openai import OpenAI client = OpenAI( api_key="sk-你的令牌", base_url="https://heronx.io/v1", ) resp = client.chat.completions.create( model="claude-opus-4-8", messages=[{"role": "user", "content": "你好"}], ) print(resp.choices[0].message.content)

5不知道选哪个？看这张表

需求推荐模型
最强推理、长跑 Agentclaude-fable-5
生产级编码主力claude-opus-4-8
高并发、要性价比claude-sonnet-5
智能体任务旗舰gpt-5.6-sol
日常对话、量大gpt-5.6-luna
中文长文档、超长上下文kimi-k3
中文任务、1M 上下文qwen3.7-max
代码 + 极致低价deepseek-v4-pro

6常见问题

提示 401 / 密钥无效？
检查密钥是否带 sk- 前缀、Base URL 是否为 https://heronx.io/v1（注意结尾无多余斜杠）。
提示 model not found？
模型名要用「模型清单」里的调用名（如 claude-opus-4-8），不是展示名，区分大小写与连字符。
响应很慢 / 超时？
长上下文与高思考预算档位耗时更久，建议开启 stream: true 流式输出，体感会好很多。
额度不够了？
按量付费：控制台「额度 / 用量」实时查看余额和消费明细，随时充值。需要固定包月请联系管理员开通。