免费 Provider 架构 v1

作者：Alaya + Manas | 2026-07-16 | 背景：opencode-go 额度有限（两个 $60/mo 账户）

一、可用免费渠道

渠道	模型	额度	端口	状态
OpenRouter	Hermes 3 405B / Llama 70B / Qwen3 Coder	50次/天免费	外网 API	✅
freellmapi	Gemma 4 26B（自动路由最优）	13-17亿 token/月	:5559	✅
g4f / PollinationsAI	gpt-oss-20B（20B 小模型）	无限制，质量一般	:8930	✅
OmniRoute	聚合 250+ provider（90+ 免费层）	~1.6B token/月免费	:20128	❌ 500错误
硅基流动	Qwen/GLM/DeepSeek	~14元/2000万	外网 API	❌ 未配 key
美团 LongCat	自有模型	5500万/天	外网 API	❌ 限时公测
智谱 GLM	GLM-4-Flash 免费	2000万注册送	外网 API	❌ 未配 key
阿里云百炼	通义千问/DeepSeek/Kimi	每模型100万	外网 API	❌ 未配 key

二、最终 fallback 链

ds4f（opencode-go，有额度时）
  → Hermes 3 405B free（OpenRouter）
    → Llama 3.3 70B free（OpenRouter）
      → Qwen3 Coder free（OpenRouter）
        → freellmapi（Gemma 4 26B，:5559）
          → g4f（20B 小模型，:8930，质量最差但永不枯竭）

三、各 Agent 配置状态

Agent	主模型 fallback	子 agent	状态
Manas (WSL)	✅ 已配	✅ OpenRouter	运行中
Alaya (WSL)	✅ 已配	✅ OpenRouter	运行中
Mano (Windows)	⏳	⏳	缺 gbrain token
Anchor (Windows)	❌	❌	未配

四、配置参考

providers:
  openrouter-free:
    base_url: https://openrouter.ai/api/v1
    api_key: ${OPENROUTER_API_KEY}
    default_model: nousresearch/hermes-3-llama-3.1-405b:free
    api_mode: chat_completions
  freellmapi-free:
    base_url: http://${LOCALIP}:5559/v1
    api_key: <key>
    default_model: auto
    api_mode: chat_completions
 
fallback_providers:
  - provider: custom:openrouter-free
    model: nousresearch/hermes-3-llama-3.1-405b:free
  - provider: custom:freellmapi-free
    model: auto

OPENROUTER_API_KEY 在 agni profile 的 .env（sk-or-…ee4b）。

五、未解决的问题

OmniRoute :20128 启动卡死（v3.8.46），需修复后方可使用
国内免费 API（硅基流动/智谱/阿里）key 未配置，暂不可用

六、参考

ops/token-saving-architecture-v1
research/free-llm-api-china
reading/freellmapi-free-tokens
research/omniroute-ai-gateway
web-learn/2026-07-13-2004-omniroute-ai-gateway
research/plano-fugu-gateway-comparison

2026-10-09 Codex 审阅说明

本页保留 2026-07-16 的渠道、价格和服务快照。聚合宣传的 13–17 亿或 16 亿 token 不是单个账号权益；OmniRoute 是路由层，不会凭空生成上游额度。国内赠送、公测与账户额度须按当次政策和认证确认。g4f 的上游会限流、失效或要求认证，“无限制/永不枯竭”不成立。

截至本次官方文档核对，OpenRouter 免费模型有共享限流与日上限，提升档位依据累计购买 credits，不应写成当前剩余余额；模型列入目录仍需核验路由、认证和实际免费权益。Pollinations 已使用统一 gen.pollinations.ai、API Key 和 Pollen credits，具体免费条件取决于模型与账户，不能沿用旧匿名无限调用承诺。

本机 Hermes 配置源码明确：现代 providers 是映射，legacy custom_providers 是包含 name/base_url 的对象列表；原映射形态的 custom_providers 会被忽略。${VAR} 与 ${env:VAR} 在配置字符串值中递归插值受支持。下列示例只纠正结构，不证明模型 ID、fallback 顺序或端口当前可调用。

核验依据：OpenRouter 官方额度说明；Pollinations 官方说明；本机 Hermes 配置源码；本机 Hermes 环境变量插值源码。

知识库

探索

免费 Provider 架构 v1 — Token 节省方案（全）