GUIDE · 火山引擎
火山方舟新用户免费推理额度领取 + 创建 API Key
注册火山引擎账号就能拿到火山方舟的免费推理额度。本文带你查看额度、开启“安心体验模式”避免超额扣费、创建 API Key,并用一条 curl 完成第一次调用。
- 适用对象
- 第一次用火山方舟、想零成本试试豆包等模型的个人开发者
- 预计用时
- 约 10 分钟
- 最后核实
准备
- 一个可以注册火山引擎的手机号或邮箱
- 电脑上有终端(macOS / Linux 自带,Windows 可用 PowerShell)
步骤
注册并登录火山引擎账号
打开 火山引擎注册页 完成注册并登录控制台。
官方说明:方舟为新用户提供免费推理试用额度,只需注册火山引擎账号即可获得,不需要额外申请。
在「开通管理」页查看每个模型的免费额度
进入方舟控制台的 开通管理 页面,这里能实时看到各模型的免费额度和抵扣情况。
- 免费额度按模型分别计算,同一主账号下(含子账号)共享。
- 官方文档写明的免费 token 为每个模型 50 万(50w),实际以页面显示为准。
- 控制台的额度数据有小时级延迟,刚调用完看不到变化是正常的。
(强烈建议)开启「安心体验模式」,用完即停不扣费
在开通管理页模型列表上方的「安心体验模式」横幅里打开开关;也可以在开通模型时勾选一并开启。
- 开启后调用只消耗赠送的免费额度,接近用完时服务自动暂停,不会产生额外费用。
- 只有从没开通过模型服务的账号才能开启;一旦你在开通模型时没选它,入口就会消失。
- 关闭后无法再次开启,请想清楚再关。
- 额度用完后接口会返回 HTTP 429(错误码
SetLimitExceeded),这代表免费额度用完了,不是限流。
创建 API Key
打开 API Key 管理 页面,点击「创建 API Key」,然后复制并保存好这串 Key。
- 权限默认可访问当前资源项目下的全部资源,也可以改成「自定义」只放行指定模型,还能加 IP 白名单。
- 在哪个资源项目里创建的 Key,就只能用于那个项目的资源。
- 一个主账号最多可创建 50 个 API Key。
用 curl 发起第一次调用
把 Key 设成环境变量
ARK_API_KEY,把下面的<Model ID>换成上一步复制的值,在终端运行。看到模型返回的回复,就说明一切就绪。方舟的数据面接口地址是
https://ark.cn-beijing.volces.com/api/v3,兼容 OpenAI 的 Chat Completions 格式。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 是否复制完整、前后有没有多余空格,建议直接从控制台复制粘贴。
相关优惠
信息来源
- 火山方舟 · 免费推理额度docs.volcengine.com/docs/ark/free-inference-quota
- 火山方舟 · 开通管理docs.volcengine.com/docs/ark/activation-management
- 火山方舟 · 安心体验模式细则说明docs.volcengine.com/docs/ark/free-tokens-only-mode
- 火山方舟 · 管理 API Keydocs.volcengine.com/docs/ark/manage-api-keys
- 火山方舟 · 快速入门(新手版)docs.volcengine.com/docs/ark/quick-start-beginner
- 火山方舟 · 在线推理(常规)docs.volcengine.com/docs/ark/online-inference-standard
- 火山方舟 · Base URL 及鉴权docs.volcengine.com/docs/ark/base-url-and-authentication
最后核实日期:2026-10-08 · 政策可能随时调整,请以官方页面为准