产品简介

产品概述

产品功能

产品优势

购买指南

价格指南

购买指引

使用代金券购买流程

退费说明

数智人形象介绍

形象类别介绍

基础形象库

形象和声音复刻指引

数智人平台操作指引

访问平台

形象生产与资产管理

数智人会话互动应用与管理

播报数智人视频生成与管理

运营管理与分析

服务端 API 接入

数智人 API 接入模式概述

数智人 aPaas 接口调用方式

2D真人小样本形象、声音定制 API 文档

视频生成服务 API 文档

交互数智人服务 API 文档

个人资产管理 API 文档

客户端 SDK 接入

整体介绍

3D 端渲染 SDK 接入

2D 端渲染 SDK 接入

数智人 SSML 标记语言规范

实时更新数智人画面参数

PDF

聚焦模式

字号

最后更新时间： 2024-07-19 10:15:19

用于实时更新视频流画面中的人物大小、位置、背景图。
说明：
此接口不再建议使用，后续不再继续迭代新特性。当需要设置数智人背景、人物大小时的推荐使用方法：设置绿幕背景推流，自行使用流媒体软件抠绿叠加前后景、缩放人物大小。
注意：
此接口请求频次限制：单一session每5秒可请求一次。
调用协议
HTTPS + JSON
POST /v2/ivh/sessionmanager/sessionmanagerservice/updatesessionconfig
Header Content-Type: application/json;charset=utf-8
请求参数
参数名称
类型
必选
描述
ReqId
String
是
单次请求唯一标识。
SessionId
String
是
会话id。
SpaceParam
﻿SpaceParam﻿
否
空间信息，2D小样本支持此参数
ImageParam
﻿ImageParam﻿
否
形象信息，3D形象支持此参数
﻿SpaceParam
﻿
名称
类型
必选
描述
BackgroundUrl
String
否
背景 URL 地址（小于1M大小，最好与输出分辨率对齐，否则会被拉伸填充）要求：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]。
﻿ImageParam
﻿
名称
类型
必选
描述
ImageVerticalOffset
float
否
3D形象上半身垂直方向转动角度
ImageHorizontalOffset
float
否
3D形象上半身水平放心啊个转动角度。
ImageExtraParam
float
否
3D形象变色参数，具体参数可在交互数智人平台查询
返回参数
名称
类型
必选
描述
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",
    }
}
﻿

帮助和支持

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

您也可以联系销售或提交工单以寻求帮助。

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

文档反馈

tencent cloud

腾讯云智能数智人

实时更新数智人画面参数

调用协议

请求参数

返回参数

请求示例

返回示例

帮助和支持

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

名称	类型	必选	描述
BackgroundUrl	String	否	背景 URL 地址（小于1M大小，最好与输出分辨率对齐，否则会被拉伸填充）要求：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]。