零成本部署！手把手教你用百度千帆调用顶尖开源模型

想用 DeepSeek-R1、Qwen3 等顶尖开源模型，但不想自己买显卡？百度千帆 ModelBuilder 提供了零成本上手方案——新用户免费领 Token，永久免费模型随便用，而且一行代码就能调用，兼容 OpenAI SDK。本文从注册到跑通，手把手带你完成。

一、为什么选百度千帆？

在众多大模型 API 平台中，百度千帆有几个非常硬核的优势：

表格

优势	说明
永久免费模型	ERNIE-3.5-8K、ERNIE-Speed-8K 永久免费，QPS 高达 50，个人开发和小项目完全够用
新用户大礼包	新注册用户可领 100 万 Token/模型，覆盖 ERNIE-4.5、DeepSeek、Qwen3 等多款主力模型，有效期 3 个月
618 限时福利	千帆大模型 Tokens 量包免费送 8000 万 Tokens，活动截止 6 月 30 日（【产品链接占位】）
兼容 OpenAI SDK	V2 接口完全兼容 OpenAI 协议，改两行代码就能从 OpenAI 迁移过来
企业级合规	内置审计日志、A2A 协议、百度搜索工具原生集成，政务和企业场景首选

📌 千帆平台入口：百度智能云-推广上云福利-大使邀新专场

二、5 分钟完成注册与开通

Step 1：注册百度智能云账号

1. 访问 百度智能云官网
2. 点击右上角登录/注册，支持百度账号、手机号、微信扫码
3. 完成实名认证（微信扫码刷脸，1 分钟搞定）

⚠️ 实名认证是必须的，不认证无法开通模型服务。

Step 2：开通千帆模型服务

1. 进入 千帆 ModelBuilder 控制台
2. 首次进入会提示"您尚未开通模型服务"，点击 「立即开通」
3. 在弹窗中点击 「确认开通」 ，秒开

Step 3：领取免费额度

开通后，新用户免费额度自动发放。你可以在控制台首页的 「配额管理」 中查看各模型的剩余 Token 数。

当前可免费体验的核心模型：

模型	免费额度	有效期	推荐场景
ERNIE-3.5-8K	永久免费，不限量	永久	日常对话、文本生成
ERNIE-Speed-8K	永久免费	永久	高速对话、轻量任务
ERNIE-4.5-Turbo	100 万 Token	新用户 3 个月	复杂推理、长文本
DeepSeek-R1	100 万 Token	新用户 3 个月	数学推理、代码生成
DeepSeek-V3.1	100 万 Token	新用户 3 个月	通用对话、内容创作
Qwen3 系列	100 万 Token	新用户 3 个月	多语言、工具调用
ERNIE-X1-Turbo	100 万 Token	新用户 3 个月	深度推理

💡 每个模型独立额度，互不影响，可以分别领取体验！

📌 免费额度领取入口：百度智能云-推广上云福利-大使邀新专场

三、获取 API Key（核心步骤）

调用千帆 API 需要一个 API Key，获取非常简单：

1. 登录 千帆控制台
2. 点击左侧菜单 「应用接入」 → 「创建应用」
3. 填写应用名称（随便起，如"我的测试应用"），点击确定
4. 创建完成后，在应用列表中点击 「查看」 ，即可看到你的 API Key

API Key 格式为 bce-v3-xxxxxxxx，请妥善保存，泄露后别人可以用你的额度！

📌 API Key 管理入口：百度智能云-推广上云福利-大使邀新专场

四、3 种方式调用千帆 API

千帆 V2 接口完全兼容 OpenAI 协议，支持多种调用方式，选你顺手的即可。

方式一：OpenAI SDK 调用（推荐 ⭐）

最省心的方式，如果你之前用过 OpenAI，改两行代码就能跑：

​​​​​​​​​​bash
1   pip3 install -U openai
2

from openai import OpenAI

client = OpenAI(
    api_key="bce-v3-xxxxxxxx",  # 替换为你的 API Key
    base_url="https://qianfan.baidubce.com/v2",  # 千帆 V2 端点
)

