文心一言网页版免费使用：中文问答与百度搜索打通

接入地址与模型名

千帆大模型平台提供兼容 OpenAI 风格的接口，base_url 形态通常为 https://qianfan.baidubce.com/v2，对话补全路径为 /chat/completions，具体地址以控制台接口文档页给出的为准。模型名可直接在控制台的模型列表或在线服务页查看，常见的有 ernie-4.5-turbo-128k、ernie-4.0-8k、ernie-speed-128k 等，可用的模型清单与版本随时更新，请以控制台展示为准。

一次对话补全调用

先把密钥写入环境变量，不要把密钥硬编码进脚本：

export QIANFAN_API_KEY="你的_API_Key"

然后用 curl 发起一次非流式请求，确认通道是否打通：

curl -X POST "https://qianfan.baidubce.com/v2/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $QIANFAN_API_KEY" \
  -d '{
    "model": "ernie-4.5-turbo-128k",
    "messages": [
      {"role": "system", "content": "你是一个简洁的中文助手。"},
      {"role": "user", "content": "用三句话介绍文心一言。"}
    ],
    "temperature": 0.7,
    "top_p": 0.8,
    "max_tokens": 512,
    "stream": false
  }'

如果平台给你的是 API Key 与 Secret Key 这一对凭证，需要先用它们换取访问令牌再放进请求头，令牌有有效期，过期要重新获取，具体换取方式见控制台文档；直接把 Secret Key 当令牌使用会返回鉴权失败。

关键参数说明

• model：必填，写控制台已开通的模型名，写错或未开通会直接报模型不存在。
• messages：必填，按 system、user、assistant 角色组织，多轮对话要把历史消息一并带上，服务端不保存上下文。
• temperature：控制随机性，问答类 0.1 至 0.3 更稳，创作类可调到 0.8 左右；部分模型允许的取值区间不同，超出范围会被参数校验拦下。
• top_p：与温度配合使用，一般只调其中一个，避免同时大改。
• max_tokens：限制回复长度，设得过小会截断，设得过大在长上下文场景下更容易超时或超限。
• stream：设为 true 时以流式返回，适合网页逐字输出，需要按数据块逐个解析。

额度耗尽与限流的排查顺序

1. 先看状态码：返回 401 或鉴权错误，依次检查密钥是否写错、令牌是否过期、请求头是否为 Bearer 形式加空格。
2. 再看模型：返回模型不存在或无权访问，核对模型名拼写，并确认该模型已在控制台开通、免费额度覆盖该模型。
3. 判断是限流还是欠费：返回 429 或提示请求频率超限，说明触发了每分钟请求数或并发上限，降低并发、加重试退避即可；返回余额不足或额度用尽类错误，则是免费额度到期或耗尽，需到控制台确认资源包状态，具体错误码以官方文档为准。
4. 最后看超时与截断：偶发超时通常由 max_tokens 过大或上下文过长引起，先缩短输入输出长度，再考虑开启 stream 分批接收。
5. 兜底建议：把每次请求的状态码与错误信息写入日志，便于区分是账号侧问题还是调用侧问题；线上服务务必准备备用模型或降级文案，避免额度用尽时页面整体不可用。