很多人搜索“豆包免费 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 无法追溯责任,也可能违反平台条款。第五是条款与价格变化:免费额度、模型范围和计费方式都可能调整。

七、从免费转付费的步骤

  1. 用一周真实流量记录 token、429 比例和单任务成本。
  2. 完成企业实名认证,确认合同主体、付款方式和发票类型。
  3. 在“开通管理”中激活模型,剩余免费额度仍会优先抵扣。
  4. 设置模型级和终端级用量上限,避免实验拖垮预算。
  5. 配置余额、用量和错误率告警。
  6. 用 5%–10% 生产流量灰度,观察延迟、错误率和账单。
  7. 准备备用模型或通道,演练一次切换。
  8. 稳定后扩大流量,按月复核单价、缓存命中率和模型版本。

需要统一多模型入口、人民币账单和发票的团队,可以在中商起航 AI 网关创建测试 Key,把豆包与其它模型放在同一套接口下对比。价格与可用模型以模型价格为准,不要用旧文章里的数字做预算。

常见问题

豆包 API 有长期免费版吗?

没有可以默认长期依赖的免费版。公开的免费能力主要是新用户免费推理额度和安心体验模式,都有资格、范围或额度限制,是否延续以官方页面为准。

50 万 token 是所有模型共享的吗?

官方文档把安心体验模式描述为账户级额度,同时免费推理额度又按模型分别计算,两种口径并不完全一致。实际剩余额度以开通管理页为准,不要按“每个模型各 50 万”做容量规划。

免费额度用完后会自动扣费吗?

安心体验模式下不会,服务会暂停并返回 429;关闭该模式或激活模型后,超出部分才按后付费计费。具体扣费顺序以控制台和账单页为准。

免费额度能用于批量推理吗?

通常不能。免费额度只覆盖在线推理的 token 费用,批量推理、插件、知识库和缓存存储有单独的计费口径。

免费档和付费档是同一个模型吗?

多数情况下是同一批模型端点,但免费档支持的模型范围、限流和功能可能不同。测试时看响应里的实际模型名,并逐项验证长上下文、工具调用和结构化输出。

下一步

先用免费额度把接口和提示词跑通,再用真实流量算出月成本,最后决定直连还是走网关。需要统一账单和多模型对比,可以从注册中商起航 AI 网关开始;模型与价格以模型价格为准。

相关阅读:


豆包、Doubao、火山方舟、Volcano Ark 是字节跳动(ByteDance)及其关联公司的商标。本文仅作技术说明,不构成法律或采购建议。