# 调用 DeepSeek-R1 做数学推理
response = client.chat.completions.create(
    model="deepseek-r1-distill-qwen-32b",  # 模型名称
    messages=[
        {"role": "user", "content": "请证明：根号2是无理数"}
    ],
    temperature=0.7,
)

print(response.choices[0].message.content)

切换模型只需改 model 参数，例如：

# 切换到 ERNIE-4.5-Turbo
response = client.chat.completions.create(
    model="ernie-4.5-turbo-32k",
    messages=[{"role": "user", "content": "帮我写一篇关于AI的科普文章"}],
)

# 切换到 Qwen3
response = client.chat.completions.create(
    model="qwen3-32b",
    messages=[{"role": "user", "content": "用Python实现快速排序"}],
)

💡 完整模型列表参考：千帆支持的模型列表

方式二：千帆官方 SDK 调用

如果你更习惯用百度官方 SDK：

pip install qianfan

import os
import qianfan

# 方式一：使用安全认证 AK/SK（推荐）
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"  # 替换为你的 Access Key
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"  # 替换为你的 Secret Key

# 方式二：使用应用 API Key
# os.environ["QIANFAN_AK"] = "your_api_key"
# os.environ["QIANFAN_SK"] = "your_secret_key"

chat_comp = qianfan.ChatCompletion()

resp = chat_comp.do(
    model="ERNIE-3.5-8K",  # 永久免费模型
    messages=[{
        "role": "user",
        "content": "你好，请介绍一下你自己"
    }]
)

print(resp["body"])

📌 Access Key 和 Secret Key 在 百度智能云安全认证 页面获取。

方式三：HTTP 请求调用

不依赖任何 SDK，直接用 requests 发请求：

import os
import qianfan

# 方式一：使用安全认证 AK/SK（推荐）
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"  # 替换为你的 Access Key
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"  # 替换为你的 Secret Key

# 方式二：使用应用 API Key
# os.environ["QIANFAN_AK"] = "your_api_key"
# os.environ["QIANFAN_SK"] = "your_secret_key"

chat_comp = qianfan.ChatCompletion()

resp = chat_comp.do(
    model="ERNIE-3.5-8K",  # 永久免费模型
    messages=[{
        "role": "user",
        "content": "你好，请介绍一下你自己"
    }]
)

print(resp["body"])

五、实战案例：5 个真实场景直接用

案例 1：搭建智能客服助手

from openai import OpenAI

client = OpenAI(
    api_key="bce-v3-xxxxxxxx",
    base_url="https://qianfan.baidubce.com/v2",
)

# 使用免费的 ERNIE-3.5-8K
system_prompt = """你是一个专业的客服助手，负责解答用户关于产品的常见问题。
请保持礼貌、简洁，如果不确定的信息请诚实告知。"""

response = client.chat.completions.create(
    model="ernie-3.5-8k",
    messages=[
        {"role": "system", "content": system_prompt},
        {"role": "user", "content": "你们的退货政策是什么？"}
    ],
)

print(response.choices[0].message.content)

案例 2：代码审查与 Bug 分析

# 使用 DeepSeek-R1 做代码审查
code_to_review = """
def calculate_total(items):
    total = 0
    for item in items:
        total += item['price'] * item['quantity']
    return total
"""

response = client.chat.completions.create(
    model="deepseek-r1-distill-qwen-32b",
    messages=[
        {"role": "system", "content": "你是一个资深代码审查专家，请分析代码中的潜在问题并给出改进建议。"},
        {"role": "user", "content": f"请审查以下代码：\n```python\n{code_to_review}\n```"}
    ],
)

print(response.choices[0].message.content)

案例 3：流式输出（打字机效果）

