必须通过百度智能云API调用文心一言,先实名认证获取API Key和Secret Key,再换取30天有效期的access_token;请求需用Bearer鉴权,发往动态更新的RPC地址,JSON体含messages数组,响应内容在choices[0].message.content中,注意is_truncated截断标识及错误码处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在自己的程序中调用文小言(即文心大模型,当前官方统一称“文心一言”,“文小言”为早期非正式称呼或产品化命名变体)的文本生成、对话理解等核心能力,必须通过百度智能云提供的标准API接口完成,不能直接访问网页端或App内部逻辑。
获取合法调用凭证
登录百度智能云控制台,进入「人工智能」→「文心一言」服务页,完成实名认证后创建应用,系统将生成唯一的 【API Key】 和 【Secret Key】。这两组密钥是后续所有请求的身份根基,泄露会导致账户被滥用。
注意:未完成企业实名认证的个人账号,默认仅开放基础模型(如ERNIE-4.5-Turbo)调用权限,ERNIE-X1等高阶模型需额外提交资质审核。
获取临时访问令牌(access_token)
文心一言API不接受原始AK/SK直传,必须先换取时效性令牌:
向 https://aip.baidubce.com/oauth/2.0/token 发起GET请求,参数包含 grant_type=client_credentials、client_id=你的API Key、client_secret=你的Secret Key。
响应成功时返回JSON,从中提取 access_token 字段值——该token有效期为30天,但建议每次调用前校验其剩余有效期(可通过解析JWT结构头或缓存发起时间判断),过期后必须重新获取,否则后续请求全部返回401错误。
大模型 Token 成本节约工具。在请求到达大模型之前自动压缩 prompt 和上下文,减少 60-95% 的 token 消耗,直接降低 API 成本。支持 Claude/OpenAI/Gemini 等主流模型,提供代理模式、CLI 包装、Python SDK 和 MCP Server 四种接入方式。内置一键安...
构造并发送对话请求
第一步:确定最新服务端点。截至2026年7月,官方稳定接口地址为:https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions
此地址不可硬编码,须从控制台「API文档」页实时复制,因百度可能按区域或模型版本动态切流。
第二步:组装HTTP请求头:
— Content-Type: application/json
— Authorization: Bearer {access_token}(注意Bearer后有一个空格)
第三步:构造JSON请求体,最小必要字段为:{"messages": [{"role": "user", "content": "今天天气如何?"}]}
其中 role 只允许 "user" 或 "assistant",混用 "system" 会触发400报错;content 长度上限为2048个token(中文约1024字),超限直接拒收。
解析响应并处理异常
正常响应中,核心文本位于 choices[0].message.content 路径下,这是模型实际输出内容,不是 result 或 text 字段。
必须检查响应中的 is_truncated 字段:若为 true,说明输出被token截断,此时应主动降低 max_tokens 参数值重试,而非直接截取字符串——强行截断可能导致语义断裂或语法错误。
遇到HTTP状态码非200时,优先读取响应体中的 error.code 和 error.message,例如 110 表示配额耗尽,111 表示模型不可用,282000 表示签名失效,不同错误码对应完全不同的修复路径。

















