要在国内合规地接一个大模型做应用，百度千帆是很多团队的首选。不想先付钱？本教程帮你从零注册、领免费额度、发出第一个文心 API 调用。
准备清单：一个百度账号（没有就注册一个）；能收验证码的手机；想试的中文任务（问答、摘要、文案都行）。
步骤一：进入千帆平台并登录。打开百度智能云千帆大模型平台，用百度账号授权登录，进入控制台。首次进来会有新手指引，跟着点完即可。
步骤二：认领新用户额度。新账号通常在"账号/资源包"或活动页能领到一笔免费体验额度，以官网当期活动为准，不同时间节点的新用户礼包会有差异，有的还限特定模型可用。领完后到"额度"里确认余额。
步骤三：创建 API Key。在"应用接入"或"密钥管理"里新建一个应用，拿到 API Key 和 Secret Key（有的模型用 Access Token 鉴权）。下面用最简方式发一个调用（以鉴权后拿到的 token 为例）：
curl https://qianfan.baidubce.com/v2/chat/completions \
-H "Authorization: Bearer 你的ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model":"ernie-4.0-8k","messages":[{"role":"user","content":"写一句适合朋友圈的咖啡馆文案"}]}'
把 token 换成你鉴权后的值。常见报错：401 多为鉴权过期，重新获取 token；429 多为免费额度用尽，等重置或升配。
步骤四：验证调用成功。返回里能看到生成文案，回到控制台确认额度扣减，说明链路通了。想先零成本感受模型成色，也可以直接用 文心一言 对话。
说个真实例子。做内部知识库的小团队，用免费额度把"员工问答"跑通再决定付费，避免了上来就买服务器和推理服务的冤枉钱。领额度前先确认登录的是公司常用百度账号，别让额度落在私人号上。
验收标准：你收到了文心返回的文本，且额度面板有扣减。
进阶方向：把文心接进 Dify 零代码搭工作流；做代码场景可顺带看 文心快码。入口与活动见 文心一言工具页，新用户优惠以官网当期页面为准。
还有个实用建议：千帆的免费额度有时限定特定模型可用，领的时候看清楚"适用模型"那一栏。如果只想要文心对话能力，先用 文心一言 网页版零成本体验成色，确认模型合适再走 API 接入，能少走弯路。很多人一上来就啃 API 文档，结果卡在鉴权上耗了半天，其实先对话感受一下再动手更高效。