它在做什么

fallback 的意思很简单: 先走主模型;若主路失败,再按预先排好的备用顺序继续试。 这样 403、429、5xx 或临时抽风,不至于把整次任务直接打断。

这几个键分别管什么

  • default_headers:给需要额外请求头的提供商补公共头,例如 User-Agent
  • fallback_providers:主模型失手后,按顺序接手的备用 provider / model
  • auxiliary.vision:把 vision 这类辅助请求单独指去更合适的模型,不和主 coding 路混在一起

一个够用的例子

model:
  default: kimi-k2.5
  provider: kimi-coding
  base_url: https://api.kimi.com/coding/v1

default_headers:
  User-Agent: "claude-code/1.0"

fallback_providers:
  - provider: openrouter
    model: google/gemini-3-flash-preview
  - provider: openai-codex
    model: gpt-5.2-codex
  - provider: copilot
    model: gpt-5.2-codex

auxiliary:
  vision:
    provider: openrouter
    model: google/gemini-3-flash-preview

实际上怎么接手

主模型先跑;若这一跳报错,Hermes 就继续试下一项 fallback。 而 auxiliary.vision 这类辅助任务,会走它自己的那条路,不必继续撞主模型的限制面。

所以这套配置的意义,不是“更花”,而是把三条路拆开:

  1. 主路负责日常编码
  2. 备路负责救场
  3. vision 负责非文本辅助请求

参考