聚合入口 agg

agg 是通用的兼容入口：一个渠道下可以放很多站点，每个账号自带站点地址（base_url）和密钥。OpenRouter 的免费池、SiliconFlow、SambaNova 这类服务，只要讲 OpenAI Chat Completions，就是一条配置而不需要新代码。常用的 22 个站点已内置为预设，只填名字和密钥即可。

如果服务在原生渠道列表中（例如 openrouter、groq、deepseek、siliconflow），优先用原生渠道，见本地与兼容端点。Cline、Kilo、Qoder、OpenCode 这类有原生登录和续期的站点不在预设中：用 agg 接它们会把可续期的凭据换成会过期的令牌。

添加账号复制锚点链接

账号字段复制锚点链接

站点预设复制锚点链接

hoshimi stations 列出全部预设（--json 输出 JSON），接口为 GET /api/v1/stations。

• “上游密钥变量”是该站点官方工具读取密钥的环境变量名，仅供参考。Hoshimi 只从 config.json 读取凭据，不会读取这些变量。
• “无密钥可读目录”只表示能浏览模型列表，这些站点的聊天请求仍然需要密钥。
• 预设只提供地址，不含模型列表；模型始终实时读取。

同一渠道下的多个站点复制锚点链接

不同站点的同一个 ID 可能是不同的模型、不同的价格，因此网关记录每个 ID 来自哪个站点：

• 请求某个 ID 时，先尝试在 models 中声明了它的账号，再尝试没有声明 models 的账号，最后才是其余账号。
• 只有一个站点时不需要任何声明。站点多了以后，用 models 把 ID 固定到对应账号，可以避免请求先落到不认识该 ID 的站点上。
• 站点的规则（聊天模型筛选、免费标记、能力表）按 base_url 地址识别，而不是按 preset 名字：写着 preset: sambanova 却把 base_url 指向别处的账号，不会套用 SambaNova 的规则。自定义地址不套用任何站点规则。

能力声明复制锚点链接

站点的 /models 通常只有 ID。没有声明时，agg 把模型当作不支持图片、不思考的普通模型，调用方的请求原样转发。需要时在 options 中声明：

{
  "providers": {
    "agg": {
      "accounts": [
        {
          "id": "siliconflow",
          "base_url": "https://api.siliconflow.cn/v1",
          "api_key": "<SiliconFlow key>",
          "options": {
            "model_specs": {
              "Qwen/Qwen3-8B": {"reasoning": true, "context_window": 131072},
              "example/thinking-model": {
                "reasoning": true,
                "efforts": ["disabled", "low", "high"],
                "effort_default": "high",
                "effort_patch": {"reasoning_effort": "$effort"},
                "effort_off_patch": {"reasoning_effort": "none"}
              }
            }
          }
        }
      ]
    }
  }
}

优先级：账号声明高于站点自己目录中的信息，站点信息高于默认值；平铺在 options 中的键作为默认值，model_specs 中该 ID 的值最后生效。平铺键会作用于整个渠道的所有 ID，渠道下有多个站点时，请把声明写在 model_specs 中。没有声明的 ID，只从 models.dev 补充“是否思考、是否接受图片”两项，不借用其他站点的上下文长度。也可以把同样的键写在 providers.agg.options 中作为整个渠道的默认值。能力与思考级别的完整规则见模型行为。

免费标记复制锚点链接

GET /v1/models 中每个模型的 free 字段有三种值：true、false、null（站点没有说明）。agg 只采信站点自己公布的信息：

• 从目录行读取：anyapi、gmi、opengateway、orcarouter、tokenrouter、xkiro、bai（ID 带 :free）、merge（某条线路输入输出价格都为 0）。
• 从站点定价页记录的固定 ID：agnes、bai、commandcode。
• venice 和 llm7 故意不标记：Venice 的 0 价模型仍要求账号有正余额，LLM7 的标价是公开报价而非账号余额。

免费标记只说明站点的价目，不保证账号有额度或一定能调用。

站点特有的处理复制锚点链接

• 聊天模型筛选：已知站点的目录会去掉图像、视频、嵌入、语音转写等非聊天模型，筛选规则按站点分别实现；目录字段缺失时保留该行，避免站点改版后目录变空。LLM7 按自己的 model_type 字段筛选。
• CommandCode：claude- 开头的模型改走 Anthropic Messages（<base_url>/messages）；站点的视觉和思考能力表作为默认值，账号声明优先。
• 请求格式：已知站点的请求把 max_completion_tokens 改为 max_tokens、developer 消息改为 system；自定义地址的请求不做这些改写。上游即使对流式请求返回完整的 JSON 文档也能正确读取。

这些规则大多移植自 pi-free，差异见从 pi-free 迁移。