免费 API 库 › 百度智能云千帆（文心）

百度智能云千帆（文心）免费额度

新用户额度

新用户双重福利：17 个模型各送 100 万 Tokens（3 个月有效，自动发放）+ 实名送 20 元代金券；实测 v2 接口 ERNIE 5.1 / DeepSeek-V4 均可直调。

🌏 国内直连对话RAG🕐 最后核实 2026-09-09

1免费额度 & 限速（重点）

📦 额度两条线：① 2025-10-24 起新用户首次开通千帆自动发放 17 个模型各 100 万 Tokens、有效期 3 个月、仅限在线推理（剩余量在模型广场对应模型的版本详情页「计费方式=免费额度」处查看）；② 新用户实名认证送 20 元代金券，限抵扣千帆大模型平台公有云费用。9-09 控制台实测：代金券已到账，未点「开通按量后付费」也不影响 v2 接口调用。

⚡ 限速官方未公示

🧠 能力文心 ERNIE 全系（5.1/5.0/X1.1）+ DeepSeek/Qwen/GLM/Kimi 第三方托管共 70+ 模型；OpenAI 兼容（v2 接口）；Token Plan 个人版 ¥9.9-600/月为付费订阅且禁止用于普通 API 调用。

🔁 节奏一次性 —— 新用户额度，用光即止，不会回来

🎁 免费模型清单（5）

官方发放 17 个免费额度模型：ERNIE-4.5-Turbo-128K/32K/VL、ERNIE-X1-Turbo-32K（各 100 万）
DeepSeek-R1 / R1-250528 / V3-250324 / V3.1 / V3.1-Think（各 100 万）
Kimi-K2-Instruct、Qwen3 四款（235B/30B/Coder-30B/Coder-480B，各 100 万）
bge-large-en/zh、qianfan-sug-8k（各 100 万）
另：新人实名送 20 元代金券（限千帆模型平台公有云，约 1 个月有效）

2够用吗？一句话判读

17 个模型各 100 万 Tokens 是国内单平台免费额度最重的之一，覆盖文心/DeepSeek/Kimi/Qwen 主流线；但只覆盖在线推理、3 个月过期，且老版本号在持续下线，真正长期可用的是新旗舰按量 + 代金券兜底。

3不写代码，怎么把它的免费用起来

这一家提供的是 OpenAI 兼容接口——意思是它可以被直接填进现成的聊天工具，不需要你写任何一行代码。选一个你在用的工具，照着下面三步填就行。

我要填进哪个工具共 3 个

4开发者视角：路径、代码、命令行验证默认折叠 —— 如果你不写代码，上面那一节就够了。这里给的是官方 SDK 用法与命令行自检。

🔑 路径console.bce.baidu.com → 登录实名 → 千帆控制台顶部「API Key」→ 创建API Key（bce-v3 格式，OpenAI 兼容 v2 接口直接用）

最小可运行代码

from openai import OpenAI
client = OpenAI(api_key="bce-v3/ALTAK-xxx/yyy", base_url="https://qianfan.baidubce.com/v2")
r = client.chat.completions.create(model="ernie-4.5-turbo-128k", messages=[{"role":"user","content":"你好"}])
print(r.choices[0].message.content)

以上为最小可运行示例（OpenAI 兼容或官方 SDK）。多数客户端会自动补全 /chat/completions，接口地址不要手拼完整路径。

5避坑提醒

⚠️ 上线前必看

免费额度 3 个月有效、仅限在线推理，批量推理不适用
2026-09 实测：deepseek-v3.1-250324 等旧版本号已报 invalid_model，老模型在持续下线，免费额度模型表可能滞后
体验中心 Playground 调用同样消耗 Tokens 按实际费用扣
Token Plan 个人版（¥9.9-600/月）禁止以 API 形式用于自动化脚本/应用后端，违者封 Key
控制台「尚未开通按量后付费」横幅不影响 v2 接口调用，费用后记账

🔍 数据时效说明 免费额度、限速随时会变（本页核实于 2026-09-09）。上线 / 量产前请以官方页面为准。

📄 核实出处 2026-09-09 登录控制台实测：财务中心代金券页确认新人 ¥20 券到账（限千帆公有云、至 2026-10-09）、财务资源包为空；新建 bce-v3 API Key 实调成功 ernie-4.5-turbo-128k / ernie-5.1 / deepseek-v4-flash，deepseek-v3.1-250324 报 invalid_model；官方《新用户免费额度》文档仍在线（更新 2025-11-17，17 模型×100 万口径不变）；Token Plan 页确认为付费订阅；控制台全站扫描无邀请/返佣入口 · 官方页面

6「17 × 100 万」的额度地图，先确认它没骗你

千帆的免费额度是自动发放的：新用户首次开通即得 17 个模型各 100 万 tokens，3 个月有效、仅限在线推理。听起来是国内最豪的一档——但清单本身会滞后。

实测发现清单里的 deepseek-v3.1-250324 调用时报 invalid_model；而 ernie-4.5-turbo-128k、ernie-5.1、deepseek-v4-flash 均实调成功。

结论 「表上有」不等于「还能用」。平台在持续下线老版本号，但免费额度清单的更新往往跟不上。拿到清单后别直接写进项目，先逐个发一条最小请求验活。

怎么验用 v2 兼容接口对清单里的模型名逐个发一条最简请求，把报 invalid_model 的先划掉，剩下的才写进配置。这一步只花几分钟，能省掉后面无数个深夜排查。

7Playground 不是沙盒，它有账单

事实在体验中心（Playground）里点着玩、调参数、试提示词，同样消耗 tokens 并按实际费用扣——它不是沙盒，是真实调用。

连带的一条控制台显示「尚未开通按量后付费」也不影响 v2 接口调用——费用是后记账的。没点开通，不代表不会产生费用。

所以「我就点两下试试」和「我写代码调」在计费上是同一件事。想零成本摸清产品，优先把试错花在已发免费额度的 17 个模型上，别随手去试清单外那些只能按量付费的模型。

8Token Plan 的红线：它是面向人的订阅，不是给程序的额度

它是什么Token Plan 个人版（¥9.9–600 / 月）是面向人机交互的付费订阅，不是给程序用的 API 额度包。

明确禁止官方禁止把它以 API 形式用于自动化脚本 / 应用后端，违者封 Key。

这条要当硬约束写进方案 如果你的架构是「服务端定时调用」或「Agent 自动跑」，Token Plan 这条路是封死的——被判定为自动化调用会直接封 Key，代价远大于省下的那点钱。

边界怎么划程序化调用走「按量付费 + 免费额度」，人用界面才用 Token Plan。选型阶段就把这条定清楚，别等上线了才发现订阅不能给后端用。

9报错对照表

现象	原��	怎么办
报 invalid_model	模型版本号已下线（如 `deepseek-v3.1-250324`），免费清单滞后	换清单里在售的模型；上线前逐个验活
额度掉得比写的代码多	Playground 里试玩同样计费	把试错集中在有免费额度的模型上
没开通按量后付费却产生费用	v2 接口费用后记账，未开通不影响调用	设置预算 / 告警，别默认「没开通 = 不花钱」
批量推理不消耗免费额度	免费额度仅限在线推理	批量任务按量计费；能走在线接口就走在线
用了 Token Plan 却被封 Key	Token Plan 禁止用于 API 自动化调用	程序化调用改用按量付费 + 免费额度
3 个月后额度消失	有效期 3 个月，自动发放且没有第二次	到期前把评测 / 联调跑完

百度智能云千帆（文心） 免费额度