需通过千帆平台完成实名认证、创建应用获取API密钥、开通模型服务并设置QPS、调用API或使用Python SDK集成文心一言大模型能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在自己的应用或服务中集成文心一言的大模型能力，但尚未完成API密钥获取与接口调用配置，则需通过千帆大模型平台完成身份认证、模型授权及开发环境接入。以下是实现该目标的完整操作路径：
本文运行环境：MacBook Pro M2，macOS Sequoia。
一、注册并登录千帆大模型平台
申请文心一言API的前提是拥有百度账号并完成实名认证，平台将据此核验开发者资质并分配对应权限等级的调用额度。
1、访问 https://cloud.baidu.com/product/wenxin 官方千帆大模型平台入口。
2、点击右上角“登录”，使用已实名认证的百度账号登录。
3、登录后进入控制台，若未完成企业/个人实名认证，系统将强制跳转至认证页面，需上传身份证正反面照片并填写真实信息。
二、创建应用并获取API Key与Secret Key
每个应用对应一组独立的API凭证，用于签名验证请求合法性；同一账号可创建多个应用以隔离不同项目环境。
1、在千帆控制台左侧导航栏点击“应用管理” → “创建应用”。
2、填写应用名称（如“内容生成助手”）、应用描述、选择适用场景（如“文本生成”），勾选《文心一言服务协议》。
3、提交后页面自动跳转至应用详情页，在“接口凭证”区域可见API Key与Secret Key，请立即复制并安全保存——该Secret Key仅首次可见，刷新后不可再查。
三、开通文心一言模型服务并设置QPS配额
API Key默认不绑定任何模型，必须手动开通所需模型实例，并设定每秒调用次数（QPS）上限，防止异常调用耗尽额度。
1、在应用详情页点击“模型服务” → “开通服务”。
对设计或页面进行 WCAG 2.1 AA 无障碍审计。触发关键词：“audit accessibility”、 “check a11y”、 “is this accessible?” 或在审查设计时使用。
2、从列表中选择目标模型，例如ERNIE-Bot-4或ERNIE-Bot-turbo，点击“立即开通”。
3、在弹出配置框中设置单日总调用量（如1000次）与峰值QPS（如5），确认提交。
四、构造HTTP请求并调用API接口
文心一言API采用标准RESTful风格，所有请求须携带Access Token（由API Key与Secret Key动态签发），且Body为JSON格式的严格结构化参数。
1、使用curl或Python requests等工具，先向https://aip.baidubce.com/oauth/2.0/token发起POST请求，传入grant_type=client_credentials、client_id={API Key}、client_secret={Secret Key}，获取access_token。
2、调用模型接口时，向https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions发送POST请求。
3、Header中设置Content-Type: application/json与Authorization: Bearer {access_token}。
4、Body中按规范填入messages数组（含role和content字段）、model名称、temperature等参数，示例值：{"messages":[{"role":"user","content":"你好"}],"model":"ernie-bot-4"}。
五、使用SDK快速集成（Python示例）
百度官方提供Python SDK，封装了鉴权、重试、错误解析等逻辑，可显著降低接入复杂度，适合非全栈开发者快速验证功能。
1、执行命令安装SDK：pip install qianfan。
2、在代码中初始化客户端：import qianfan; chat = qianfan.ChatCompletion(ak="YOUR_API_KEY", sk="YOUR_SECRET_KEY")。
3、发起对话请求：resp = chat.do(messages=[{"role": "user", "content": "写一首七言绝句"}])。
4、从响应中提取结果：print(resp.body["result"])。
