Dyad 的最佳 API 要么是 OpenRouter——唯一内置预设的独立多供应商网关——要么是通过 Settings → AI Providers → Add Custom Provider 添加的任何其他 OpenAI 兼容端点。这是 Dyad 维护者在某个网关请求被添加为预设时指向的路径；他在该 issue中表示，自定义供应商已经能够覆盖这一需求，在没有大量用户需求的情况下无需添加预设。 但最影响账单的决定并不是端点，而是方案边界：在 Dyad Free 中，无论使用谁的密钥，Agent mode 每个 23 小时窗口最多 20 条消息，而 Build、Ask 和 Plan 模式不设上限；两种 Pro 模式完全无法通过客户密钥访问。
首先需要澄清一点，因为搜索结果确实将两者混在一起。本文讨论的是 Dyad Tech, Inc. 在 dyad.sh 提供的本地开源 AI 应用构建器 Dyad——一款 Electron 桌面应用，其仓库为 dyad-sh/dyad。它不是 JuliaHub 的 Dyad，后者是一款 AI 辅助的基于物理的建模产品，其独立定价页面列出了每月 $20 的“Light AI”方案。它也不是 Roborock 的“Dyad Pro”吸尘器或 DYAD 代币。下面的所有数据都来自 dyad.sh、Dyad 仓库或 Kunavo 的实时目录。
该项目仍在活跃开发中，并未归档或改名：核查于 2026 年 9 月 19 日时，GitHub API报告了 archived: false，最近一次推送日期为 2026 年 9 月 18 日。最新稳定版本是 v1.15.0（2026 年 9 月 11 日），最新预发布版本是 v1.16.0-beta.1（2026 年 9 月 16 日）。
Dyad 定价：该软件的费用
三个方案均发布在 dyad.sh/pricing，并于 2026 年 9 月 19 日读取。该页面任何位置都没有显示年度价格。
| 套餐 | 公布价格 | 包含内容 | 哪些费用仍需单独支付 |
|---|---|---|---|
| Dyad Free | $0 | “本地开源 AI 应用构建器”、“无需注册”、“自带 API 密钥”、社区支持 | 每个 token 都计入你自己的供应商账户 |
| Dyad Pro | 每月 $20 | 每月 200 个 AI credits、独有的 Pro 模式、完整的 Dyad Academy 访问权限 | 超出 credits 套餐的任何用量；未公布充值价格 |
| Dyad Max | 每月 $79 | 每月 900 个 AI credits、优先办公时间、“随时充值 credits（价格不变）” | 相同——充值费率本身需要登录后才能查看 |
方案表无法告诉你两件事，任何诚实的页面都不应假装能够说明。Dyad 从未公布一个 credit 的美元价值。其常见问题以循环方式定义了一个 credit——“A credit corresponds directly to the cost of sending a message to an AI model”——而 Pro 文档只说明 Dyad 会为每个模型保留内部的每 token 成本。用宣传的套餐金额除以 credits 数量，Pro 得出每个 credit $0.10，Max 得出约 $0.088，即每个 credit 便宜约 12%；但这只是对套餐的算术计算，并非公布的费率，而且仍无法告诉你一次构建轮次会消耗多少 credits。任何“每条消息需要 N 个 credits”形式的说法都无法验证。
订阅前还有三项条款值得阅读。只要订阅持续付费，积分就恰好结转一个月。退款政策（最后更新于 2025 年 8 月 18 日）称，Dyad“如果您已用完所有 AI 积分，就无法提供全额退款，因为 Dyad 已经为这些使用量向 AI 提供商付款”——已使用的积分是沉没成本，这一点不同于预付 token 余额。平台支持范围也并不完全如定价页面所述：该页面宣传“可下载用于 macOS 和 Windows”，而常见问题补充说明“Dyad 提供实验性 Linux 支持”，但“目前尚未在 Linux 上进行测试，可能存在缺陷”，并且 Linux 不会自动更新。两个页面都来自 dyad.sh；应以常见问题为准。
Dyad 还承诺免费应用将持续免费：“The Dyad core product isn't going anywhere; it is—and will always remain—a free, local, open-source AI app builder.” 关于许可证，应阅读仓库中的 LICENSE 和 README，而不是元数据：src/pro 之外的代码采用 Apache-2.0，src/pro 内的代码依据 Functional Source License 1.1 采用 fair-source 许可，而 package.json 声明为 MIT，与前两者均相矛盾。
自带密钥可以访问什么，以及无法访问什么
这是真正的成本边界，而且它不在价格表上。
| 能力 | Dyad Free 搭配您自己的密钥 | Dyad Pro 积分 |
|---|---|---|
| Build、Ask 和 Plan 模式 | 不限量——“Build 模式对所有用户都没有使用限制”涵盖 Build；源代码中的免费配额限制仅在 Agent 模式下触发 | 不限量 |
| Agent 模式 | 每个 23 小时窗口最多 20 条消息 | 消耗 Pro 积分 |
| Smart Context | 使用任何客户密钥都无法使用 | 已包含，默认开启 |
| Turbo Edits | 使用任何客户密钥都无法使用 | 已包含，默认开启 |
| “Auto (balanced)”和“Free (Daily)”选择项 | 依托 Dyad 自有的托管提供商，因此需要 Dyad Pro 密钥 | 可用 |
| 通过 Ollama 或 LM Studio 使用本地模型 | 可用，不收取单次请求费用 | 可用 |
| 您的密钥会经过哪里 | “您的 API 密钥会直接连接到 AI 提供商，不会经过我们的服务器” | 请求由 Dyad 提供服务 |
Pro 模式的上限在 Dyad 的 价格常见问题 中被明确说明：“不可以，Smart Context 等 Pro 模式只能使用 Dyad Pro 的 AI 积分，不能使用您自己的 API 密钥”，因为它们“需要服务器端处理，并使用多个协同工作的 AI 模型”。一共有两个：Turbo Edits 宣称“代码生成速度最高提升 50%，尤其适用于大型文件”和“成本最高降低至原来的 1/2，可节省您的 AI 积分”；Smart Context 则会“自动将代码库中最相关的文件纳入聊天上下文”。这两项声明都没有公布方法论，Super Value路由所谓“以 20% 的成本进行 Build”也没有。请引用这些说法；不要据此进行预算。
Agent 限额是大多数文章都会弄错的数字。它是20：v1.12.0 发布说明称“免费用户现在每天最多可以发送 20 条 Basic Agent 消息，从 10 条提高到 20 条”，v1.13.0 发布说明再次确认了这一点；实际发布的源代码以FREE_AGENT_QUOTA_LIMIT = 20规定消息限额，并将时间窗口QUOTA_WINDOW_MS设为 23 小时——这是固定窗口，而不是滚动的一天。中止或失败的 Agent 流所占用的配额会退还。Dyad 自己在 2026 年 2 月 4 日发布的博客文章仍称“每日 5 条消息的配额（每月 150 条消息）”，该说法已经过时。
另一个边界只有在源代码中才能看到。当 Dyad Pro 关闭且没有 Pro 密钥时，自定义提供商就是普通的直接客户端，请求的任何内容都不会到达 Dyad。当 Dyad Pro 开启且已配置 Pro 密钥时，Dyad 仍会将您的自定义提供商流量直接发送到您的端点，但会对其进行封装，使令牌数量报告给自己的引擎——代码注释写道：“引擎负责账户支出。” Dyad 是否会对所报告的使用量收取费率，以及费率是多少，属于服务器端信息，且没有公开，因此本页面不会给出具体费率。如果您希望网关账单是唯一的账单，请关闭 Dyad Pro。
Dyad 一轮操作的令牌实际流向何处
自v1.13.0起，Build 模式就是一个 Agent 式循环，Dyad 也移除了针对该模式按路径手动配置上下文的功能。这很方便，但也让令牌决策不再由您掌控：每个生成、编辑和自调试步骤都会重新发送由应用选择的工作集。输出令牌也比通常更重要，因为编辑组件意味着输出代码，而不是 prose。
自定义模型表单中的两个字段控制其余设置，而且都很容易留空。Dyad 的文档只提醒道：“如果留空，Dyad 将使用默认值，而默认值可能小于最佳值”；源代码则给出了具体信息。默认上下文窗口为128,000 个令牌；在保持上下文压缩开启（发布版本默认开启）的情况下，Dyad 会在每个提供商的上限与contextWindow − 25,000两者中较小的值处压缩对话。自定义提供商存储在custom:: ID 下，因此不会采用 Google 或 OpenAI 的上限，而是采用250,000令牌的上限。
下面的算术值得计算一次。将 Context Window 留空后，Dyad 会在103,000个令牌处进行压缩。对于像 Claude Opus 5 这样长上下文模型，在其中输入实际窗口为1,000,000个令牌时，它会改为在250,000处压缩——采用的是上限，而不是模型自身的限制。压缩是对对话进行摘要的过程，因此越早压缩，就意味着要为更多次压缩付费，并且在两次压缩之间损失更多细节。请从模型目录中获取这两个数字，不要猜测。Max Output Tokens 也从同一页面设置。
向 Dyad 添加 OpenAI 兼容端点
Settings → AI Providers → Add Custom Provider。发布版本的对话框有四个字段，其中一个字段在文档中没有提及。
| 字段 | 应填写的内容 | 重要原因 |
|---|---|---|
| Provider ID | 不含空格的简短 slug | “用于内部使用，之后无法更改”；存储时带有 custom:: 前缀 |
| Display Name | 在选择器中显示为您想要的任何名称 | 仅用于显示 |
| API Base URL | https://api.kunavo.com/v1 | 原样传递——Dyad 不会追加任何内容，而且对话框自身的占位符以 /v1 结尾。留空后，Dyad 会抛出“missing the API Base URL” |
| Environment Variable (optional) | 例如 KUNAVO_API_KEY | 文档页面未作说明。源代码会先读取已存储的密钥，只有在设置中未保存密钥时才会回退到此变量 |
然后打开新的提供商，滚动到 Add Custom Model，并填写 Model ID、Name、Description、Max Output Tokens 和 Context Window。Model ID 必须与目录 slug 完全匹配——Dyad 文档称其“必须与提供商 API 文档中指定的内容完全匹配。这是发送到 API 的标识符”——因此应填写claude-opus-5，而不是显示名称。请参阅聊天端点参考获取 ID，并参阅快速入门获取第一个密钥。
有一个协议边界决定这是否完全可行。Dyad 将自定义提供商构建为 OpenAI chat-completions 客户端——源代码注释原文是“暂时假设自定义提供商兼容 OpenAI”——并不存在 Anthropic 形态的自定义提供商类型。其内置 Anthropic 提供商构造时不接受 base-URL 参数，因此不存在 ANTHROPIC_BASE_URL 风格的覆盖；其内置 OpenAI 提供商使用 Responses API，同样没有 base URL。因此，请通过 chat-completions 接口而不是 Messages 协议路由 Claude 模型；OpenAI-compatible API涵盖这种接口形态，而base-URL 页面解释了为什么另一条路径无法从这里访问。
Kunavo 尚未对 Dyad 与其端点的运行时集成进行测试，也没有发布 Dyad 集成指南。上述步骤来自 Dyad 的文档和发布版本源代码，而不是来自实际运行观察。具体仍有三点未经测试：对于给定模型，Agent 模式的工具调用是否能通过此调度运行；流式使用量是否会被报告回来（Dyad 构造客户端时包含了 usage）；以及每个模型如何处理该循环。保留一条可用路由，运行一个范围受限的功能，并查看您的账户记录的费用。Pi pricing为另一个客户端记录了相同的手动配置模式。
Dyad API 成本估算示例
这些是用于说明的令牌算术，不是实测任务成本，也不是账单上限。假设一次 Agent 式操作发送120,000个未缓存输入令牌并接收8,000个输出令牌，且一次工作会话运行20轮这样的操作。这三个数字只是用于说明的假设；您的应用规模以及 Dyad 压缩上下文的频率都会改变它们。费率是Kunavo 目录中每百万令牌的实时价格，不包含缓存读取或写入。
| 模型 | 每 1M 个令牌的输入 / 输出 | 每轮估算 | 每20轮会话估算 |
|---|---|---|---|
| Claude Haiku 4.5 | $0.70 / $3.50 | $0.112 | $2.24 |
| GPT-5.6 Terra | $0.70 / $4.20 | $0.118 | $2.35 |
| Claude Sonnet 4.6 | $2.10 / $10.50 | $0.336 | $6.72 |
| Claude Opus 5 | $3.50 / $17.50 | $0.560 | $11.20 |
请关注价格区间，而不是只看赢家。在这些假设下，会话估算从 $2.24（使用 Claude Haiku 4.5）到 $11.20（使用 Claude Opus 5）——差距确实存在，但也足够小，以至于某个模型在相同功能上多进行一次处理就可能抹平差距。Claude Sonnet 5以与Claude Opus 5相同的$1.40 / $7.00列出，因此这两者之间的选择取决于能力，而不是费率。
同一估算中还应纳入两个 Kunavo 方面的注意事项。目录金额是计费下限，而不是上限：上游报告费用时，账单取目录成本与上游成本乘以适用加价两者中的较高者——请参阅计费。此外，最低充值额为$10的预付余额，这是开通有资金账户所需的现金，不是任务费用或订阅费用。缓存价格单独计算，详见缓存。Dyad Pro 订阅无法诚实地放入此表，因为积分到令牌的费率尚未公布。
哪条路径胜出，以及何时胜出
| 方式 | 适用场景 | 你放弃的内容 |
|---|---|---|
| Dyad Free + 自定义 OpenAI 兼容提供商 | 您会按任务切换模型，希望使用一个密钥和一个预付余额，并且主要在 Build 模式下工作 | 完全需要 Pro 模式以及 20 条消息的 Agent 窗口；您手动输入模型元数据 |
| Dyad Free + 直接供应商密钥 | 某一家供应商的旗舰模型可以覆盖全部需求，而您希望使用其自身的缓存和账户条款 | Dyad 侧限制不变；第二家供应商意味着第二个账户和第二个密钥 |
| Dyad Pro 或 Max 积分 | 您希望使用 Smart Context 和 Turbo Edits，并且更倾向于固定的月度支出，而不是按量计费 | 价格透明度——积分到令牌的费率未公布——以及已用积分可全部退款 |
| 已关联的 ChatGPT 订阅 | 您已经为其中一项付费，并希望获得超出单靠积分所能提供的更大余量 | 处于测试阶段：仅在 2026 年 9 月 16 日发布的 v1.16.0-beta.1 中提供，且 Agent 模式会在此基础上额外收取编排费 |
| 通过 Ollama 或 LM Studio 使用本地模型 | 无需支付单次请求费用的小型、私密或一次性工作 | 多步骤 Agent 式循环中的能力；Dyad 自己的文档警告，较小的模型可能难以遵循其指令 |
订阅这一行确实是新增内容，而且很容易忽略。v1.16.0-beta.1 发布说明称 Dyad“允许您使用 ChatGPT 订阅进行构建，包括免费用户”，建议使用 ChatGPT Plus 或 Pro 来运行顶级模型，并说明在 Agent 模式下，“Dyad 会根据令牌总使用量收取少量编排费”，最高为“每百万令牌 1.5 个积分”，较小模型则为 0.3 个积分。其“最高 5 倍使用量”这一说法没有公布方法论。截至 2026 年 9 月 19 日，该功能尚未进入稳定版本——在据此规划前请重新确认。也请在源头重新核实 OpenAI 自己的订阅价格；该页面上的价格是 Dyad 引用第三方的信息。
最后，关于模型选择：请将 Dyad 自己的建议视为过时内容。其优化指南仍以“截至 2025 年 5 月 13 日”开头，其积分最大化页面仍基于 2025 年模型进行分析，而 Pro 页面宣传的是 2026 年产品阵容——两者相差约一年。该指南还为某个 Google 模型引用了具体的免费层每日请求额度；Google 的当前速率限制页面已不再公布该数字，并称限制“可在 Google AI Studio 中查看”，因此无法从公开页面确认，本页面也不重复该数字。当您自己的免费层密钥开始返回速率限制错误时，Dyad 的故障排除页面诚实地列出了可选方案：等待限制恢复、升级到付费 API 密钥、切换到其他 AI 提供商、使用手动上下文管理，或升级到 Dyad Pro。有关能力与成本的候选比较，请参阅编码模型比较；有关测量方法，请参阅AI 成本优化。
如果独立网关是您想要的路径，请注意 Dyad 仅将其中一个作为预设提供。其内置列表包括 OpenAI、Anthropic、Google Gemini、Vertex、OpenRouter、Dyad 自己的托管选项、Azure、xAI、Bedrock 和 MiniMax，以及本地 Ollama 和 LM Studio——因此，OpenRouter 是唯一以一等入口形式提供的独立多供应商网关，其他选项则通过上面的自定义提供商表单接入。这是设置上的差异，而不是费率差异；请从价格和资金条款两方面比较二者。OpenRouter 替代方案和最佳 LLM 网关涵盖了这项比较，最便宜的 Claude API涵盖了大多数应用构建者最终选择的模型家族。准备为实际功能定价时，请创建 Kunavo 账户，并针对您入选的模型运行一次范围受限的构建。
常见问题
Dyad 的费用是多少？
Dyad 桌面应用本身是免费的。dyad.sh 定价页面列出 Dyad Free 为 $0，Dyad Pro 为每月 $20、包含 200 个 AI 积分，Dyad Max 为每月 $79、包含 900 个 AI 积分（核查于 2026 年 9 月 19 日）；页面未公布年度价格。仓库中 src/pro 目录之外的所有内容均采用 Apache-2.0，src/pro 内的代码则依据 Functional Source License 1.1 采用 fair-source 许可。因此，在免费方案下，你唯一需要支付的是所配置供应商密钥产生的模型 API 账单；如果通过 Ollama 或 LM Studio 运行本地模型，则每次请求无需支付费用。请注意，仓库的 package.json 声明为 MIT，这与其 LICENSE 文件和 README 均相矛盾——应阅读 LICENSE 文件。另有一款 JuliaHub 的 Dyad 物理建模软件，它有独立的定价页面；其任何数据都不适用于这里。
Dyad 的最佳 API 是什么？
Dyad 内置的供应商列表包括 OpenAI、Anthropic、Google Gemini、Vertex、OpenRouter、Dyad 自己的托管选项、Azure、xAI、Bedrock 和 MiniMax，以及本地 Ollama 和 LM Studio。其中，OpenRouter 是唯一独立的多供应商网关——Azure、Vertex 和 Bedrock 是模型供应商自己的云服务——其他所有独立网关都需要通过 Settings → AI Providers → Add Custom Provider 添加。Dyad 维护者曾回复将另一个网关添加为预设的请求，明确指向该页面，并表示除非有大量用户需求，否则无需添加预设（GitHub issue 1389，2025 年 10 月 3 日，仍处于开放状态）。那么哪个端点最好，取决于你的工作方式。当你全天使用某一家供应商的旗舰模型，并希望使用其缓存和批处理条款时，直接供应商密钥更合适。当你按任务切换模型，并希望使用一个密钥和一笔预付余额时，Kunavo 这类自定义 OpenAI 兼容供应商更合适。当你需要 Smart Context 和 Turbo Edits 时，Dyad Pro 自己的积分更合适，因为这两种模式完全无法通过任何客户密钥访问。小规模或私密工作适合使用本地模型。有一项硬性限制会缩小选择范围：Dyad 将自定义供应商构建为 OpenAI chat-completions 客户端，而其内置 Anthropic 供应商不接受基础 URL 覆盖，因此你自己的 Anthropic Messages 协议端点无法从 Dyad 访问；内置供应商只能访问 Anthropic 自己的端点，无法访问其他端点。
Dyad 的最便宜 API 是什么？
列出的最低费率和完成应用的最低成本是两个不同的问题，在代理式构建器中，两者的差异尤其大：在同一个组件上需要三次尝试的较弱模型，成本可能高于一次就能完成任务的较强模型。Dyad 还有两项不体现在按 token 计费的费率中的特定成本。在免费方案中，无论使用谁的密钥，Agent mode 在每个 23 小时窗口内都限制为 20 条消息，因此繁重的代理式工作受 Dyad 限制，而不是受余额限制；Build、Ask 和 Plan 模式不设上限。此外，如果添加自定义模型时将 Context Window 字段留空，Dyad 会假定上下文窗口为 128,000 个 token，并且远早于你的模型实际需要压缩对话时就开始压缩，这意味着会对同一项工作进行更多轮总结。先按费率筛选，再让两个候选模型各完成同一个范围明确的功能，然后查看供应商账户实际记录的用量和费用。
Dyad 的最佳模型是什么？
Dyad 没有发布当前答案，而在遵循其文档之前，了解这一点很重要。其模型优化指南仍停留在“As of May 13, 2025”，并列出 2025 年的免费选项；与此同时，其 Pro 营销页面宣传 GPT 5.5 和 Claude Opus 4.8——建议与模型阵容大约相差一年，因此不应将该指南视为当前信息。应改为根据三个属性进行选择。第一是工具调用可靠性，因为自 v1.13.0 起，Build mode 就是代理式循环，因此错误处理工具调用的模型可能会在其中停滞或反复运行。第二是上下文窗口，因为你需要自行将其输入自定义模型表单，Dyad 会根据该数字管理压缩。第三是完整费率卡，因为构建器每轮都会重新发送大量工作集，并输出代码而不是散文——按照本页面表格中的假设，重新发送的输入仍占较大部分，因此不要只依据输出费率筛选。实际使用中，这意味着用强大的编码模型进行脚手架搭建和重构，用更便宜的模型进行小幅编辑，并在模型选择器中按任务切换。
我可以使用 Smart Context 或 Turbo Edits 配合自己的 API 密钥吗？
不可以。Dyad 的定价常见问题直接说明：“No, Pro modes like Smart Context can only be used with Dyad Pro's AI credits, not with your own API keys.” 它给出的原因是，这些模式需要服务器端处理以及多个模型协同工作，这将意味着通过 Dyad 的服务器路由你的密钥。同一回答还补充了一点，对于自带密钥的设置值得注意：“In Dyad Free, your API keys connect directly to AI providers without passing through our servers.” Pro 模式恰好有两种，即 Smart Context 和 Turbo Edits；Dyad 文档说明两者默认都为 Pro 会员启用。因此，网关密钥可以让你使用这些模型以及没有上限的 Build、Ask 和 Plan 模式，但无法使用 Pro 的上下文和编辑功能。
Dyad 每天提供多少条免费 Agent 消息？
20 条，而且仍有一些文章写成 5 条。v1.12.0 发行说明称：“免费用户现在每天最多可以发送 20 条 Basic Agent 消息，比之前的 10 条有所增加”，v1.13.0 说明再次写明 20 条；实际发布的源代码将 FREE_AGENT_QUOTA_LIMIT 设置为 20，配额窗口为 23 小时，而不是滚动的一天。Dyad 自己于 2026 年 2 月 4 日发布的博客文章“Agent Mode Explained in Dyad”仍写着“每日配额为 5 条消息（每月 150 条消息）”，该信息已经过时。源代码还会在代理流中止或失败时退还配额。Build mode 对任何用户都没有使用上限，因此限制具体针对 Agent mode，而不是构建功能。
这是与 JuliaHub 的 Dyad 相同的 Dyad 吗？
不是，而且这种混淆代价很高，因为两者都发布了每月 $20 的方案。本文讨论的是 Dyad Tech, Inc. 在 dyad.sh 提供的本地开源 AI 应用构建器 Dyad，它是一款 Electron 桌面应用，仓库为 dyad-sh/dyad；截至 2026 年 9 月 19 日，其最新稳定版本为 v1.15.0。JuliaHub 的 Dyad 是一种基于物理的建模语言和代理式建模产品，目前版本为 3.0，拥有完全独立的定价页面。Roborock 也销售一款名为“Dyad Pro”的干湿吸尘器，此外还有一种名为 DYAD 的加密货币。如果你找到的“Dyad”价格不是来自 dyad.sh，请先确认它属于哪个产品，再据此制定预算。
Dyad 的价格、Pro、文档、发布说明和博客页面，其 GitHub 仓库元数据与发布记录，以及其在 main 上发布版本的源代码（免费 Agent 配额常量、令牌和压缩工具、模型客户端构造、自定义提供商对话框、提供商表和使用量报告）均于 2026 年 9 月 19 日查阅。Kunavo 费率以及上表中的所有美元金额均来自实时目录，属于说明性令牌算术，而非实测任务成本。尚未进行 Dyad 到 Kunavo 的运行时测试。