tencent cloud

腾讯云智能数智人

产品简介
产品概述
产品功能
产品优势
购买指南
价格指南
购买指引
使用代金券购买流程
退费说明
数智人形象介绍
形象类别介绍
基础形象库
形象和声音复刻指引
数智人平台操作指引
访问平台
形象生产与资产管理
数智人会话互动应用与管理
播报数智人视频生成与管理
运营管理与分析
服务端 API 接入
数智人 API 接入模式概述
数智人 aPaas 接口调用方式
2D真人小样本形象、声音定制 API 文档
视频生成服务 API 文档
交互数智人服务 API 文档
个人资产管理 API 文档
客户端 SDK 接入
整体介绍
3D 端渲染 SDK 接入
2D 端渲染 SDK 接入
数智人 SSML 标记语言规范
相关协议
隐私协议
DSA（Data Sharing Agreement）
常见问题
文档腾讯云智能数智人服务端 API 接入交互数智人服务 API 文档云渲染会话交互接入 API直播会话管理使用个人资产形象建流

使用个人资产形象建流

PDF
聚焦模式
字号
最后更新时间： 2025-08-07 17:27:38
用于新建视频流，获取数智人画面的流播放地址。

调用协议

HTTPS + JSON
POST /v2/ivh/sessionmanager/sessionmanagerservice/createsessionbyasset
Header Content-Type: application/json;charset=utf-8

请求参数

参数名称
类型
必选
描述
ReqId
String
是
单次请求唯一标识，长度为32的 uuid。
SessionId
String
否
会话唯一标识。SaaS 环境不允许传入由云端分配，私有化环境可传入。
AssetVirtualmanKey
String
是
个人资产形象 ID。从数智人平台的资产管理中获取，如图：



UserId
String
是
用户的唯一标识，由调用方自己维护。以相同的 UserId 创建新流，会导致上一个该 UserId 流关闭。
Protocol
String
是
当前支持参数：rtmp、trtc、webrtc
DriverType
int
是
数智人驱动方式。
1：纯文本驱动；
3：音频驱动（原声），此模式下支持发送音频和文本两种驱动模式；
ProtocolOption
否
协议自定义参数，不使用 trtc 不用关注。
SpeechParam
否
音色相关参数。

ProtocolOption

名称
类型
必选
描述
TrtcUseExternalApp
boolean
否
是否使用外部 trtc appid，如果不使用，将使用数智人平台统一的 trtc appid。
注意：
使用数智人平台统一的 trtc 时，仅限于调试阶段，不可用于投产阶段。
TrtcAppId
string
否
trtc appid（使用外部 trtc appid 时必填）。
TrtcRoomId
int
否
trtc 房间号（不指定则由云端分配房间号）。
TrtcUserSig
string
否
trtc 数字人用户签名（使用外部 trtc appid 时必填）。
TrtcPrivateMapKey
string
否
trtc 数字人用户权限密钥（使用外部 trtc appid 时必填）。
CssCustomPushUrl
string
否
自定义云直播推流地址，推流协议固定使用 rtmp，使用 rtmp 推流给云直播，可以使用云直播支持的各类拉流协议进行拉流播放。
要求的推流地址格式为：
rtmp://xyz.com/cssAppName/streamid?txSecret={0}&txTime={1}
txSecret 和 txTime 计算方式参考：https://www.tencentcloud.com/document/product/267/32720?from_cn_redirect=1

SpeechParam

名称
类型
必选
描述
Speed
float
否
语音速度，取值范围[50,200], 50表示默认速度的50%； 不填写的话，默认为100，建议使用默认值
TimbreKey
string
否
音色key。
Volume
int
否
音量大小，取值范围为[-10, 10], -10表示音量相对默认值小10dB；不填写的话，默认为0，建议使用默认值
TimbreLanguage
string
否
音色语种，可选语种参考个人资产管理 API 分页查询音色列表 接口，多语种音色在合成时必须选择对应语种。

返回参数

名称
类型
必选
描述
ReqId
String
是
单次请求唯一标识。
SessionId
String
是
会话的唯一标识
SessionStatus
int
是
状态：
1: 进行中(已就绪)，命中缓存直接得到播流地址
3: 准备中(未就绪)，未命中缓存需等待模型加载，需要使用 查询会话状态 接口轮询会话状态，直到流状态变为1为止。一般不超过2分钟
PlayStreamAddr
String
否
播放地址，格式为：rtmp://liveplay.ivh.qq.com/live/m789
如果通过 CssCustomPushUrl 参数指定了自定义云直播推流地址，则不返回此字段

请求示例

{
    "Header": {

    },
    "Payload": {
        "ReqId": "d7aa08da33dd4a662ad5be508c5b77cf",
        "AssetVirtualmanKey": "d7aa08da33dd4a662ad5be508c5b77cf",
        "DriverType": 1,
        "UserId": "henry",
        "Protocol": "rtmp"
    }
}

返回示例

{
    "Header": {
        "Code": 0,
        "Message": "",
        "RequestID": "123"
    },
    "Payload": {
        "ReqId": "d7aa08da33dd4a662ad5be508c5b77cf",
        "SessionId": "m789",
        "SessionStatus": 1,
        "PlayStreamAddr": "rtmp://live.qq.com/live/m789"
    }
}
上一篇: 新建直播流会话下一篇: 查询会话状态

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