文心 ERNIE 系列是什么
ERNIE 是百度的大模型家族，经智能云千帆（Qianfan）平台提供 API、精调与数据工具链，在中文知识问答与政企项目里落地较早。千帆接口分两代：v1 用 AK/SK 签名换 access_token，路径在 wenxinworkshop 下；v2 改为 /v2/chat/completions，用 Bearer API Key，请求体与 OpenAI 协议兼容。两代鉴权方式不通用，混淆是接入阶段最常见的失败原因。
基本信息
| 厂商 | 百度智能云 |
|---|---|
| 平台 | 千帆 Qianfan |
| 接入地址 | qianfan.baidubce.com/v2/chat/completions |
| 鉴权方式 | Bearer API Key（v1 为 AK/SK 签名换 token） |
| 代表型号 | ERNIE 4.5 系列及更早世代 |
| 费用口径 | 预置模型与自训模型计费不同 |
典型使用场景
- 中文政企问答：需要国产模型与本地服务支持的招投标项目
- 检索增强生成：配合千帆知识库或自建向量库做企业问答
- 私有语料精调：用企业文档训练专属模型后线上服务
- 图文多模态：票据、报告扫描件的字段识别与理解
- 存量系统迁移：把老 v1 调用改造成协议兼容的 v2 接口
- 数据工具链：用平台侧的数据标注与评估能力做迭代
千帆 v2 调用与自检
千帆 v2 调用与自检
# v2 接口用 Bearer API Key，不再是 AK/SK 签名
export QIANFAN_API_KEY=你的密钥
cat > payload.json <<'EOF'
{"model":"ernie-4.5-8k-preview","messages":[{"role":"user","content":"把这段公告改写得更简洁"}]}
EOF
curl -s https://qianfan.baidubce.com/v2/chat/completions \
-H "Authorization: Bearer $QIANFAN_API_KEY" -H "Content-Type: application/json" -d @payload.json
# 排查顺序：先看 401（鉴权版本）再看 404（模型标识）最后看 429（配额）v1 与 v2 对照
| 维度 | v1 | v2 |
|---|---|---|
| 鉴权 | AK/SK 签名换 access_token | Bearer API Key |
| 路径 | wenxinworkshop 下的自有路径 | /v2/chat/completions |
| 请求结构 | 百度自有字段 | OpenAI 兼容字段 |
| 迁移建议 | 存量代码保留并加适配层 | 新项目直接选 v2 |
拿到 access_token 去调 v2 会稳定返回 401；反过来把 API Key 当签名凭证也会失败。排错时先确认接口代际，再查模型列表里该型号是否仍在线。
千帆同时存在免费额度型号与计费型号，价格、上下文长度与速率限制以控制台发布为准，预算测算不要沿用旧价目表。