吉格api 文档

切换主题

Aider 接入 ​

Aider 通过 OpenAI Compatible 配置连接吉格api。Aider 的模型名称需要使用 openai/ 路由前缀，前缀不是上游模型 ID 的一部分。

配置 ​

1. 安装 ​

Aider 官方建议使用受支持的 Python 版本进行独立安装。常用方式：

bash
python -m pip install aider-install
aider-install

也可以使用 uv 安装：

bash
uv tool install --force --python python3.12 --with pip aider-chat@latest

2. 设置环境变量 ​

macOS / Linux：

bash
export OPENAI_API_BASE="https://chickener.cc.cd/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

Windows PowerShell：

powershell
$env:OPENAI_API_BASE = "https://chickener.cc.cd/v1"
$env:OPENAI_API_KEY = "YOUR_API_KEY"

3. 启动 Aider ​

bash
aider --model openai/YOUR_MODEL_ID

也可以完全通过命令行参数指定：

bash
aider \
  --model openai/YOUR_MODEL_ID \
  --openai-api-base https://chickener.cc.cd/v1 \
  --openai-api-key YOUR_API_KEY

要点 ​

  • 环境变量名是 OPENAI_API_BASE，不是 OPENAI_BASE_URL。
  • 模型参数使用 openai/YOUR_MODEL_ID。openai/ 是 Aider/LiteLLM 的路由前缀。
  • Base URL 填写到 /v1，不要追加具体端点。
  • 也可以使用 Aider 专用变量 AIDER_OPENAI_API_BASE、AIDER_OPENAI_API_KEY 和 AIDER_MODEL。
  • 未知模型可能触发上下文长度或价格元数据警告；不要为了消除警告随意填写其他模型的数据。

常见问题 ​

请求发到了官方 OpenAI 地址 ​

检查是否正确设置了 OPENAI_API_BASE=https://chickener.cc.cd/v1，并确认启动 Aider 的终端能够读取该变量。

提示 Unknown model ​

先确认模型参数包含 openai/ 前缀，并确认 YOUR_MODEL_ID 与模型广场一致。元数据警告不等于接口一定不可用，但上下文和成本显示可能不完整。

出现 404 ​

检查 /v1 是否重复或缺失。环境变量应为 https://chickener.cc.cd/v1，模型参数中不要包含 URL。

安装后依赖冲突 ​

建议使用 Aider 官方安装器、uv tool 或独立虚拟环境。不要在现有项目环境中单独升级 Aider 内部的 LiteLLM 依赖。