很多人搜索“豆包免费 API”,想要一个长期可用的免费入口。实际上,火山方舟给新用户的是一次性免费推理额度:有范围、有用完即停的机制,并不是可以无限调用的免费版本。把“免费额度”当成“免费模型”,是后续踩坑的主要原因。
说明:豆包、Doubao、火山方舟、Volcano Ark 是字节跳动(ByteDance)及其关联公司的商标。本文仅作技术说明与选型参考,与商标权利人不存在隶属、代理或合作关系。额度、模型与价格会调整,请以火山引擎控制台、官方文档和站内模型价格为准。
一、豆包 API 的“免费”是什么
截至 2026 年 10 月,火山方舟的免费能力主要有两层:
第一层是新用户免费推理额度。注册火山引擎后,部分模型带有一定量的免费调用额度;安心体验模式则面向完成实名认证、且从未开通过模型服务的新账户。官方文档没有给出所有模型的统一数字,额度按模型计算,主账号与子账号共享,基础模型与精调版本也共享同一份。
第二层是安心体验模式。这是账户级开关,官方文档给出的体验额度是 50 万 token。开启后只消耗免费额度,接近用尽时服务自动暂停,不会转成扣费;用尽后通常返回 HTTP 429、SetLimitExceeded。该模式默认关闭,关闭后不能再次开启。
两层额度都不是“永久免费套餐”,更像试用装:足够跑通业务闭环,但不足以支撑长期生产流量。
二、免费额度覆盖什么、不覆盖什么
免费额度只抵扣“按 token 后付费的在线推理费用”,并且包含缓存命中、缓存未命中和输出 token。容易被忽略的是它不覆盖的部分:
| 费用项 | 是否通常由免费额度覆盖 | 采购时要注意 |
|---|---|---|
| 在线推理 token | 是 | 命中、未命中、输出分别计费 |
| 插件与知识库 | 否 | 可能单独计费 |
| 批量推理 | 否 | 批处理有自己的计费口径 |
| 上下文缓存存储 | 否 | 按小时单独计费 |
| 精调训练 | 否 | 训练与推理分开计费 |
| 图像、视频、3D 生成 | 以控制台为准 | 可能按张或按条计费,不按 token |
另外,安心体验模式覆盖大多数模型,但官方文档明确排除了多模态 embedding 和同声传译类模型。做检索增强或多模态应用时,不要默认所有调用都在免费额度里。
三、限流:免费额度不等于免费并发
免费额度解决“花不花钱”,限流解决“能不能稳定调用”。火山方舟按模型设置 RPM、TPM、TPD、IPM 和并发等限制;模型级限制由平台设定,终端级可自行调整,提额通常要工单。轻量模型的默认限流通常更宽松,具体以模型列表和开通管理页为准。
常见错误码有三类:ServerOverloaded 表示资源紧张,RequestBurstTooFast 表示流量爬升过快,SetLimitExceeded 表示免费额度耗尽。三类都是 HTTP 429,但前两类要退避或平滑流量,最后一类只能等额度恢复或转付费。
不要用“立即重试”对抗 429。失败请求也可能消耗额度,越重试越糟。更稳妥的是队列整流、指数退避加随机抖动,并准备降级模型。下面这段脚本记录每次调用的 token 与错误类型,方便一周后判断额度是否够用:
import os, time, json
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ARK_API_KEY"],
base_url=os.environ["ARK_BASE_URL"], # 以官方文档或网关文档为准
)
def call(prompt: str) -> dict:
start = time.time()
try:
resp = client.chat.completions.create(
model=os.environ["ARK_MODEL"],
messages=[{"role": "user", "content": prompt}],
max_tokens=512,
)
usage = resp.usage
return {
"ok": True,
"seconds": round(time.time() - start, 3),
"prompt_tokens": usage.prompt_tokens,
"completion_tokens": usage.completion_tokens,
}
except Exception as exc:
return {
"ok": False,
"seconds": round(time.time() - start, 3),
"error": type(exc).__name__,
"detail": str(exc)[:200],
}
if __name__ == "__main__":
for i in range(5):
print(json.dumps(call("用一句话解释什么是限流"), ensure_ascii=False))
把结果按天汇总,重点看三件事:日均 token、429 占比、单任务平均 token。免费额度够不够,用数据判断,不要凭感觉。
四、数据条款:免费不等于没有约束
免费额度阶段的请求同样经过平台。火山方舟平台专用条款写明:未经客户单独同意,平台不会存储或使用客户数据训练或优化模型;数据可能因合规审查与内容过滤、客户主动发起的故障排查、异常调用告警被处理;平台做聚合统计,但不保留原始客户数据用于统计。
但还有几个点要确认:高安全沙箱是否开启,决定数据是否传递给模型提供方;未开启时适用模型提供方条款。条款没有通用留存期限和删除时限,客户要自己保存日志。专有模型、开源模型、精调、批处理的数据规则也不同。免费试用不能成为跳过合规评审的理由。
五、免费档适合做什么
免费额度最适合“验证”和低风险内部场景:
- 接口联调:确认鉴权、超时、流式输出和错误码。
- 提示词迭代:用真实任务跑几十到几百次,观察稳定性和 token 消耗。
- 模型选型:对比旗舰、轻量、翻译、角色等不同模型的任务表现。
- 内部工具:会议摘要、文档分类、字段抽取等低并发、可人工复核的场景。
反过来,以下场景不适合依赖免费额度:
- 面向客户的生产接口,需要稳定性和责任边界。
- 高并发、长上下文、批量处理,免费额度消耗速度会远超预期。
- 涉及个人信息、合同、代码和财务数据的任务,先过合规评审。
- 需要发票、合同、SLA 或对公付款的企业采购。
六、免费额度的主要风险
第一是额度耗尽没有缓冲:安心体验模式会直接暂停服务,业务可能在没有扣费预警的情况下中断。第二是模型下线与版本更替:模型列表会标注“即将下线”,免费档可用的模型未必是长期主力。第三是限流与突发流量:活动或爬虫流量很容易触发 429。第四是共享 Key:来源不明的 Key 无法追溯责任,也可能违反平台条款。第五是条款与价格变化:免费额度、模型范围和计费方式都可能调整。
七、从免费转付费的步骤
- 用一周真实流量记录 token、429 比例和单任务成本。
- 完成企业实名认证,确认合同主体、付款方式和发票类型。
- 在“开通管理”中激活模型,剩余免费额度仍会优先抵扣。
- 设置模型级和终端级用量上限,避免实验拖垮预算。
- 配置余额、用量和错误率告警。
- 用 5%–10% 生产流量灰度,观察延迟、错误率和账单。
- 准备备用模型或通道,演练一次切换。
- 稳定后扩大流量,按月复核单价、缓存命中率和模型版本。
需要统一多模型入口、人民币账单和发票的团队,可以在中商起航 AI 网关创建测试 Key,把豆包与其它模型放在同一套接口下对比。价格与可用模型以模型价格为准,不要用旧文章里的数字做预算。
常见问题
豆包 API 有长期免费版吗?
没有可以默认长期依赖的免费版。公开的免费能力主要是新用户免费推理额度和安心体验模式,都有资格、范围或额度限制,是否延续以官方页面为准。
50 万 token 是所有模型共享的吗?
官方文档把安心体验模式描述为账户级额度,同时免费推理额度又按模型分别计算,两种口径并不完全一致。实际剩余额度以开通管理页为准,不要按“每个模型各 50 万”做容量规划。
免费额度用完后会自动扣费吗?
安心体验模式下不会,服务会暂停并返回 429;关闭该模式或激活模型后,超出部分才按后付费计费。具体扣费顺序以控制台和账单页为准。
免费额度能用于批量推理吗?
通常不能。免费额度只覆盖在线推理的 token 费用,批量推理、插件、知识库和缓存存储有单独的计费口径。
免费档和付费档是同一个模型吗?
多数情况下是同一批模型端点,但免费档支持的模型范围、限流和功能可能不同。测试时看响应里的实际模型名,并逐项验证长上下文、工具调用和结构化输出。
下一步
先用免费额度把接口和提示词跑通,再用真实流量算出月成本,最后决定直连还是走网关。需要统一账单和多模型对比,可以从注册中商起航 AI 网关开始;模型与价格以模型价格为准。
相关阅读:
豆包、Doubao、火山方舟、Volcano Ark 是字节跳动(ByteDance)及其关联公司的商标。本文仅作技术说明,不构成法律或采购建议。
