DicoHub
登录注册
← 返回教程目录

文心 ERNIE

一句话简介：文心一言是百度基于文心大模型（ERNIE）打造的 AI 对话产品。

主流功能：中文知识问答、文学创作、百度搜索/文小言联动

可用性：国内可直接使用（网页/App/开源权重/API 均为百度官方国内服务，无需特殊网络）。

适用人群：普通用户：日常问答、写作、办公提效，用网页或 App 即可

前置条件：

  • 网页/App 使用：一个百度账号（手机号即可），联网，免费
  • API 接入：百度智能云账号并完成实名认证
  • 本地部署开源权重：Linux 服务器 + GPU（示例的 0.3B 模型消费级显卡/CPU 即可，大模型需按仓库说明准备算力）

教程一：文心一言网页版 / App 使用教程

步骤 1：打开网页版

  1. 浏览器访问文心一言官网，用百度账号（手机号/扫码）登录。
  2. 登录后直接在输入框提问，免费使用。左侧可切换不同模型版本（以页面实际展示为准）。

步骤 2：安装手机 App

  1. 在手机应用商店（苹果 App Store / 各安卓应用市场）搜索「文心一言」，认准百度出品，下载安装。
  2. 用同一百度账号登录，聊天记录与网页版同步。

步骤 3：高效使用小技巧

  • 提问时给足背景：「你是资深 HR，请帮我把这段自我介绍改得更适合应届生求职，300 字以内」比「帮我改自我介绍」效果好得多。
  • 长文档处理：把文档内容分段粘贴，或使用页面上的文件上传入口（以实际功能为准）。
  • 重要回答建议交叉核对事实性内容，大模型可能产生幻觉。

教程二：开源权重本地部署（以已开源的 ERNIE 4.5 系列为例）

说明：百度已开源 ERNIE 4.5 系列多个尺寸的权重，可通过 GitCode 镜像在国内高速下载。ERNIE 5.0/5.1 权重的开源情况请以飞桨/百度官方公告为准，此处未验证。下面以 0.3B 轻量模型为例演示 FastDeploy 部署流程，大尺寸模型步骤类似，硬件要求以对应仓库 README 为准。

步骤 1：准备环境

# 建议使用 Python 3.10 虚拟环境
python -m venv ernie_env
source ernie_env/bin/activate   # Windows 用 ernie_env\Scripts\activate

# 国内 pip 换源加速（清华源）
pip install fastdeploy-genai -i https://pypi.tuna.tsinghua.edu.cn/simple

步骤 2：下载开源权重（GitCode 国内镜像）

# 以 ERNIE-4.5-0.3B-Base-Paddle 为例，大模型换对应仓库名
git clone https://gitcode.com/hf_mirrors/baidu/ERNIE-4.5-0.3B-Base-Paddle

步骤 3：启动 OpenAI 兼容的推理服务

python -m fastdeploy.entrypoints.openai.api_server \
  --model ./ERNIE-4.5-0.3B-Base-Paddle \
  --port 8180 \
  --max-model-len 32768

看到服务启动日志后，本地就有一个 OpenAI 格式的 API 了。

步骤 4：调用验证

curl http://localhost:8180/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model": "ERNIE-4.5-0.3B-Base-Paddle",
       "messages": [{"role": "user", "content": "你好，请介绍一下你自己"}]}'

或用 Python 的 openai 库，把 base_url 设为 http://localhost:8180/v1 即可。

教程三：百度智能云千帆 API 接入教程

千帆 ModelBuilder（原千帆大模型平台）提供与 OpenAI 兼容的接口，推荐新用户直接用这种方式。

步骤 1：注册并实名

  1. 访问百度智能云官网，注册账号并完成个人/企业实名认证。
  2. 进入控制台，找到「千帆 ModelBuilder」（大模型平台）。

步骤 2：创建应用，获取 API Key

  1. 在千帆控制台进入「应用接入」→ 点击「创建应用」。
  2. 填写应用名称、描述，提交后系统生成 API Key（新版为 Bearer Token 形式；旧版为 API Key + Secret Key）。
  3. 妥善保存密钥，不要提交到公开仓库。

步骤 3：Python 调用（OpenAI 兼容方式，推荐）

pip install openai -i https://pypi.tuna.tsinghua.edu.cn/simple

from openai import OpenAI

client = OpenAI(
    base_url="https://qianfan.baidubce.com/v2",  # 千帆 OpenAI 兼容地址
    api_key="你的API Key",                         # 替换为步骤2获取的 Key
)

resp = client.chat.completions.create(
    model="ernie-speed-128k",   # 模型名以控制台「模型列表」为准
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

步骤 4：curl 调用（不写代码也能测）

curl --location --request POST 'https://qianfan.baidubce.com/v2/chat/completions' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer 你的API Key' \
  --data-raw '{"model":"ernie-speed-128k","messages":[{"role":"user","content":"你好"}]}'

注意 Bearer 后面有一个空格再接 Key。

步骤 5：查看用量与计费

在千帆控制台「用量/账单」中查看调用量。部分模型（如 ERNIE-Speed 系列）有免费额度，具体以控制台展示为准。

常见问题

  1. API 返回 401 Unauthorized？ 检查 Authorization: Bearer 后是否有空格、Key 是否复制完整、Key 是否被删除或过期。旧版 AK/SK 方式需先换 access_token，建议直接改用上文 v2 兼容接口。

  2. 千帆控制台找不到想要的模型？ 模型上线/下线以控制台「模型列表」为准，文档中的示例模型名（如 ernie-speed-128k）可能随时间调整，调用前先在控制台确认。

  3. 开源权重和线上 API 能力一样吗？ 不一样。开源的是特定尺寸/版本的权重（如 4.5 系列），线上 API 提供的是百度持续迭代的最新模型（含 5.x），能力、更新速度都更强。本地部署胜在数据不出内网、免调用费。

  4. ERNIE 5.0/5.1 的开源权重哪里下？ 截至 2026-10-05 未验证到 5.0/5.1 权重的公开下载地址，请以百度/飞桨官方公告为准，不要轻信第三方网盘里的所谓"5.0 权重"。

  5. pip 下载太慢？ 命令后加 -i https://pypi.tuna.tsinghua.edu.cn/simple 使用清华镜像源；GitHub 克隆慢可用 GitCode 镜像（如上文权重下载所示）。