跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.ruoli.dev/llms.txt

Use this file to discover all available pages before exploring further.

令牌额度和账户余额是分开的。每个令牌有自己的使用上限，即使账户余额充足，令牌额度用完了也会报错。解决方法：在控制台编辑令牌，增加额度或开启「无限额度」。
你请求的模型不在当前令牌的分组内，或该分组的所有渠道都不可用。解决方法：换一个包含该模型的分组创建新令牌，或换一个模型试试。
  • 想省钱：cn（0.01）
  • 要大上下文：gemini-ant（0.2，1M）、codex-team（0.2，1M）或 claude-ant（0.6，1M）
  • 要官方质量：claude-officially（1.6）或 gemini-officially（1）
详见模型与分组。
  • 检查 API Key 是否正确（注意前后空格）
  • 确认 Key 没有被删除或禁用
  • 确认请求头格式：Authorization: Bearer sk-你的KEY
倍率是价格系数，倍率越低越便宜。例如倍率 0.1 意味着只需官方价格的十分之一。详见模型与分组。
RuoLi 兼容 OpenAI API 格式，支持所有兼容 OpenAI 的工具，包括：
想用 gpt-5.5、GLM、Kimi 等第三方模型，在 CC Switch 的「编辑供应商 → 模型映射」里，把 Claude 别名指向目标模型即可，无需改 JSON。详见 Claude Code 切换模型。
八成是 Claude Code 默认开启的归属 header 在作祟 —— 每次请求携带动态会话 ID，会直接击穿上游 prompt cache。在 CC Switch「编辑供应商 → 配置 JSON」的 env 里加一行：
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
不论用 Claude 官方还是第三方模型都建议关闭。详见 关闭归属 Header。
这通常是因为对话上下文超过了模型的上下文窗口限制。解决方法：
  • 在 Claude Code 中使用 /compact 命令手动压缩上下文
  • 配置自动压缩：在 ~/.claude/settings.json 的 env 中添加 "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"，数值越小越早触发压缩
  • 选择支持更大上下文的分组，如 claude-ant（1M 上下文）或 codex-team（1M 上下文）
详见 Claude Code 配置上下文压缩。
统一地址：https://ruoli.dev/v1不同工具填写方式略有不同，具体请看各工具的配置页面。