渠道概念

Hoshimi 把每个上游服务当作一个渠道（代码和配置中称为 provider，用一个 ID 表示，例如 cline、opencode、agg）。渠道下面挂着一个或多个账号，同一渠道的账号组成账号池，请求在池内轮换。本页说明这些概念和通用的添加方式；各类渠道的细节见本节其他页面。

渠道的种类复制锚点链接

所有渠道与其来源的对照见渠道清单。清单记录的是“有入口”，不代表上游当前一定可用。

名字相近、ID 不同的服务复制锚点链接

同一家公司的不同产品、不同套餐、不同协议使用不同的渠道 ID，凭据不能互换：

• minimax 是 MiniMax Agent 的登录账号；minimax-api、minimax-cn、minimax-chat 是三个按密钥计费的公开 API。
• gemini 是 Gemini Code Assist（Google 账号登录）；google 是 Gemini Developer API（API 密钥）；google-vertex 是 Vertex AI。
• amazon-bedrock（ConverseStream）和 bedrock-mantle（OpenAI 兼容端点）分别配置。
• zhipu 是 bigmodel.cn 的通用 API；zai、zai-coding-cn、zai-api 是 Z.AI 的编码套餐和国际站 API；zcode 是 ZCode 客户端的登录通道。
• cline 是 Cline 的免费登录通道；cline-pass 是 ClinePass 订阅密钥。
• typesafe 提供分类，不是聊天模型。

添加账号复制锚点链接

三种方式写入的是同一个文件：数据目录下的 config.json（用 hoshimi config path 查看位置）。网页界面和 hoshimi login 写入后立即生效；直接编辑文件需要重启服务。

同一站点身份重新登录时，会更新原有账号，而不是再叠加一个。删除账号用账号菜单中的 删除，凭据会同时从 config.json 和运行中的账号池移除。

每个渠道的配置键复制锚点链接

选择模型：路由规则复制锚点链接

客户端在请求的 model 字段中指定模型：

• 写成 渠道/模型（例如 opencode/big-pickle、nvidia/<model-id>）会直接交给该渠道。
• 只写模型 ID 时，网关按固定顺序查找第一个列出该 ID 的渠道：cline、opencode、kilo、gemini、zcode、minimax、trae、qoder、qodercn、buddy、workbuddy、codearts、loomy、raccoon、lobsterai、eac、agg、zhipu、nvidia，然后是其他渠道。
• 只开启了一个渠道时，未知的 ID 也会原样转给它。

GET /v1/models 中每个 ID 只出现一次，owned_by 是按上述顺序胜出的渠道。模型 ID 本身含有 / 时（例如 Kilo 的 openrouter/free），建议加上渠道前缀：kilo/openrouter/free，避免第一段被当成渠道名。客户端配置见接入客户端。

账号池与轮换复制锚点链接

同一渠道的多个账号按配置顺序使用。一次请求遇到账号层面的失败时，网关会换下一个账号重试，每次请求最多尝试 server.max_account_retries 个账号（默认 3）：

• 额度用尽或限流：该账号暂停轮换，时长取上游给出的重置时间，没有则为一小时。
• 凭据被拒：先尝试续期，再换账号。续期令牌本身被拒绝时，账号标记为 需要登录，不再参与轮换，直到重新登录。
• 已经向客户端输出内容后，请求不会自动重放。

这些规则的完整说明见模型行为。

续期与签到复制锚点链接

很多登录型站点的令牌会过期。开启 凭据续期（server.auto_refresh，默认开启）后，网关每 30 分钟检查一次，续期一小时内到期或没有记录到期时间的账号。开启 每日签到（server.auto_checkin，默认开启）后，网关每天按北京时间日期为支持签到的站点领取免费额度。哪些站点支持续期、签到和余额查询，见免费站点。

怎样选择复制锚点链接

• 先试默认开启的匿名入口，不需要任何账号。
• 想要更多免费额度，登录免费站点；多登录几个账号能让轮换更从容。
• 已有某个 OpenAI 兼容服务的密钥：它在原生渠道列表中就用原生渠道（见本地与兼容端点），否则用 agg。
• 企业云账号用云平台对应的渠道；本机模型用 LM Studio、Ollama 或 llama.cpp。