帮你快速理解、总结文档立即下载
文档中心>腾讯云智能数智人>其他配套>个人资产管理 API 文档>查询形象资产信息-查询主播下的所有形象

查询形象资产信息-查询主播下的所有形象

最近更新时间：2026-08-07 11:57:00
本文档已由 AI 辅助审校
我的收藏

本页目录：

接口说明

查询客户拥有的形象资产信息，查询某主播下的形象列表。

调用协议

HTTPS + JSON
POST /v2/ivh/crmserver/customerassetservice/getimagebyanchor
Header Content-Type: application/json;charset=utf-8

请求参数

参数
类型
必须
说明
VirtualmanTypeCode
string
是
数智人类型 Code，参考 附录3-数智人类型
AnchorCodes
Array of [string]
否
数智人主播 Code
PageIndex
int
是
当前页
PageSize
int
是
页面大小（最大不超过100）
VirtualmanKey
string
否
数智人 VirtualmanKey
PurchaseType
string
否
购买类型，Lease：租赁，Custom：定制
ModelTarget
string
否
端渲染模型版本，v3/v4_ios/v4_android

返回参数

参数
类型
必须
说明
Virtualmans
Array of [ImageAssetDetail]
是
该主播下的形象列表
说明：
当对应 VirtualmanTypeCode 下未根据接口参数查询到形象时，形象列表返回为空。
Total
int
是
总数
ImageAssetDetail
参数
类型
必须
说明
AnchorName
string
是
数智人主播名称
AnchorCode
string
是
数智人主播 Code
BackgroundChangeable
bool
是
是否支持换背景，true：支持，false：不支持
VirtualmanType
string
是
数智人类型
VirtualmanTypeCode
string
是
数智人类型 Code
VirtualmanKey
string
是
数智人 VirtualmanKey
ClothesName
string
是
数智人服装名称
PoseName
string
是
数智人姿态
Resolution
string
是
数智人分辨率
HeaderImage
string
是
数智人头像图片 URL
PoseImage
string
是
数智人姿态图片 URL
ClothesImage
string
是
数智人服装图片 URL
SupportDriverTypes
Array of [string]
是
数智人支持的驱动类型:
Text：文本驱动
OriginalVoice：原声音频驱动
ModulatedVoice：变声音频驱动
SupportAnchorExtraParams
Array of [SupportAnchorExtraParam]
是
数智人可配置形象参数说明，目前仅包含 3D 服装变色参数
VideoDuration
int64
是
数智人累计调用时长，单位为毫秒
VideoNum
int64
是
数智人累计视频个数
ExpireDate
string
是
资产到期时间，格式：yyyy-MM-dd HH:mm:ss
OriginZoom
string
是
缩放系数，保留三位小数
ReferenceVideoSegmentUrl
string
是
选用视频片段
PurchaseType
string
是
购买类型，Lease:租赁，Custom:定制
SupportRenderTypes
Array of [string]
是
数智人支持的渲染类型:
cloud: 云渲染
client: 端渲染
Gender
int
否
数智人性别，0: 空， 1: 男， 2: 女
ModelDownloadUrl
string
否
数智人端渲染模型资产下载链接
说明：
当入参 VirtualmanKey 不为空，对应形象支持端渲染时，在形象定制完成后30天内可获取到模型资产下载链接。
SupportAnchorExtraParam
参数
类型
必须
说明
Key
string
是
配置项名称
Description
string
是
配置项描述
Type
int
是
配置项的取值类型。1：字符串，2：数值，3：布尔
Value
string[]
是
当前配置项，可配置的字段列表



请求示例

{
    "Header": {},
    "Payload": {
        "VirtualmanTypeCode": "small_sample_2d",
        "AnchorCodes": [
            "wl_pink_skirt_suit_stand"
        ],
        "PageIndex": 1,
        "PageSize": 10
    }
}

返回示例

