集成 · Hermes
Hermes 通过自定义 OpenAI-compatible endpoint 接入 Swarmix,底层上游由平台路由。
选择 Custom / OpenAI-compatible endpoint
Hermes 支持把模型 provider 配成自定义 OpenAI-compatible Base URL。接入 Swarmix 时, Base URL 填 Swarmix 的
/v1 地址,API Key 填 Swarmix API Key。配置值
text
API Key sk-swx-xxxxxxxxxxxxxxxxxxxx
Base URL http://router.swarmixtoken.com/v1
Model 使用 GET /v1/models 返回的已上架模型 ID
API mode OpenAI-compatible / chat completions环境变量风格
如果你的 Hermes 版本支持从环境变量读取 OpenAI-compatible endpoint,可使用:
bash
export OPENAI_API_KEY="sk-swx-xxxxxxxxxxxxxxxxxxxx"
export OPENAI_BASE_URL="http://router.swarmixtoken.com/v1"与 TokenPlan 的关系
Hermes 客户端仍然走 POST /v1/chat/completions。当模型后台 provider 指向aliyun_token_plan_openai、volc_coding_openai 或tencent_tokenhub_openai 时,Swarmix 会用平台侧托管的上游专用 Key 转发。
不要使用上游专用 Key
客户不要填写阿里 Token Plan、火山 Coding Plan 或腾讯 TokenHub 的专用 Key。 这些 Key 只在 Admin 厂商管理的上游密钥池中维护,客户侧统一使用
sk-swx-...。