# 流式输出，实时获取模型响应
stream = client.chat.completions.create(
    model="ernie-4.5-turbo-32k",
    messages=[{"role": "user", "content": "写一首关于春天的诗"}],
    stream=True,  # 开启流式
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

案例 4：多轮对话记忆

messages = [
    {"role": "system", "content": "你是一个友好的AI助手"},
]

def chat(user_input):
    messages.append({"role": "user", "content": user_input})
    
    response = client.chat.completions.create(
        model="ernie-speed-8k",  # 永久免费，速度快
        messages=messages,
    )
    
    assistant_msg = response.choices[0].message.content
    messages.append({"role": "assistant", "content": assistant_msg})
    return assistant_msg

# 多轮对话
print(chat("我叫小明，我喜欢编程"))
print(chat("你还记得我叫什么名字吗？"))  # 会记住上下文

案例 5：接入 OpenClaw / Agent 框架

千帆兼容 OpenAI 协议，可以直接接入 OpenClaw、LangChain、Dify 等 Agent 框架：

// OpenClaw 配置示例
{
  "providers": {
    "qianfan": {
      "baseUrl": "https://qianfan.baidubce.com/v2",
      "apiKey": "${BAIDU_API_KEY}",
      "models": [
        { "id": "deepseek-r1-distill-qwen-32b", "name": "DeepSeek R1 32B" },
        { "id": "ernie-4.5-turbo-32k", "name": "ERNIE 4.5 Turbo" }
      ]
    }
  }
}

六、避坑指南：6 个常见问题

❓ 1. 调用返回 403 错误

原因：未开通后付费权限。

解决：进入百度智能云费用中心 → 开通按量后付费模式并完成实名认证。

❓ 2. 提示 QUOTA_EXCEEDED

原因：免费额度用完或该模型不在免费包覆盖范围内。

解决：在控制台 「配额管理」 查看各模型额度；部分新版模型（如 ERNIE-X1）可能需单独购买。

❓ 3. API 响应速度慢

原因：高峰期排队。

解决：优先使用 ERNIE-Speed-8K（永久免费 + 速度快），或使用非高峰时段调用。

❓ 4. model 参数填错了

原因：模型名称需要与千帆支持的列表完全一致。

解决：参考 千帆模型列表，注意大小写和连字符。

❓ 5. OpenAI SDK 版本不兼容

原因：旧版 OpenAI SDK 不支持自定义 base_url。

解决：升级到最新版：pip3 install -U openai

❓ 6. 免费额度到期了怎么办？

解决方案：

• ERNIE-3.5-8K 和 ERNIE-Speed-8K 永久免费，不受到期影响
• 其他模型到期后可购买按量后付费，价格极低（ERNIE-4.5 Turbo 输入仅 ¥0.0008/千 Token）
• 关注 618 等大促活动，经常有免费 Token 包赠送

七、千帆 vs 其他平台：为什么选千帆？

表格

对比维度	百度千帆	阿里云百炼	硅基流动	智谱 AI
永久免费模型	✅ ERNIE-3.5/Speed	❌	✅ 小模型	✅ GLM-4-Flash
免费额度 QPS	50	2	-	30
OpenAI SDK 兼容	✅	✅	✅	✅
企业合规/审计	✅ 原生支持	一般	❌	❌
DeepSeek 支持	✅	✅	✅	❌
文心自研模型	✅	❌	❌	❌
618 免费送 Token	8000 万	-	-	-

结论：如果你需要企业级合规 + 永久免费 + 高并发，千帆是国内最稳的选择。

八、总结：3 步开始零成本用 AI

1. 注册开通：5 分钟完成百度智能云注册 → 实名认证 → 开通千帆模型服务
2. 获取 Key：创建应用，拿到 API Key（bce-v3-xxx 格式）
3. 一行代码调用：改 base_url 为 https://qianfan.baidubce.com/v2，用 OpenAI SDK 直接调

没有显卡？不需要。没有预算？免费模型永久用。百度千帆让每一个开发者都能零门槛用上顶尖 AI 能力。

🔗 相关链接

• 百度千帆 ModelBuilder 控制台：百度智能云-推广上云福利-大使邀新专场
• 千帆免费额度领取：百度智能云-推广上云福利-大使邀新专场
• 千帆 618 大促活动页：百度智能云-推广上云福利-大使邀新专场
• 千帆官方文档：快速开始 - ModelBuilder
• 模型列表：千帆支持的模型
• 计费说明：模型服务计费

本文数据基于 2026 年 5 月各平台官网公开信息，定价和模型列表可能随时更新，请以千帆控制台最新信息为准。