tencent cloud

腾讯云智能数智人

实时更新数智人画面参数

Download
聚焦模式
字号
最后更新时间: 2026-07-16 09:56:16
用于实时更新视频流画面中的人物大小、位置、背景图。
注意:
此接口不再建议使用,后续不再继续迭代新特性。当需要设置数智人背景、人物大小时的推荐使用方法:设置绿幕背景推流,自行使用流媒体软件抠绿叠加前后景、缩放人物大小。
此接口请求频次限制:单一 session 每5秒可请求一次。

调用协议

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

请求参数

参数名称
类型
必选
描述
ReqId
String
单次请求唯一标识。
SessionId
String
会话 ID。
SpaceParam
空间信息,2D 小样本支持此参数
ImageParam
形象信息,3D 形象支持此参数

SpaceParam

名称
类型
必选
描述
BackgroundUrl
String
背景 URL 地址(小于1MB 大小,最好与输出分辨率对齐,否则会被拉伸填充)要求:jpg、jpeg、png(其他格式不支持),不传使用上次背景图
ImagePosition
float
人物在背景图中的 X 位置,人物图片中轴居中 X 为0,取值范围为[-0.5,0.5],不可移出背景图范围,线性值。
ImagePositionVertical
float
人物在背景图中的 Y 位置,人物图片贴底 Y 为0,取值范围为[-0.5,0.25],向下可以移出背景图,线性值。
ImageZoom
float
人物相对于原始素材图的缩放比例,由缩放后的大小和原始人物素材图计算得到的缩放比例。计算公式:缩放后人物图片的宽度/(预览区域背景宽度/目标分辨率宽度)/人物原始素材的宽度。建议取值范围[0.25,2]。
Backgrounds
Arrays of [VideoLayer]
背景图列表,背景和前景总数不能超过5。
说明:
1. 对于未抠除拍摄背景的主播,此参数无法生效。
2. 对于抠除拍摄背景的主播,背景生效优先顺序为:
2.1 此参数设置的背景。
2.2 绿幕。
3. 如果使用该参数,会覆盖掉 BackgroundUrl
Foregrounds
Arrays of [VideoLayer]
前景图列表,背景和前景总数不能超过5。如果需要清空之前设置的前景,将数组设置为 []。不传这个参数更新,会保留前景数据

ImageParam

名称
类型
必选
描述
ImageVerticalOffset
float
3D 形象上半身垂直方向转动角度
ImageHorizontalOffset
float
3D 形象上半身水平放心啊个转动角度。
ImageExtraParam
float
3D 形象变色参数,具体参数可在交互数智人平台查询。

VideoLayer

参数名称
类型
必选
描述
URL
String
图层资源地址。
图片格式:支持 jpg、jpeg、png、mjpeg、gif。
图片大小:建议不超过2MB。
X
int
资源放置的左上 X 坐标。
Y
int
资源放置的左上 Y 坐标。
Width
int
资源输出的宽度。
Height
int
资源输出的高度。

返回参数

名称
类型
必选
描述
ReqId
String
单次请求唯一标识。

请求示例

{
"Header": {},
"Payload": {
"ReqId": "d7aa08da33dd4a662ad5be508c5b77cf",
"SessionId": "m123adfafvbadsafd",
"ImageParam": {
"ImageVerticalOffset": 10,
"ImageHorizontalOffset": 10,
"ImageExtraParam": "{\\"JacketColor\\":{\\"colorValue\\":10491928},\\"DressColor\\": {\\"colorValue\\":10491928},\\"shoeColor\\": {\\"colorValue\\": 10491928}}"
},
"SpaceParam": {
"BackgroundUrl": "https://virtualhuman-cos-prod-1251316161.cos.ap-nanjing.myqcloud.com/ai-resource/1518804312073965568",
"ImagePosition": -0.01,
"ImagePositionVertical": -0.01,
"ImageZoom": 1
}
}
}

返回示例

{
"Header": {
"Code": 0,
"Message": "",
"RequestID": "123",
},
"Payload": {
"ReqId": "d7aa08da33dd4a662ad5be508c5b77cf",
}
}


帮助和支持

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

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

文档反馈