豆包 Agent Plan 是火山方舟给 Agent 开发场景准备的订阅套餐——把豆包大模型接进 Claude Code、Cursor 这类 AI 编码/智能体工具,当底层模型用。它不走普通按量 API,而是用专属 Base URL(api/plan 兼容 Anthropic、api/plan/v3 兼容 OpenAI)和专属 API Key。下文先厘清它和普通豆包 API、Coding Plan 的关系,再整理接口地址、套餐档位和接入流程。 先理清:三样东西别混
- 豆包大模型 API(普通按量):开发者直接调豆包模型,Base URL 是 ark.cn-beijing.volces.com/api/v3,Bearer 鉴权,适合写代码调推理接口。
- 豆包 Agent Plan(本文主角):火山方舟的 Agent 订阅套餐,给 Claude Code、Cursor 等工具配专属 Base URL 和 Key,把豆包模型当 Agent 大脑;额度走套餐,不按 token 实时扣费。
- Coding Plan / ArkClaw:偏 AI 编码场景的套餐与云端智能体服务,和 Agent Plan 同源但定位不同,下文末尾一并说明。
注意:豆包网页版(doubao.com)是 C 端聊天,没有 API Key;所有开发者接入都走火山方舟。市面上「豆包 API 中转 / 代购 Key」多为非官方渠道,有密钥复用和数据泄露风险,一律走火山引擎官方。
Agent Plan 接口地址一览
| | |
|---|
| https://ark.cn-beijing.volces.com/api/plan | POST /api/plan/v1/messages |
| https://ark.cn-beijing.volces.com/api/plan/v3 | POST /api/plan/v3/chat/completions |
Agent Plan 用的是专属 API Key——你在 Agent Plan 页面拿到的那把,普通方舟 API Key 在 Agent Plan 里用不了。配置 AI 工具时把 Base URL 指向上面两条之一、模型名填豆包模型(如 doubao-seed-evolving)即可。
套餐档位
Agent Plan 分 Small / Medium / Large 等档位,区别在于可用能力和额度上限:
| |
|---|
| |
| |
| 支持生视频模型(Seedance),适合多媒体 Agent 项目 |
官方文档明确建议做生视频类 Agent 至少买 Large。具体单价和额度以火山方舟控制台当期套餐为准。
获取专属 Key 与开通
- 登录火山方舟控制台 console.volcengine.com/ark,完成个人或企业实名认证(调用任何豆包模型的前提);
- 在 Agent Plan 页面订阅对应套餐(Small / Medium / Large);
- 购买后在 Agent Plan 配置页获取专属 Base URL、专属 API Key 和可用模型列表;
- 需要多模态能力的,在控制台开通豆包搜索、生图(Seedream)、生视频(Seedance)等 Skill,Agent Plan 才能调用它们;
- 把专属 Base URL 和 Key 填进 AI 工具,模型名选 doubao-seed-evolving 之类,即可开始跑 Agent 任务。
接入 AI 工具示例(Claude Code)
把豆包模型接进 Claude Code,本质是改 Anthropic 协议的几个环境变量,指向 Agent Plan 的专属链路:
协议选 Anthropic Messages、Base URL 填 api/plan、认证字段用 ANTHROPIC_AUTH_TOKEN(即专属 Key)、模型名填 doubao-seed-evolving。配完在工具状态栏确认模型名,就能让它去读目录、写代码、跑测试、按真实反馈迭代了。用 OpenAI 协议的工具则把 Base URL 换成 api/plan/v3、用 OpenAI SDK 接入。
普通豆包大模型 API 对照(背景)
如果你只是想写代码调豆包推理,而不是接 Agent 工具,走普通按量 API 即可:
| | |
|---|
| https://ark.cn-beijing.volces.com/api/v3 | https://ark.cn-beijing.volces.com/api/plan(/v3) |
| Authorization: Bearer $ARK_API_KEY | |
| | |
| | 接入 Claude Code / Cursor 等 Agent 工具 |
普通 API 的旗舰模型是豆包 2.1 Pro(doubao-seed-2-1-pro-260628),推理输入 6.00 元 / 百万 tokens、输出 30.00 元 / 百万 tokens;每款模型通常赠送 50 万 token 免费推理额度(30 天有效),按量后付费、无需预付。
配套:Coding Plan 与 ArkClaw
纯 AI 编码场景可以看 Coding Plan:分 Lite(约 1.8 万次请求 / 月)和 Pro(额度约 Lite 的 5 倍)两档,折算后约为普通 API 价格的 1 折,配合云端智能体 ArkClaw 一键用豆包或月之暗面模型。Coding Plan 和 Agent Plan 同源但面向不同工作流,按需选即可。
常见错误与排查
| | |
|---|
| | 必须用 Agent Plan 页面获取的专属 Key |
| | |
| | 在 Agent Plan 模型列表确认可用模型名(如 doubao-seed-evolving) |
| | |
新手常见问题
Q:豆包 Agent Plan 接口地址是什么? A:Anthropic 兼容 https://ark.cn-beijing.volces.com/api/plan,OpenAI 兼容 https://ark.cn-beijing.volces.com/api/plan/v3,配 AI 工具时指向这两条。
Q:Agent Plan 的 Key 能用在普通 API 吗? A:不能,也不能反过来。Agent Plan 必须用页面获取的专属 Key,其他方舟 Key 在 Plan 里用不了。
Q:和普通豆包 API 有什么不同? A:普通 API 是 api/v3 + Bearer 按 token 扣费;Agent Plan 是 api/plan + 专属 Key,走套餐额度,专为接 Agent 工具设计。
Q:要买哪个套餐? A:只做文本 Agent 用 Small/Medium 即可;要做生视频、多模态 Agent 至少买 Large。
Q:能接 Claude Code 吗? A:能。把 ANTHROPIC_BASE_URL 设为 api/plan、模型填 doubao-seed-evolving、Token 填专属 Key 即可。
Q:需要实名吗? A:要。火山方舟任何豆包模型调用前都要完成实名认证。
Q:Coding Plan 和 Agent Plan 选哪个? A:编码为主选 Coding Plan + ArkClaw;要把豆包当通用 Agent 底层模型接第三方工具,选 Agent Plan。
Q:免费额度有吗? A:普通豆包 API 每款模型常送 50 万 token 免费额度(30 天);Agent Plan 是套餐制,看套餐内含额度。
Q:豆包网页版能拿 API 吗? A:不能。doubao.com 是 C 端聊天,没有 Key,开发者接入统一走火山方舟。
豆包 Agent Plan 是火山方舟给 Agent 开发准备的订阅套餐,接口地址就是 api/plan(Anthropic 兼容)和 api/plan/v3(OpenAI 兼容),配一把专属 Key 就能把 doubao-seed-evolving 这类豆包模型接进 Claude Code、Cursor 当 Agent 大脑。分清它和普通豆包 API(api/v3 + Bearer 按量)的区别,选对套餐档位,接 Agent 工具基本就是改几个环境变量和 Key 的事。