- 账户权益管理API
- 短视频离线合成API
- 直播OpenApi
- 调用须知
- 常见问题
- 实时信息同步
- 直播阿凡达模式WS连接
- 直播流程相关
- 直播间详情GET
- 添加直播间素材,创建直播间POST
- 开始直播POST
- 获取开播的详情POST
- 结束直播POST
- 插入播放音频POST
- 获取当前播放的音频信息POST
- 跳转到指定场景指定音频播放POST
- 直播间ping后端的接口 10s/次轮训POST
- 获取当前账号正在直播的直播间信息GET
- 导购商品手动加到插播列表POST
- 开播前更新直播间配置POST
- 直播中更新直播间素材POST
- 直播中插入播放副本到列表POST
- 预览直播接口POST
- 获取预览链接POST
- 获取当前账号正在直播的直播间列表GET
- 直播并发列表接口GET
- 删除直播间 DELETE
- 更新直播间的推流地址POST
- 场景隐藏和公开POST
- 删除当前已有的音频POST
- 新增场景POST
- 场景排序POST
- 直播素材准备和编辑
- 数字人互动
直播中更新直播间素材
POST
/openApiDigitalPerson/liveProcess/updateMaterial
请求参数
Header 参数
authorization
string
必需
示例值:
{{auth|md5}}
req_from
string
必需
示例值:
C
timestamp
integer
时间戳
示例值:
{{timestamp}}
app_id
string
必需
示例值:
{{appId}}
account
string
可选
示例值:
19999999999
Body 参数application/json
goodsList
array[object (LiveGoodsLibraryVO) {12}]
商品列表
liveScenePOList
array[object (LiveScenePO) {23}]
可选
goodsCategoryName
string
商品类目名称
liveGoodsLibraryId
integer
可选
goodsName
string
商品名
goodsDescribe
string
可选
categoryCode
integer
商品类目码
coverImageUrl
string
商品封面
createUserId
integer
创建者
updateUserId
integer
修改者
createTime
string
可选
updateTime
string
可选
enabledStatus
integer
可选
liveRuleList
array[object (LiveRulePO) {16}]
互动规则
id
string
可选
liveRoomId
integer
可选
type
enum<string>
规则类型
枚举值:
KEYSGUIDE_GOODONLINE_NUMTOTAL_VIEW_NUMLIVE_DURATIONLIVE_INTERVALGIFTUPVOTE_NUMWATCH
isUse
boolean
是否启用
thres
integer
阈值
answer
object (AnswerPO)
问答
corpusList
array[object (LiveMaterialTextPOExt) {34}]
语料
replyType
enum<string>
回复类型
枚举值:
TEXTAUDIO
replySource
enum<string>
回复者
枚举值:
ANCHORASSISTANT
liveGoodsLibraryIds
array[integer]
适用的商品id集合
enableScope
integer
可选
{@link com.yiwise.digitalperson.entity.enums.EnableScopeEnum}
默认值:
0
name
string
规则名
ruleMinute
integer
分钟
ruleThres
integer
规则触发阈值
answerType
integer
可选
默认值:
0
status
integer
可选
1-训练成功
2-训练失败
默认值:
0
guideGoodsList
array[object (GuideGoodsPO) {27}]
商品导购
id
string
可选
liveRoomId
integer
可选
liveMaterialLibraryId
integer
素材id
liveGoodsLibraryId
integer
商品id
materialName
string
素材名
materialUrl
string
素材url
cover
string
素材封面
materialDuration
integer
素材时长
enableScope
integer
可选
{@link com.yiwise.digitalperson.entity.enums.EnableScopeEnum}
liveGoodsLibraryIds
array[integer]
启用的商品ids
enableMatting
integer
可选
t0
integer
算法抠图参数
t1
integer
可选
k
integer
可选
middleMattingUrl
string
可选
guideRuleList
array[object (GuideRulePO) {4}]
可选
corpusList
array[object (LiveMaterialTextPOExt) {34}]
回复语料
replySource
enum<string>
回复者
枚举值:
ANCHORASSISTANT
replyType
enum<string>
回复类型
枚举值:
TEXTAUDIO
ruleMinute
integer
分钟
ruleThres
integer
规则阈值
x
number
X坐标
默认值:
0.0
y
number
Y坐标
默认值:
0.0
width
number
素材宽
默认值:
0.0
height
number
可选
默认值:
0.0
backgroundAudioUrl
string
背景音链接
backgroundVolume
number
背景音音量
默认值:
1.0
liveRoomConfig
object (LiveRoomConfigPO)
全局配置
id
string
可选
liveRoomId
integer
可选
type
enum<string>
直播平台
枚举值:
DOUYINTAOBAOJDKUAISHOUWECHATVIDEOWEIPINHUIMEITUANALIBABAGUOJIPINDUODUOOTHER
url
string
直播间连接
minute
integer
分钟
thres
integer
阈值
volume
integer
可选
liveType
enum<string>
直播类型
枚举值:
ONE_PEOPLETWO_PEOPLE
lang
string
语言-助播
role
string
人物角色-助播
style
string
说话风格-助播
sourceType
integer
tts类型-助播
默认值:
0
voice
string
tts音色-助播
speed
number
语速-助播
ttsVolume
number
音量-助播
interrupt
boolean
是否打断
aiAnswer
boolean
是否开启问答助手
audioAssetsType
enum<string>
可选
枚举值:
FREENOT_BOUGHTBOUGHTCUSTOMIZEDTO_BE_TRAINEDCUSTOMIZINGCUSTOMIZED_FAILEXPIREDvipTRAIN_FAILAUDIT_UNPASS
answerType
integer
可选
answerMinute
integer
问答间隔
answerThres
integer
问答阈值
logId
string
可选
instanceTitle
string
可选
liveRoomId
integer
自增主键
name
string
直播间名
avatar
string
封面
status
enum<string>
状态
枚举值:
LIVINGTOLIVE
lastLiveTime
string
可选
enabledStatus
integer
可选
liveDuration
integer
直播时长
streamUrl
string
拉流地址
pushUrl
string
推流地址
rtsUrl
string
RTS推流地址
rtmpUrl
string
RTMP推流地址
livePushUrl
string
直播间推流地址
pushSecret
string
推流密钥
userId
integer
可选
livingScene
string
当前直播的场景
livingAudio
string
当前直播的话术
sessionId
string
可选
isChat
boolean
是否开启聊天互动
loopType
enum<string>
循环方式
枚举值:
SINGLE_LOOPALL_LOOPRANDOM
instanceIp
string
实例运行所在机器
algIp
string
算法GPU服务器
createTime
string
可选
updateTime
string
更新时间
ifTemplate
integer
可选
firstFrameUrl
string
直播视频首帧图
示例
{
"goodsList": [
{
"liveScenePOList": [
{
"id": "string",
"liveRoomId": 0,
"liveGoodsLibraryId": 0,
"isHide": "false",
"name": "string",
"orderBy": 0,
"createTime": "string",
"updateTime": "string",
"voice": "string",
"speed": 0,
"volume": 0,
"duration": 0,
"lang": "string",
"role": "string",
"customizeVersion": 0,
"style": "string",
"sourceType": "0",
"audioAssetsType": "FREE",
"dialogFlowList": [
{
"duration": 0,
"url": "string",
"orderBy": 0,
"featureUrl": "string",
"materialName": "string",
"audioId": "string",
"wavPath": "string",
"ruleId": "string",
"guideMaterialLibraryId": 0,
"guideMaterialAvatar": "string",
"guideGoodsId": "string",
"audioUrl": "string",
"copyList": [
{
"liveMaterialLibraryId": 0,
"materialName": "string",
"liveGoodsLibraryId": 0,
"materialUrl": "string",
"vTime": 0,
"avatar": "string",
"vFeatureUrl": "string",
"txtContent": "string",
"liveMaterialTextId": 0,
"createTime": "string",
"materialSize": 0,
"materialType": 0,
"txtShow": "string",
"enableMatting": 0,
"t0": 0,
"t1": 0,
"k": 0,
"middleMattingUrl": "string",
"liveMaterialLibrary": "COMMON",
"liveMaterial": "IMAGE",
"userId": 0,
"tenantId": 0
}
],
"backgroundAudioUrl": "string",
"backgroundVolume": "1.0",
"x": "0.0",
"y": "0.0",
"width": "0.0",
"height": "0.0",
"replyType": "TEXT",
"materialTextUrlBOList": [
{
"audioId": "string",
"liveSceneId": "string",
"url": "string",
"featureUrl": "string",
"duration": 0,
"text": "string",
"fileName": "string"
}
],
"status": "0",
"liveMaterialTextId": 0,
"liveGoodsLibraryId": 0,
"txtContent": "string",
"createUserId": 0,
"updateUserId": 0,
"tenantId": 0,
"createTime": "string",
"updateTime": "string",
"enabledStatus": 0,
"materialUrl": "string",
"txtShow": "string",
"liveMaterialLibraryId": 0
}
],
"ruleFlowList": [
{
"duration": 0,
"url": "string",
"orderBy": 0,
"featureUrl": "string",
"materialName": "string",
"audioId": "string",
"wavPath": "string",
"ruleId": "string",
"guideMaterialLibraryId": 0,
"guideMaterialAvatar": "string",
"guideGoodsId": "string",
"audioUrl": "string",
"copyList": [
{
"liveMaterialLibraryId": 0,
"materialName": "string",
"liveGoodsLibraryId": 0,
"materialUrl": "string",
"vTime": 0,
"avatar": "string",
"vFeatureUrl": "string",
"txtContent": "string",
"liveMaterialTextId": 0,
"createTime": "string",
"materialSize": 0,
"materialType": 0,
"txtShow": "string",
"enableMatting": 0,
"t0": 0,
"t1": 0,
"k": 0,
"middleMattingUrl": "string",
"liveMaterialLibrary": "COMMON",
"liveMaterial": "IMAGE",
"userId": 0,
"tenantId": 0
}
],
"backgroundAudioUrl": "string",
"backgroundVolume": "1.0",
"x": "0.0",
"y": "0.0",
"width": "0.0",
"height": "0.0",
"replyType": "TEXT",
"materialTextUrlBOList": [
{
"audioId": "string",
"liveSceneId": "string",
"url": "string",
"featureUrl": "string",
"duration": 0,
"text": "string",
"fileName": "string"
}
],
"status": "0",
"liveMaterialTextId": 0,
"liveGoodsLibraryId": 0,
"txtContent": "string",
"createUserId": 0,
"updateUserId": 0,
"tenantId": 0,
"createTime": "string",
"updateTime": "string",
"enabledStatus": 0,
"materialUrl": "string",
"txtShow": "string",
"liveMaterialLibraryId": 0
}
],
"materialList": [
{
"x": 0,
"y": 0,
"z": 0,
"width": 0,
"height": 0,
"avatar": "string",
"frameWidth": 0,
"frameHeight": 0,
"blur": 0,
"blurUrl": "string",
"originUrl": "string",
"lock": true,
"position": "string",
"status": "0",
"liveMaterialLibraryId": 0,
"materialName": "string",
"materialType": 0,
"libraryType": 0,
"liveGoodsLibraryId": 0,
"materialUrl": "string",
"vTime": 0,
"materialSize": 0,
"vFeatureUrl": "string",
"enableMatting": 0,
"t0": 0,
"t1": 0,
"k": 0,
"middleMattingUrl": "string",
"createUserId": 0,
"updateUserId": 0,
"tenantId": 0,
"createTime": "string",
"updateTime": "string",
"enabledStatus": 0,
"asrRes": "string"
}
],
"liveDigitalPersonAssetsList": [
{
"x": 0,
"y": 0,
"z": 0,
"width": 0,
"height": 0,
"frameWidth": 0,
"frameHeight": 0,
"ali_green": true,
"lock": true,
"digitalPersonAssetsId": 0,
"name": "string",
"avatar": "string",
"squareAvatar": "string",
"previewUrl": "string",
"generalPreviewUrl": "string",
"userId": 0,
"tenantId": 0,
"templateId": "string",
"liveTemplateId": "string",
"status": "DRAFT",
"type": "FREE",
"liveType": "FREE",
"isUse": true,
"price": 0,
"isAutoMatting": true,
"thres": 0,
"mattingUrl": "string",
"createTime": "string",
"updateTime": "string",
"hot": 0,
"tagType": 0,
"description": "string",
"t0": 0,
"t1": 0,
"k": 0,
"isMatting": true,
"useStatus": 0,
"trainFailContent": "string",
"trainStartTime": "string",
"trainEndTime": "string",
"reviewPassTime": "string",
"squeezeUrl": "string",
"templateValidLength": 0,
"autoValidEnd": true,
"videoDuration": 0,
"trainAudioUrl": "string",
"agentUserId": 0,
"rangeEnabled": 0,
"xrangeStartRatio": 0,
"xrangeEndRatio": 0,
"yrangeStartRatio": 0,
"yrangeEndRatio": 0,
"startFrameAvatar": "string",
"expireDate": "string",
"aliGreen": true,
"scenesType": 0,
"version": 0,
"platform": 0
}
],
"backGroundImage": {
"frameWidth": 0,
"frameHeight": 0,
"blur": 0,
"blurUrl": "string",
"originUrl": "string",
"backgroundId": 0,
"userId": 0,
"tenantId": 0,
"categorizeId": 0,
"name": "string",
"materialSize": 0,
"recentUsageTime": 0,
"isBuilt": 0,
"enabledStatus": 0,
"url": "string",
"createTime": "string",
"updateTime": "string"
}
}
],
"goodsCategoryName": "string",
"liveGoodsLibraryId": 0,
"goodsName": "string",
"goodsDescribe": "string",
"categoryCode": 0,
"coverImageUrl": "string",
"createUserId": 0,
"updateUserId": 0,
"createTime": "string",
"updateTime": "string",
"enabledStatus": 0
}
],
"liveRuleList": [
{
"id": "string",
"liveRoomId": 0,
"type": "KEYS",
"isUse": true,
"thres": 0,
"answer": {
"id": "string",
"keys": [
"string"
]
},
"corpusList": [
{
"duration": 0,
"url": "string",
"orderBy": 0,
"featureUrl": "string",
"materialName": "string",
"audioId": "string",
"wavPath": "string",
"ruleId": "string",
"guideMaterialLibraryId": 0,
"guideMaterialAvatar": "string",
"guideGoodsId": "string",
"audioUrl": "string",
"copyList": [
{
"liveMaterialLibraryId": 0,
"materialName": "string",
"liveGoodsLibraryId": 0,
"materialUrl": "string",
"vTime": 0,
"avatar": "string",
"vFeatureUrl": "string",
"txtContent": "string",
"liveMaterialTextId": 0,
"createTime": "string",
"materialSize": 0,
"materialType": 0,
"txtShow": "string",
"enableMatting": 0,
"t0": 0,
"t1": 0,
"k": 0,
"middleMattingUrl": "string",
"liveMaterialLibrary": "COMMON",
"liveMaterial": "IMAGE",
"userId": 0,
"tenantId": 0
}
],
"backgroundAudioUrl": "string",
"backgroundVolume": "1.0",
"x": "0.0",
"y": "0.0",
"width": "0.0",
"height": "0.0",
"replyType": "TEXT",
"materialTextUrlBOList": [
{
"audioId": "string",
"liveSceneId": "string",
"url": "string",
"featureUrl": "string",
"duration": 0,
"text": "string",
"fileName": "string"
}
],
"status": "0",
"liveMaterialTextId": 0,
"liveGoodsLibraryId": 0,
"txtContent": "string",
"createUserId": 0,
"updateUserId": 0,
"tenantId": 0,
"createTime": "string",
"updateTime": "string",
"enabledStatus": 0,
"materialUrl": "string",
"txtShow": "string",
"liveMaterialLibraryId": 0
}
],
"replyType": "TEXT",
"replySource": "ANCHOR",
"liveGoodsLibraryIds": [
0
],
"enableScope": "0",
"name": "string",
"ruleMinute": 0,
"ruleThres": 0,
"answerType": "0",
"status": "0"
}
],
"guideGoodsList": [
{
"id": "string",
"liveRoomId": 0,
"liveMaterialLibraryId": 0,
"liveGoodsLibraryId": 0,
"materialName": "string",
"materialUrl": "string",
"cover": "string",
"materialDuration": 0,
"enableScope": 0,
"liveGoodsLibraryIds": [
0
],
"enableMatting": 0,
"t0": 0,
"t1": 0,
"k": 0,
"middleMattingUrl": "string",
"guideRuleList": [
{
"ruleId": "string",
"type": "KEYS",
"keys": [
"string"
],
"thres": 0
}
],
"corpusList": [
{
"duration": 0,
"url": "string",
"orderBy": 0,
"featureUrl": "string",
"materialName": "string",
"audioId": "string",
"wavPath": "string",
"ruleId": "string",
"guideMaterialLibraryId": 0,
"guideMaterialAvatar": "string",
"guideGoodsId": "string",
"audioUrl": "string",
"copyList": [
{
"liveMaterialLibraryId": 0,
"materialName": "string",
"liveGoodsLibraryId": 0,
"materialUrl": "string",
"vTime": 0,
"avatar": "string",
"vFeatureUrl": "string",
"txtContent": "string",
"liveMaterialTextId": 0,
"createTime": "string",
"materialSize": 0,
"materialType": 0,
"txtShow": "string",
"enableMatting": 0,
"t0": 0,
"t1": 0,
"k": 0,
"middleMattingUrl": "string",
"liveMaterialLibrary": "COMMON",
"liveMaterial": "IMAGE",
"userId": 0,
"tenantId": 0
}
],
"backgroundAudioUrl": "string",
"backgroundVolume": "1.0",
"x": "0.0",
"y": "0.0",
"width": "0.0",
"height": "0.0",
"replyType": "TEXT",
"materialTextUrlBOList": [
{
"audioId": "string",
"liveSceneId": "string",
"url": "string",
"featureUrl": "string",
"duration": 0,
"text": "string",
"fileName": "string"
}
],
"status": "0",
"liveMaterialTextId": 0,
"liveGoodsLibraryId": 0,
"txtContent": "string",
"createUserId": 0,
"updateUserId": 0,
"tenantId": 0,
"createTime": "string",
"updateTime": "string",
"enabledStatus": 0,
"materialUrl": "string",
"txtShow": "string",
"liveMaterialLibraryId": 0
}
],
"replySource": "ANCHOR",
"replyType": "TEXT",
"ruleMinute": 0,
"ruleThres": 0,
"x": "0.0",
"y": "0.0",
"width": "0.0",
"height": "0.0",
"backgroundAudioUrl": "string",
"backgroundVolume": "1.0"
}
],
"liveRoomConfig": {
"id": "string",
"liveRoomId": 0,
"type": "DOUYIN",
"url": "string",
"minute": 0,
"thres": 0,
"volume": 0,
"liveType": "ONE_PEOPLE",
"lang": "string",
"role": "string",
"style": "string",
"sourceType": "0",
"voice": "string",
"speed": 0,
"ttsVolume": 0,
"interrupt": true,
"aiAnswer": true,
"audioAssetsType": "FREE",
"answerType": 0,
"answerMinute": 0,
"answerThres": 0
},
"logId": "string",
"instanceTitle": "string",
"liveRoomId": 0,
"name": "string",
"avatar": "string",
"status": "LIVING",
"lastLiveTime": "string",
"enabledStatus": 0,
"liveDuration": 0,
"streamUrl": "string",
"pushUrl": "string",
"rtsUrl": "string",
"rtmpUrl": "string",
"livePushUrl": "string",
"pushSecret": "string",
"userId": 0,
"livingScene": "string",
"livingAudio": "string",
"sessionId": "string",
"isChat": true,
"loopType": "SINGLE_LOOP",
"instanceIp": "string",
"algIp": "string",
"createTime": "string",
"updateTime": "string",
"ifTemplate": 0,
"firstFrameUrl": "string"
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/openApiDigitalPerson/liveProcess/updateMaterial' \
--header 'authorization: {{auth|md5}}' \
--header 'req_from: C' \
--header 'timestamp: {{timestamp}}' \
--header 'app_id: {{appId}}' \
--header 'account: 19999999999' \
--header 'Content-Type: application/json' \
--data-raw ''
返回响应
🟢200成功
application/json
Body
code
integer
可选
data
string
可选
requestId
string
可选
resultMsg
string
可选
host
string
可选
errorStackTrace
string
可选
示例
{
"code": 0,
"data": "",
"requestId": "",
"resultMsg": "",
"host": "",
"errorStackTrace": ""
}
修改于 2024-01-16 02:23:07