集成指南
客户侧只使用 Swarmix API Key。上游 TokenPlan / CodingPlan / TokenHub 的 Key 与 Base URL 由平台后台维护。
通用接入思路
OpenAI-compatible 工具的配置方式是:
1. 找到「自定义模型 / Custom API Endpoint / OpenAI Compatible」选项
2. Base URL 填
3. API Key 填
1. 找到「自定义模型 / Custom API Endpoint / OpenAI Compatible」选项
2. Base URL 填
http://router.swarmixtoken.com/v13. API Key 填
sk-swx-xxxxxxxxxxxx/v1/messages 已支持
Claude Code 使用 Anthropic Messages 协议,Base URL 填
http://router.swarmixtoken.com, Token 填 Swarmix API Key;实际请求会走 POST /v1/messages。 OpenClaw / Hermes 这类 OpenAI-compatible 工具继续使用 http://router.swarmixtoken.com/v1。不要把上游 TokenPlan 地址给客户
阿里 Token Plan、火山 Coding Plan、腾讯 TokenHub 的专用 Base URL 和上游 Key 只配置在 Admin 厂商管理中。客户文档只展示 Swarmix 统一入口,模型是否路由到这些上游由已上架模型的 provider 配置决定。
OpenAI SDK
推荐官方 Python / Node.js SDK — 零改动迁移,只换 base_url
Claude Code
走 Anthropic Messages 协议,Base URL 指向 Swarmix 根地址
OpenClaw
走 OpenAI-compatible 自定义端点,Base URL 使用 Swarmix /v1
Hermes
走自定义 OpenAI-compatible endpoint,使用 Swarmix API Key
没看到你用的工具?
如果你的工具支持「自定义 OpenAI 兼容端点」,通常也能按 OpenAI SDK 方式接入。 这类工具不再单独列入左侧导航;遇到集成问题可以: