---
title: "Aider 接入 OpenAI 兼容 API（不限量 DeepSeek） | BroadRouter"
description: "通过 Aider 的 OpenAI 兼容设置把这款编程智能体接到 BroadNet Inference，在固定价格、不限量的 DeepSeek V4.1 Flash 套餐上运行。"
url: https://broadrouter.com/zh/guides/aider-unlimited-deepseek/
lang: zh-Hans
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。[阅读英文原文](https://broadrouter.com/guides/aider-unlimited-deepseek/)（2026-11-16 更新）。

# 用不限量的 DeepSeek V4.1 Flash 运行 Aider

更新于 2026-11-16

Aider 可以连接任何 OpenAI 兼容 API。把 OPENAI\_API\_BASE 设为 https://inference.broadnet.ai/v1，OPENAI\_API\_KEY 设为你的 BroadNet 密钥，然后运行 aider --model openai/broadnet/deepseek-v4.1-flash。openai/ 前缀让 Aider 走 OpenAI 兼容路由。使用不限量套餐密钥时，DeepSeek V4.1 Flash 的 token 不计量，长时间的代码库会话也保持固定价格。

编程智能体每一轮都会重新发送代码库的大部分内容，所以按 token 计费的账单涨得很快。[不限量套餐会话](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)去掉了这个计量。下面的步骤参照 [Aider 的 OpenAI 兼容配置说明](https://aider.chat/docs/llms/openai-compat.html)。

## 1\. 安装 Aider

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

## 2\. 指向 BroadNet Inference

```bash
export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY='your-broadnet-plan-key'
```

在 Windows 上，使用 `setx OPENAI_API_BASE https://inference.broadnet.ai/v1` 和 `setx OPENAI_API_KEY your-key`，然后打开一个新终端。Aider 的文档要求在 `setx` 之后重启 shell。

base URL 末尾的 `/v1` 要保留。chat completions 路径由 Aider 自己加上。

## 3\. 在你的代码库上启动

```bash
cd /path/to/your/project
aider --model openai/broadnet/deepseek-v4.1-flash
```

`openai/` 前缀告诉 Aider 使用 OpenAI 兼容端点；后面的部分是 BroadNet 的模型 ID。Aider 会提示：“Unknown context window size and costs, using sane defaults.”（译文：上下文窗口大小和费用未知，使用合理的默认值。）对于不在其内置列表中的模型，这是正常现象。它的[模型警告页面](https://aider.chat/docs/llms/warnings.html)说这个警告通常可以忽略。

## 4\. 可选：把模型信息告诉 Aider

想去掉警告并给模型留出思考空间，就在你的主目录或代码库根目录下添加两个文件。Aider 会从这两个位置中的任意一个读取它们，详见它的[高级模型设置文档](https://aider.chat/docs/config/adv-model-settings.html)。

`.aider.model.metadata.json`：

```json
{
  "openai/broadnet/deepseek-v4.1-flash": {
    "max_input_tokens": 1048576,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}
```

`.aider.model.settings.yml`：

```yaml
- name: openai/broadnet/deepseek-v4.1-flash
  edit_format: diff
  extra_params:
    max_tokens: 16000
```

对于未知模型，Aider 默认的编辑格式是 `whole`，会重新发送整个文件。`diff` 只发送改动的代码块。如果编辑应用失败，删掉 `edit_format` 这一行，回到 `whole`。

## 使用建议

-   **一个 Aider 窗口对应一个会话。** 如果同时运行两个 Aider 实例，请购买两个会话，否则它们会互相排队。
-   **思考也消耗 token。** DeepSeek V4.1 Flash 在回答前会先思考，BroadNet 把这部分计入 `max_tokens`。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **先试一小时。** Meteor 套餐一小时 $1，足够用一个真实任务来判断效果。

## 故障排查

-   **401 Unauthorized。** `OPENAI_API_KEY` 缺失、错误或已过期。检查运行 Aider 的 shell 里是否有这个变量；在 Windows 上，`setx` 之后要打开新终端。
-   **请求发到了 OpenAI 而不是 BroadNet。** 当前 shell 没有设置 `OPENAI_API_BASE`，或者模型名缺少 `openai/` 前缀。运行 `echo $OPENAI_API_BASE` 检查。
-   **找不到模型。** `openai/` 后面的部分必须与 `broadnet/deepseek-v4.1-flash` 完全一致。套餐密钥只覆盖 DeepSeek V4.1 Flash；其他 BroadNet 模型需要按量付费密钥。
-   **回复为空或被截断。** 按上文所示，在 `.aider.model.settings.yml` 中调高 `max_tokens`。
-   **编辑没有生效。** 把 `edit_format` 改回 `whole`，或在命令行加上 `--edit-format whole`。
-   **回复慢或出现 429。** 一个套餐会话同一时间只处理一个请求；第二个 Aider 窗口会排队。按量付费密钥每分钟允许 30 个请求，同时最多 4 个。参见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。

更喜欢在 VS Code 里用智能体？请看 [Cline 配置指南](https://broadrouter.com/zh/guides/cline-openai-compatible/)，或者阅读 [Cline、Roo Code 与 Aider 对比](https://broadrouter.com/zh/blog/cline-vs-roo-code-vs-aider/)。

[在 BroadNet Inference 选择套餐](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-aider-unlimited-deepseek&utm_content=body)

## 本指南涉及的术语

[按量付费（pay-as-you-go）](https://broadrouter.com/zh/glossary/pay-as-you-go/)

按量付费是一种计价模式：你只为实际用量付费，按 token、请求次数或音频分钟等单位计量，没有订阅费，也没有最低消费承诺。大多数大模型 API 都这样计费，从预付余额中扣减或定期开具账单。

[上下文窗口（context window）](https://broadrouter.com/zh/glossary/context-window/)

上下文窗口是语言模型在单次请求中能处理的最大 token 数。它涵盖提示词、对话历史、工具定义、图片以及生成的输出（包括思考 token）。放不下的内容必须删减、摘要，或拆分到多个请求中。

[AI 智能体（AI agent）](https://broadrouter.com/zh/glossary/agent/)

AI 智能体是由语言模型自主决定步骤、朝目标推进的系统：它决定调用哪些工具、读取结果，然后重复，直到给出最终回答或触及上限。在固定位置调用模型的固定脚本，通常称为工作流（workflow）。

[Base URL（base\_url）](https://broadrouter.com/zh/glossary/base-url/)

base URL 是 API 固定的根地址，例如 https://api.example.com/v1，客户端会把它加在每个端点路径（例如 /chat/completions）前面。在 OpenAI 兼容 SDK 中，修改 base URL，再配合 API 密钥和模型 ID，就能让同一份代码改用另一家服务商。

[Token（词元）](https://broadrouter.com/zh/glossary/token/)

token（词元）是大语言模型读写文本的基本单位：由模型的分词器切分出的一个词、词的一部分、一个标点或一段字节序列。大模型 API 按 token 计数、设定限制，通常也按 token 计费。

[并发（concurrency）](https://broadrouter.com/zh/glossary/concurrency/)

并发（concurrency）是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发，与每分钟请求数分开计算，因为每个未完成的请求在响应结束前都会占用 GPU 资源。

[大模型包月套餐（flat-rate LLM plan）](https://broadrouter.com/zh/glossary/flat-rate-llm-plan/)

大模型包月套餐（固定价格套餐）是按一个周期（如一个月）收取固定费用、提供大模型 API 使用权的计价方式，不按 token 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

[速率限制（rate limit）](https://broadrouter.com/zh/glossary/rate-limit/)

速率限制是 API 对客户端在一个时间窗口内的使用量设定的上限，例如每分钟请求数或每分钟 token 数。超出限制的请求会被拒绝，通常返回 HTTP 429 Too Many Requests，直到用量回落到限制以下。

## 常见问题

### Aider 怎么接入 OpenAI 兼容 API？

把 OPENAI\_API\_BASE 设为服务商的 base URL，OPENAI\_API\_KEY 设为它的密钥，然后用 --model openai/ 加上服务商的模型 ID 启动 aider。对 BroadNet 来说就是 openai/broadnet/deepseek-v4.1-flash，base URL 为 https://inference.broadnet.ai/v1。

### Aider 为什么提示 "Unknown context window size and costs"？

Aider 没有内置 BroadNet 模型 ID 的元数据，所以默认上下文不限、费用为零。Aider 的文档说这个警告通常可以忽略。想去掉它，就把模型写进 .aider.model.metadata.json。

### 模型 ID 已经以 broadnet/ 开头，还需要加 openai/ 前缀吗？

需要。Aider 把第一段当作提供商路由。openai/ 把请求发往 OPENAI\_API\_BASE，而 broadnet/deepseek-v4.1-flash 是 BroadNet 收到的模型 ID。

### Aider 调用 DeepSeek V4.1 Flash 为什么回复为空或被截断？

模型在回答之前会先思考，而 BroadNet 把思考内容计入 max\_tokens。请在 .aider.model.settings.yml 里通过 extra\_params 调高 max\_tokens。

## 相关指南

-   [面向智能体的不限量 LLM API 套餐如何运作](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)
-   [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
-   [在 Cline 中使用 BroadNet Inference（OpenAI Compatible 提供商）](https://broadrouter.com/zh/guides/cline-openai-compatible/)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)
-   [所有可与 BroadNet Inference 配合使用的工具（英文）](https://broadrouter.com/integrations/)：SDK、编程智能体、聊天界面和自动化工具，并附每个工具的具体设置

用你的真实业务负载试一试。新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-aider-unlimited-deepseek&utm_content=page-cta) ·

**来源**

-   [Aider 文档：OpenAI 兼容 API（核对于 2026-11-14）](https://aider.chat/docs/llms/openai-compat.html)
-   [Aider 文档：模型警告（核对于 2026-11-14）](https://aider.chat/docs/llms/warnings.html)
-   [Aider 文档：高级模型设置（核对于 2026-11-14）](https://aider.chat/docs/config/adv-model-settings.html)
-   [BroadNet Inference API 参考文档（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-aider-unlimited-deepseek&utm_content=sources)
-   [BroadNet Inference 不限量套餐（英文）](https://inference.broadnet.ai/plans?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-aider-unlimited-deepseek&utm_content=sources)
