Skip to main content
Aider 通过 OpenAI API 与模型通信，因此它会从您的环境变量中读取 OPENAI_API_BASE 与 OPENAI_API_KEY 的值。请将 OPENAI_API_BASE 设为 https://api.tokios.com/v1，将 OPENAI_API_KEY 设为您的 sk-tok-… 令牌，随后选择以 openai/ 为前缀的模型即可，例如 aider --model openai/gemma-tunnel。

​
前提条件

  • 已启动的 Tokios 连接器以及与之配套的本地模型——详情参见 连接器安装
  • 已注册的模型部署名称——详情参见 注册模型
  • Tokios API 密钥——详情参见 API 密钥管理
  • 已安装 Aider

​
配置 Aider

导出上述两个环境变量后，在运行 Aider 时输入以 openai/ 为前缀的模型名称以及您的部署名称即可。
请将 gemma-tunnel 替换为您在控制台中注册的公开部署名称。
Aider 可能会弹出警告，提示它无法识别该模型名称，也无法确定其上下文窗口大小及相关成本。出现这种情况是因为 gemma-tunnel 并未出现在 Aider 内置的模型元数据列表中；对于任何本地或私有部署而言这都是正常现象，不会造成任何影响。即便如此，Aider 依然能正常向 OPENAI_API_BASE 发送请求。

​
如果遇到运行异常的情况

  • 401 源自 Tokios — 此时 OPENAI_API_KEY 可能缺失、输入有误，或者该 API 密钥已被撤销。请前往 Keys 页面确认该密钥是否处于启用状态。
  • 404 未找到对应部署 — 输入的 openai/ 名称与任何已注册的部署均不匹配。请核对 Models 标签页中显示的准确公开名称。
  • 403 — 该 API 密钥的适用范围并未覆盖该部署对应的模型类型，或者相关账户已被暂停使用。请查看 Keys 页面以确认该密钥适用的模型类型。
  • 503 connector_unavailable / connector_busy — 与该部署关联的连接器处于离线状态，或者已达到其可处理的最大请求并发量。请前往 Connectors 页面确认该连接器是否正常运行且连接正常。

​
您的模型数据绝不会离开本地机器 — 您的端点可在任意位置发挥作用

Aider 仅与 https://api.tokios.com/v1 进行通信。您的模型参数及代码均保存在运行连接器的机器上。默认情况下 Tokios 仅记录使用次数与元数据，不会存储任何提示词或响应内容。若您所在工作区的管理员启用了 请求日志记录，请求内容（响应内容除外）会以加密形式保存 7 天，且仅您本人可在控制台中查看；若您使用的是编码类智能体，这些记录内容还会包含该智能体读取过的文件信息。

兼容的客户端

此处列出了所有受支持客户端的基础 URL 与 API 密钥设置方法。

API 密钥

您可为团队成员及智能体创建、设定适用范围并定期轮换 sk-tok-… 类型的 API 密钥。