接口说明
查询客户拥有的服务资产信息,包括播报小时包、播报并发、交互并发、形象定制配额、声音复刻定制配额、音色小时包、续期服务、端渲染次数包、云端驱动引擎、页面嵌入授权、端渲染 SDK 授权等各类服务资产。
调用协议
HTTPS + JSON
POST /v2/ivh/crmserver/customerassetservice/getserviceasset
Header Content-Type: application/json;charset=utf-8
请求参数
参数 | 类型 | 必须 | 说明 |
ServiceType | string | 否 | |
PageIndex | int | 是 | 当前页 |
PageSize | int | 是 | 页面大小(最大不超过100) |
返回参数
参数 | 类型 | 必须 | 说明 |
ServiceAssetInfos | Array of [ServiceAssetInfo] | 是 | 服务资产列表 |
Total | int | 是 | 总数 |
ServiceAssetInfo
说明:
以下带 *InfoDetail 后缀的字段中,UniversalAssetInfoDetail / UniversalConcurrencyInfoDetail / UniversalHourInfoDetail 为推荐使用的 3 个通用容器,可覆盖全部 ServiceType;其余带具体资产名前缀的字段为兼容保留,仅对老 ServiceType 额外返回。
参数 | 类型 | 必须 | 说明 |
ServiceType | string | 是 | 服务资产类型 |
ExpireDate | string | 是 | 服务资产到期时间,格式:yyyy-MM-dd HH:mm:ss |
UniversalAssetInfoDetail | UniversalAssetInfoDetail | 是 | 定制配额/次数包类资产详情(推荐) |
UniversalConcurrencyInfoDetail | UniversalConcurrencyInfoDetail | 是 | 并发类资产详情(推荐) |
UniversalHourInfoDetail | UniversalHourInfoDetail | 是 | 小时包/月包类资产详情(推荐) |
InteractConcurrencyInfoDetail | InteractConcurrencyInfoDetail | 否 | 2D 小样本(专属)交互并发资产详情 |
BroadcastHourInfoDetail | BroadcastHourInfoDetail | 否 | 2D 小样本(专属)播报小时包资产详情 |
BroadcastConcurrencyInfoDetail | BroadcastConcurrencyInfoDetail | 否 | 2D 小样本(专属)播报并发数资产详情 |
ImageAssetInfoDetail | ImageAssetInfoDetail | 否 | 2D 小样本(专属)形象定制配额资产详情 |
SmallSampleGeneral2DImageAssetInfoDetail | SmallSampleGeneral2DImageAssetInfoDetail | 否 | 2D 小样本(通用)形象定制配额资产详情 |
SmallSampleGeneral2DInteractConcurrencyInfoDetail | SmallSampleGeneral2DInteractConcurrencyInfoDetail | 否 | 2D 小样本(通用)交互并发资产详情 |
SmallSampleGeneral2DBroadcastHourInfoDetail | SmallSampleGeneral2DBroadcastHourInfoDetail | 否 | 2D 小样本(通用)播报小时包资产详情 |
SmallSampleGeneral2DBroadcastConcurrencyInfoDetail | SmallSampleGeneral2DBroadcastConcurrencyInfoDetail | 否 | 2D 小样本(通用)播报并发数资产详情 |
RealMan3DInteractConcurrencyInfoDetail | RealMan3DInteractConcurrencyInfoDetail | 否 | 3D 写实交互并发资产详情 |
RealMan3DBroadcastHourInfoDetail | RealMan3DBroadcastHourInfoDetail | 否 | 3D 写实播报小时包资产详情 |
RealMan3DBroadcastConcurrencyInfoDetail | RealMan3DBroadcastConcurrencyInfoDetail | 否 | 3D 写实播报并发数资产详情 |
TimbreAssetInfoDetail | TimbreAssetInfoDetail | 否 | 声音复刻配额资产详情 |
TimbreHourInfoDetail | TimbreHourInfoDetail | 否 | 音色小时包资产详情 |
UniversalAssetInfoDetail
参数 | 类型 | 必须 | 说明 |
CustomizationNum | int | 是 | 定制/购买总数量 |
RemainNum | int | 是 | 剩余可用数量 |
UniversalConcurrencyInfoDetail
参数 | 类型 | 必须 | 说明 |
Concurrency | int | 是 | 并发数 |
UniversalHourInfoDetail
参数 | 类型 | 必须 | 说明 |
OrderMilliseconds | int | 是 | 播报小时包时长,单位为毫秒 |
RemainMilliseconds | int | 是 | 播报小时包剩余时长,单位为毫秒 |
InteractConcurrencyInfoDetail
参数 | 类型 | 必须 | 说明 |
Concurrency | int | 是 | 并发数 |
BroadcastHourInfoDetail
参数 | 类型 | 必须 | 说明 |
OrderMilliseconds | int | 是 | 播报小时包时长,单位为毫秒 |
RemainMilliseconds | int | 是 | 播报小时包剩余时长,单位为毫秒 |
BroadcastConcurrencyInfoDetail
参数 | 类型 | 必须 | 说明 |
Concurrency | int | 是 | 并发数 |
ImageAssetInfoDetail
参数 | 类型 | 必须 | 说明 |
CustomizationNum | int | 是 | 形象定制数量 |
RemainNum | int | 是 | 形象定制剩余数量 |
SmallSampleGeneral2DImageAssetInfoDetail
参数 | 类型 | 必须 | 说明 |
CustomizationNum | int | 是 | 定制数量 |
RemainNum | int | 是 | 剩余数量 |
SmallSampleGeneral2DInteractConcurrencyInfoDetail
参数 | 类型 | 必须 | 说明 |
Concurrency | int | 是 | 并发数 |
SmallSampleGeneral2DBroadcastHourInfoDetail
参数 | 类型 | 必须 | 说明 |
OrderMilliseconds | int | 是 | 播报小时包时长,单位为毫秒 |
RemainMilliseconds | int | 是 | 播报小时包剩余时长,单位为毫秒 |
SmallSampleGeneral2DBroadcastConcurrencyInfoDetail
参数 | 类型 | 必须 | 说明 |
Concurrency | int | 是 | 并发数 |
RealMan3DInteractConcurrencyInfoDetail
参数 | 类型 | 必须 | 说明 |
Concurrency | int | 是 | 并发数 |
RealMan3DBroadcastHourInfoDetail
参数 | 类型 | 必须 | 说明 |
OrderMilliseconds | int | 是 | 播报小时包时长,单位为毫秒 |
RemainMilliseconds | int | 是 | 播报小时包剩余时长,单位为毫秒 |
RealMan3DBroadcastConcurrencyInfoDetail
参数 | 类型 | 必须 | 说明 |
Concurrency | int | 是 | 并发数 |
TimbreAssetInfoDetail
参数 | 类型 | 必须 | 说明 |
CustomizationNum | int | 是 | 声音复刻数量 |
RemainNum | int | 是 | 声音复刻剩余数量 |
TimbreHourInfoDetail
参数 | 类型 | 必须 | 说明 |
OrderMilliseconds | int | 是 | 音色小时包时长,单位为毫秒 |
RemainMilliseconds | int | 是 | 音色小时包剩余时长,单位为毫秒 |
请求示例
示例1:查询新 ServiceType(仅返回通用容器)
{"Header": {},"Payload": {"ServiceType": "","PageIndex": 1,"PageSize": 10}}
返回
{"Header": {"RequestID": "22b1f973c35bd4fc211235b3c9e04c97","SessionID": "gza802cc9317835792213581376","DialogID": "","Code": 0,"Message": "ok"},"Payload": {"ServiceAssetInfos": [{"ExpireDate": "2025-01-31 10:11:37","ServiceType": "SmallSamplePhoto2DImageAsset","UniversalAssetInfoDetail": {"CustomizationNum": 100,"RemainNum": 0}}],"Total": 1}}
示例 2:查询老 ServiceType(同时返回通用容器和兼容字段)
{"Header": {},"Payload": {"ServiceType": "ImageAsset","PageIndex": 1,"PageSize": 10}}
返回
{"Header": {"RequestID": "841543f804f85a5832d33898bddff5c0","SessionID": "gza802cc9317835796086863127","DialogID": "","Code": 0,"Message": "ok"},"Payload": {"ServiceAssetInfos": [{"ExpireDate": "2025-05-20 14:59:58","ImageAssetInfoDetail": {"CustomizationNum": 6,"RemainNum": 0},"ServiceType": "ImageAsset","UniversalAssetInfoDetail": {"CustomizationNum": 6,"RemainNum": 0}}],"Total": 1}}
示例 3:查询页面嵌入 / 端渲染 SDK 授权(不返回明细字段)
{"Header": {},"Payload": {"ServiceType": "IPassComponentsAsset","PageIndex": 1,"PageSize": 10}}
返回
{"Header": {"RequestID": "5980738868dcd90b66f70b533c1cb065","SessionID": "gza802cc9317835798395694143","DialogID": "","Code": 0,"Message": "ok"},"Payload": {"ServiceAssetInfos": [{"ExpireDate": "2026-05-29 16:58:10","ServiceType": "IPassComponentsAsset"}],"Total": 1}}