{
    "Header": {
        "RequestID": "612258c65d2da9401710b06e16e0bed1",
        "SessionID": "gzfa9105ca17313024090292042",
        "DialogID": "",
        "Code": 0,
        "Message": "ok"
    },
    "Payload": {
        "Total": 2,
        "Virtualmans": [
            {
                "AnchorCode": "wl_pink_skirt_suit_stand",
                "AnchorName": "微澜-粉短裙套装-全身站姿",
                "BackgroundChangeable": true,
                "ClothesImage": "https://virtualhuman-cos-test-1251316161.cos.ap-nanjing.myqcloud.com/virtualman-config/00e92768-3d23-40d7-aa39-94df36a44a38-Mask group粉短裙套装.png",
                "ClothesName": "粉短裙套装",
                "ExpireDate": "2024-03-13 21:37:02",
                "HeaderImage": "https://virtualhuman-cos-test-1251316161.cos.ap-nanjing.myqcloud.com/prod/resource-manager/small/57/159/4873/model_11131_20240429141943/header.png",
                "OriginZoom": "1.000",
                "PoseImage": "https://virtualhuman-cos-test-1251316161.cos.ap-nanjing.myqcloud.com/prod/resource-manager/small/57/159/4873/model_11131_20240429141943/static_rgba.png",
                "PoseName": "全身站姿",
                "ReferenceVideoSegmentUrl": "https://virtualhuman-cos-test-1251316161.cos.ap-nanjing.myqcloud.com/prod/resource-manager/small/57/159/4873/model_11131_20240429141943/pv.mp4",
                "Resolution": "1080x1920",
                "SupportAnchorExtraParams": [],
                "SupportDriverTypes": [
                    "Text",
                    "OriginalVoice",
                    "ModulatedVoice"
                ],
                "VideoDuration": 0,
                "VideoNum": 0,
                "VirtualmanKey": "2cc66ae2950e4968880676a055013234",
                "VirtualmanType": "2D小样本（专属）",
                "VirtualmanTypeCode": "small_sample_2d",
                "PurchaseType": "Lease",
                "Gender": 2,
                "SupportRenderTypes": [
                    "cloud"
                ]
            },
            {
                "AnchorCode": "wl_pink_skirt_suit_stand",
                "AnchorName": "微澜-粉短裙套装-全身站姿",
                "ClothesImage": "https://virtualhuman-cos-test-1251316161.cos.ap-nanjing.myqcloud.com/virtualman-config/00e92768-3d23-40d7-aa39-94df36a44a38-Mask group粉短裙套装.png",
                "ClothesName": "粉短裙套装",
                "ExpireDate": "2024-03-13 21:37:02",
                "HeaderImage": "https://virtualhuman-cos-test-1251316161.cos.ap-nanjing.myqcloud.com/prod/resource-manager/small/57/159/4873/model_11131_20240429141943/header.png",
                "OriginZoom": "0.571",
                "PoseImage": "https://virtualhuman-cos-test-1251316161.cos.ap-nanjing.myqcloud.com/prod/resource-manager/small/57/159/4873/model_11131_20240429141943/static_rgba.png",
                "PoseName": "全身站姿",
                "ReferenceVideoSegmentUrl": "https://virtualhuman-cos-test-1251316161.cos.ap-nanjing.myqcloud.com/prod/resource-manager/small/57/159/4873/model_11131_20240429141943/pv.mp4",
                "Resolution": "1920x1080",
                "SupportAnchorExtraParams": [],
                "SupportDriverTypes": [
                    "Text",
                    "OriginalVoice",
                    "ModulatedVoice"
                ],
                "VideoDuration": 0,
                "VideoNum": 0,
                "VirtualmanKey": "fe880d9385304e688f9a8e469370fc90",
                "VirtualmanType": "2D小样本（专属）",
                "VirtualmanTypeCode": "small_sample_2d",
                "PurchaseType": "Lease",
                "Gender": 2,
                "SupportRenderTypes": [
                    "cloud"
                ]
            }
        ]
    }
}

中国站