指南目录(34 篇)
火山引擎
火山方舟免费额度教程:开启安心体验模式、领 50 万 Tokens 与调通豆包 API
注册火山引擎账号即可获得火山方舟每模型 50 万 Tokens 的免费推理额度。调用前先在「开通管理」打开安心体验模式,额度用完自动暂停,不会产生超额账单。
- 适用对象
- 第一次用火山方舟、想零成本调用豆包等模型 API 的个人开发者
- 预计用时
- 约 10 分钟
- 更新时间
准备
- 一个手机号或邮箱(注册火山引擎账号)
- 电脑终端(macOS / Linux 终端或 Windows PowerShell)
步骤
开启「安心体验模式」防超额扣费
在开通管理页列表顶部的横幅里打开 安心体验模式(也可以在首次勾选模型时一并打开):
- 开启后只消耗赠送的免费推理额度,接近耗尽时自动暂停该模型服务并返回 HTTP
429(错误码SetLimitExceeded),不会扣款; - 这个模式只对从未正式开通过模型服务的新账号显示,如果在开通模型时跳过了它,入口就会消失;
- 手动关闭后无法再次开启,只打算用免费额度测试时保持开启即可。
- 开启后只消耗赠送的免费推理额度,接近耗尽时自动暂停该模型服务并返回 HTTP
创建 API Key
打开 API Key 管理 点击「创建 API Key」,复制生成的密钥。密钥归属于创建时所在的资源项目(默认可访问该项目下的全部模型,也可按需限制指定模型或加 IP 白名单)。
用 curl 完成首次调用并接入工具
方舟在线推理兼容 OpenAI Chat Completions 格式,基础地址为
https://ark.cn-beijing.volces.com/api/v3(注意路径末尾是/v3)。把下面的密钥和<Model ID>换成自己的值运行,收到正常 JSON 回复后即可填入 WorkBuddy、Cline、OpenCode 或 Cherry Studio: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);联网搜索等插件、知识库、批量推理(Batch)及上下文缓存存储费不在抵扣范围内,开了安心体验模式也会单独计费。
- 基础模型与基于它精调出的模型共用同一份 50 万额度。
- 免费额度用完后如需继续调用,完成实名认证再去开通管理页正式开通对应模型即可;若未开启安心体验模式,也可在开通管理页给单个模型设置「模型用量上限」(建议设得略低于剩余免费额度,留出统计延迟余量)。
常见问题
开通管理页显示还有剩余额度,为什么接口已经报 SetLimitExceeded 停掉了?
控制台显示的余量有小时级统计延迟,而且安心体验模式会在额度临近耗尽时提前暂停服务以防超支,实际可用状态看接口实时返回。
填进第三方客户端时 Base URL 要加 /chat/completions 吗?
大多数 OpenAI 兼容工具(如 Cherry Studio、Cline、OpenCode)只填基础地址 https://ark.cn-beijing.volces.com/api/v3,客户端会自动补齐 /chat/completions;若使用 WorkBuddy 的 models.json 或打开了「完整 URL」开关,才填完整路径。
相关优惠
参考链接
- 火山方舟 免费推理额度docs.volcengine.com/docs/ark/free-inference-quota
- 火山方舟 安心体验模式细则docs.volcengine.com/docs/ark/free-tokens-only-mode
- 火山方舟 管理 API Keydocs.volcengine.com/docs/ark/manage-api-keys
- 火山方舟 Base URL 及鉴权docs.volcengine.com/docs/ark/base-url-and-authentication