赛博鸡蛋CYBER·EGG

GUIDE · 火山引擎

火山方舟新用户免费推理额度领取 + 创建 API Key

注册火山引擎账号就能拿到火山方舟的免费推理额度。本文带你查看额度、开启“安心体验模式”避免超额扣费、创建 API Key,并用一条 curl 完成第一次调用。

适用对象
第一次用火山方舟、想零成本试试豆包等模型的个人开发者
预计用时
约 10 分钟
最后核实

准备

  • 一个可以注册火山引擎的手机号或邮箱
  • 电脑上有终端(macOS / Linux 自带,Windows 可用 PowerShell)

步骤

  1. 注册并登录火山引擎账号

    打开 火山引擎注册页 完成注册并登录控制台。

    官方说明:方舟为新用户提供免费推理试用额度,只需注册火山引擎账号即可获得,不需要额外申请。

  2. 在「开通管理」页查看每个模型的免费额度

    进入方舟控制台的 开通管理 页面,这里能实时看到各模型的免费额度和抵扣情况。

    • 免费额度按模型分别计算,同一主账号下(含子账号)共享。
    • 官方文档写明的免费 token 为每个模型 50 万(50w),实际以页面显示为准。
    • 控制台的额度数据有小时级延迟,刚调用完看不到变化是正常的。
  3. (强烈建议)开启「安心体验模式」,用完即停不扣费

    在开通管理页模型列表上方的「安心体验模式」横幅里打开开关;也可以在开通模型时勾选一并开启。

    • 开启后调用只消耗赠送的免费额度,接近用完时服务自动暂停,不会产生额外费用。
    • 只有从没开通过模型服务的账号才能开启;一旦你在开通模型时没选它,入口就会消失。
    • 关闭后无法再次开启,请想清楚再关。
    • 额度用完后接口会返回 HTTP 429(错误码 SetLimitExceeded),这代表免费额度用完了,不是限流。
  4. 创建 API Key

    打开 API Key 管理 页面,点击「创建 API Key」,然后复制并保存好这串 Key。

    • 权限默认可访问当前资源项目下的全部资源,也可以改成「自定义」只放行指定模型,还能加 IP 白名单。
    • 在哪个资源项目里创建的 Key,就只能用于那个项目的资源。
    • 一个主账号最多可创建 50 个 API Key。
  5. 找到要调用的 Model ID

    在方舟的 模型广场 或官方 模型列表 里找到想用的模型,复制它的 Model ID(官方示例里用的是 doubao-seed-2-1-pro-260628)。

    • 用预置推理接入点:直接用 Model ID 调用,不用建接入点,新手选这个就行。
    • 用自定义推理接入点:请求里的 model 要填接入点 ID(Endpoint ID)。
  6. 用 curl 发起第一次调用

    把 Key 设成环境变量 ARK_API_KEY,把下面的 <Model ID> 换成上一步复制的值,在终端运行。看到模型返回的回复,就说明一切就绪。

    方舟的数据面接口地址是 https://ark.cn-beijing.volces.com/api/v3,兼容 OpenAI 的 Chat Completions 格式。

    bash
    export ARK_API_KEY="你的 API Key"
    
    curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $ARK_API_KEY" \
      -d '{
        "model": "<Model ID>",
        "messages": [{"role": "user", "content": "你好!请用一句话介绍一下你自己。"}]
      }'

注意事项

  • 免费额度只抵扣按 token 后付费的在线推理费用;插件(如联网搜索)、知识库等产生的费用不能抵扣,即使开了安心体验模式也一样。
  • 免费额度不能抵扣批量推理的 token,也不能抵扣上下文缓存的存储费用(命中/未命中缓存的 token 和输出 token 可以抵扣)。
  • 基础模型和基于它精调出来的模型共享同一份免费额度。
  • 没开通模型服务时,免费额度用完调用会直接失败;想继续用需要先完成实名认证并在开通管理页开通对应模型(之后按量付费,开通后仍会优先消耗剩余免费额度)。
  • 不想开安心体验模式的话,可以在开通管理页给模型设置「模型用量上限」控制花费;官方建议上限值设得比控制台显示的剩余免费额度更小一些。
  • 不要把 API Key 提交到代码仓库或发给别人,泄露后可能被盗刷。

常见问题

免费额度会过期吗?

官方「免费推理额度」文档没有写统一的有效期,个别模型的活动可能另有规则。以开通管理页显示的额度和说明为准。

为什么开通管理页显示还有额度,但服务已经暂停了?

官方解释:页面上的数值是该模型免费资源包总量,且数据有小时级延迟;安心体验模式下是否用完,以 API 返回信息和模型列表的状态为准。

提示“API Key 无效”怎么办?

检查 Key 是否复制完整、前后有没有多余空格,建议直接从控制台复制粘贴。

相关优惠

查看 火山引擎 的全部福利 →

信息来源

最后核实日期:2026-10-08 · 政策可能随时调整,请以官方页面为准

下一步:把额度用起来

投稿一条优惠

AI 核验

贴上活动页或文档页网址。AI 读取页面、提取额度与截止时间,核验通过即刻上线;机器拿不准的转人工审核,不会被直接丢掉。