文档 · 接入指南

Aider 接 TopxAI：OPENAI_API_BASE 和模型名

2026-10-28

用 OPENAI_API_BASE=https://api.topxai.xyz/v1 和 --model openai/claude-sonnet-5-5 让 aider 走 TopxAI；Claude 线路也可以用 Anthropic 的变量。

Aider 底层是 LiteLLM。TopxAI 的 Chat Completions 用 openai/ 前缀，Claude Messages 用 anthropic/。仍需遵守模型能力和客户端版本限制，见兼容性表。

OpenAI 兼容聊天模型

export OPENAI_API_BASE=https://api.topxai.xyz/v1
export OPENAI_API_KEY=sk-...          # 自动路由的 TopxAI 密钥
aider --model openai/claude-sonnet-5-5

在 openai/ 后填写当前聊天模型 ID，不包括单独的 Jev、图片和视频 API：openai/gpt-6.1-sol、openai/grok-4.7、openai/kimi-k3.1-pro、openai/GLM-5.3-Abliterated。

Anthropic（Claude，带提示缓存）

export ANTHROPIC_API_BASE=https://api.topxai.xyz
export ANTHROPIC_API_KEY=sk-...
aider --model anthropic/claude-sonnet-5-5 --cache-prompts

对于不认识的模型 ID，Aider 可能没有缓存预设。按照 Aider 模型设置文档，在项目根目录的 .aider.model.settings.yml 中添加：

- name: anthropic/claude-sonnet-5-5
  cache_control: true

带 --cache-prompts 启动后，检查启动信息的模型描述是否包含 prompt cache。TopxAI 转发由此产生的缓存断点，缓存读取和写入分别按本次模型、线路的对应价格计费。请查看当前缓存价格和计费算例；不同 Claude 模型的缓存读取折扣并不相同。

模型元数据

Aider 遇到没有上下文窗口和价格数据的模型名会告警。在项目根目录放一个 .aider.model.metadata.json，为 Aider 的估算提供上下文限制和价格：

{
  "openai/claude-sonnet-5-5": {
    "max_input_tokens": 1000000,
    "max_output_tokens": 128000,
    "input_cost_per_token": 0.000001,
    "output_cost_per_token": 0.000005,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

这个元数据条目仅对应完整名称 openai/claude-sonnet-5-5。它只填写模型页的共享池非缓存输入、输出价格，没有配置缓存价格或 anthropic/ 模型条目。Aider 的累计数只是估算，实际扣费以 TopxAI 用量日志为准。

固定下来

同样的值写进 ~/.aider.conf.yml（model: openai/claude-sonnet-5-5、openai-api-base: https://api.topxai.xyz/v1），密钥通过 shell 配置导出。如果把密钥存到 ~/.aider/oai.env 这样的自定义文件，须用 aider --env-file ~/.aider/oai.env 显式加载，这个路径不会自动读取。见 Aider 环境文件规则。

不通时

401：密钥错了，或粘贴时带了空格。402：余额为零。403：这个模型 ID 不在售，或不在这把密钥的线路上。详见常见错误响应。
curl 能通、工具不通：这一页按工具列出常见原因。

模型：claude-sonnet-5-5, gpt-6.1-sol · 模型与价格

Aider 接 TopxAI：OPENAI_API_BASE 和模型名

OpenAI 兼容聊天模型

Anthropic（Claude，带提示缓存）

模型元数据

固定下来

不通时

相关