全部文档

在 Aider 中使用 6bee.ai

Aider 可以连接任何 OpenAI 兼容接口。设置两个环境变量,模型名前加上 openai/ 前缀即可。

开始之前

  • 已安装 Aider(python -m pip install aider-install && aider-install)。
  • 用已验证的邮箱注册账户,预付费充值后,在控制台的「API 密钥」页创建密钥,并妥善保管。
  • 模型 ID 可以在控制台查看,也可以用 GET https://api.6bee.ai/v1/models 获取。把 <模型 id> 换成其中一个。

设置变量并启动

shell
export OPENAI_API_BASE=https://api.6bee.ai/v1
export OPENAI_API_KEY=<你的密钥>

aider --model openai/<模型 id>
OPENAI_API_BASE
https://api.6bee.ai/v1,带 /v1。
OPENAI_API_KEY
你的 6bee.ai 密钥。
openai/ 前缀
告诉 Aider 走 OpenAI 兼容通道。它不是模型 ID 的一部分,也不会发给接口。

长期生效

把设置写进主目录或仓库里的 .aider.conf.yml:

.aider.conf.yml
openai-api-base: https://api.6bee.ai/v1
model: openai/<模型 id>

密钥继续放在环境变量 OPENAI_API_KEY 里,避免被提交进仓库。

需要知道的

  • Aider 可能提示不认识这个模型的上下文窗口或价格。这个提示可以忽略,实际费用以控制台的使用日志为准。
  • Aider 每一轮都会发送已加入对话的文件。用 /drop 移除不再需要的文件,请求才不会超出上下文窗口。
上下文
输入加输出不超过模型窗口:按模型不同,为 128K 至 1M token。
输出
max_tokens 最高到模型的输出上限:按模型不同,为 16,384 至 131,072。超出时自动降到上限,不会拒绝请求。不传时默认 8,192 至 32,768。

排错

HTTP 401
密钥缺失或不正确。从控制台重新复制,不要带空格或引号。
提示模型不存在
模型 ID 不匹配。用 GET /v1/models 查看可用的 ID,或到控制台核对。
HTTP 429
超出了账户限额(请求频率、输入 token 或并发)。响应头 Retry-After 给出需要等待的秒数。
长会话中出现 HTTP 400
请求已经放不进模型的上下文窗口。压缩或清空对话,或换用窗口更大的模型。
因余额不足被拒绝
每次请求会先预扣「输入 + max_tokens 输出」。充值,或调低 max_tokens。
Aider 要求填 OpenAI 密钥,或请求发到了 api.openai.com
确认 OPENAI_API_BASE 已在同一个 shell 里 export,并且模型名以 openai/ 开头。