数字人直播接口开发文档【云端版、支持手机数字人直播】我把官方接口简化成新手能直接看懂、直接复制代码用的版本只讲最常用、最核心的操作不用管复杂概念跟着步骤走就能跑通数字人直播。一、先准备好3个必备信息调用所有接口都需要这3个提前找酷虎云后台拿1. 接口基础地址比如 https://官方给的域名2. API密钥/Token请求头里要带用于鉴权3. 数字人ID上传好数字人后得到的ID 所有请求格式JSON参数请求头统一加 ContentType: application/json Authorization: Bearer 你的Token二、核心流程新手必看最简直播流程上传数字人 → 启动数字人 → 上传/提交音频 → 数字人播报 → 停止数字人三、分接口极简使用教程1. 启动数字人必用接口POST /player/select作用开启数字人直播窗口请求参数JSONjson{character_id: 你的数字人ID}返回成功数字人启动完成2. 查询数字人状态看是否在线接口GET /player/status作用查看数字人是运行中/已停止无参数返回示例json{status: running // running运行中stopped已停止}3. 上传音频2种最简单方式方式1一键上传播放新手首选接口POST /player/play_once作用上传音频 自动加入播放队列一步到位请求参数json{audio_url: 你的音频在线地址, // 支持mp3/wavcontent: 音频对应的文字 // 可选}效果数字人直接播报这段音频方式2先上传音频再提交播放1. 上传音频POST /api/vocals参数audio_url音频地址、content文字返回vocal_id音频唯一ID2. 提交到直播队列POST /api/vocals/{vocal_id}/submit把上面的ID填到链接里直接请求即可播放4. 打断/切换音频实时控制接口POST /player/interrupt作用立刻停掉当前音频播放下一段无参数适合想切换话术、打断当前播报5. 停止数字人结束直播接口POST /player/stop作用关闭数字人直播无参数必做用完一定要停止避免占用资源6. 强制打断并停止应急用接口POST /player/interrupt_and_stop作用立刻打断音频 关闭数字人适合卡死、异常时强制结束四、数字人上传新手最简版只教普通上传分片上传太复杂新手不用管接口POST /characters/add请求参数json{name: 数字人名称,model_url: 数字人模型地址,cover_url: 封面图地址}返回character_id数字人ID启动时要用五、完整新手调用示例可直接复制以Python为例复制就能跑pythonimport requests基础配置BASE_URL TOKEN 你的TokenCHARACTER_ID 你的数字人ID请求头headers {ContentType: application/json,Authorization: fBearer {TOKEN}}1. 启动数字人def start_player():url f{BASE_URL}/player/selectdata {character_id: CHARACTER_ID}res requests.post(url, jsondata, headersheaders)print(启动结果, res.json())2. 播放一段音频一键版def play_audio():url f{BASE_URL}/player/play_oncedata {audio_url: https://xxx.com/xxx.mp3,content: 欢迎来到我的直播间}res requests.post(url, jsondata, headersheaders)print(播放结果, res.json())3. 查询状态def get_status():url f{BASE_URL}/player/statusres requests.get(url, headersheaders)print(当前状态, res.json())4. 停止数字人def stop_player():url f{BASE_URL}/player/stopres requests.post(url, headersheaders)print(停止结果, res.json())直接运行if __name__ __main__:start_player() 启动get_status() 查状态play_audio() 播音频stop_player() 最后停止六、新手常见问题1. 请求失败检查Token、基础地址、数字人ID是否正确2. 音频不播放音频地址必须公网可访问格式mp3/wav3. 数字人没反应先查状态/player/status确保是running4. 想换话术用/player/interrupt打断再重新提交音频总结1. 核心就4步启动 → 播音频 → 控制 → 停止2. 新手优先用select(启动)、play_once(一键播报)、interrupt(打断)、stop(停止)3. 不用管复杂接口先跑通基础直播再慢慢扩展需要我帮你把这套教程做成Postman导入文件或者简化成网页版Demo吗直接导入就能测所有接口。来源酷虎云数字人直播api开放平台