百度一镜数字人需通过api接入业务系统,包括创建应用获取app id/api key/secret key、获取access token、调用视频生成与直播推流接口,并配置回调地址实现事件闭环。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让百度一镜数字人接入自有业务系统、触发定制化动作或响应外部事件,比如在电商订单生成后自动启动带货直播、在CRM系统录入新客户时同步生成欢迎视频——这必须通过API完成功能扩展。
准备API调用环境
登录百度智能云控制台,在「AI服务」→「数字人」→「百度一镜」页面点击「API管理」,进入应用列表。
点击「创建应用」,填写应用名称(如“ERP对接系统”),选择「百度一镜数字人视频生成」和「百度一镜数字人直播实时推流」两个服务权限,提交后系统自动生成 【App ID、API Key、Secret Key】,三者缺一不可,且 Secret Key 仅显示一次,务必立即复制保存。
若跳过实名认证或未完成企业主体认证,API调用将返回 401 错误,无法进入下一步。
获取并刷新Access Token
调用所有百度一镜API前,必须先获取有效 Access Token。向 https://aip.baidubce.com/oauth/2.0/token 发送 POST 请求,携带参数:grant_type=client_credentials、client_id=你的API Key、client_secret=你的Secret Key。
响应体中提取 access_token 字段值,该 token 有效期为 30 天,但建议每次调用前检查剩余有效期——若响应中 expires_in 小于 3600 秒,应主动刷新,避免直播推流中途断连。
扩展数字人视频生成功能
方法一:使用公共形象库批量生成口播视频
向 https://aip.baidubce.com/rpc/2.0/speech/tts/v1(实际为视频生成专用地址,需替换为最新文档中的 /v1/video/generate)发送 POST 请求,Header 中加入 Authorization: Bearer {access_token},Body 使用 JSON 格式,必填字段包括:template_id(从公共形象库获取的模板ID)、script(UTF-8 编码纯文本脚本)、audio_lang(如 "zh")、video_resolution(支持 "1080p" 或 "720p")。
注意:script 字数超过 500 字将被截断,且不支持嵌入图片或动态图表,需提前拆分多条请求处理。
调用百度文档解析API,支持18+格式,提取文本、表格、版面分析、OCR识别及RAG文档分块。适用于文档解析、文本/表格提取、结构分析、扫描件处理。触发词:文档解析、PDF解析、Word解析、表格提取、OCR、文档分析、提取文本、文档结构、扫描识别。
方法二:绑定自有形象与声音克隆模型
先调用 /v1/clone/voice/create 接口上传 60 秒以上清晰人声音频(无背景音乐、无回声),获取 voice_id;再调用 /v1/clone/avatar/create 上传正脸高清照+3张侧脸照+1段真人出镜短视频(≥30秒),生成 avatar_id;最后在视频生成请求中传入这两个 ID,即可驱动专属数字人开口说话。
扩展数字人直播推流能力
第一步:创建直播任务
向 /v1/live/task/create 提交请求,指定 avatar_id、voice_id、stream_url(你自己的RTMP地址,需提前配置好CDN鉴权)、scene_config(JSON格式,定义PPT翻页节奏、商品弹窗触发点、问答关键词热词表)。
第二步:动态注入实时内容
直播开始后,通过 WebSocket 长连接向 wss://live.api.baidubce.com/v1/live/push/{task_id} 发送结构化消息,例如:{"type":"product_show","data":{"sku":"10086","price":"¥299","image_url":"https://xxx.jpg"}},数字人将自动执行讲解动作并同步展示商品浮层。
第三步:监听互动事件
在你的服务端配置回调地址(callback_url),百度一镜会将观众提问、点赞峰值、下单成功等事件以 POST 方式实时推送,字段含 event_type、content、timestamp,用于触发后续业务逻辑。
若未在控制台「API管理」→「回调设置」中正确填写 callback_url 并通过签名验证测试,所有互动事件将丢失,无法实现闭环运营。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










