一知开放平台
  1. 互动素材准备和编辑
一知开放平台
  • 账户权益管理API
    • 开发说明
    • 实际登陆接口
      POST
    • 订单列表-用户充值消耗明细
      POST
    • 登录接口openApi
      POST
    • 数字人作品校验
      POST
    • 充值
      POST
    • 用户资源详情查询
      GET
    • 消息已读接口
      POST
    • 登出接口openApi
      POST
    • 更改账户状态
      POST
    • 获取用户直播并发详情
      GET
    • 消息列表
      POST
    • 创建用户
      POST
  • 短视频离线合成API
    • 调用须知
    • 常见问题
    • 流式TTS-音色需报备
    • 短视频作品合成、编辑和查询
      • 创建视频合成任务-音频文件
      • 创建视频合成任务-TTS合成
      • 更新视频作品名称
      • 合成任务状态查询接口
      • 查询合成视频作品列表
      • 删除视频作品
      • 复制短视频作品
      • 视频作品统计
      • 代理商查询其用户的所有视频作品列表
      • 预览短视频
      • 查询预览效果接口(轮询)
      • 模版列表
      • 模版详情
    • 音频作品合成、编辑和查询
      • 合成音频作品
      • 查询音频作品的详情
      • 音频作品的列表
      • 音频作品统计
      • TTS合成接口
      • 代理商查询其用户的所有音频作品列表
      • 删除音频作品
      • TTS合成接口(支持标签)
    • 数字人和音色模型
      • 免费模特列表查询
      • 定制模特列表查询
      • 删除模特资产
      • AI合成音列表查询
      • AI合成音查询
      • 定制
      • 音色定制
      • 更新数字人模特名称
      • 更新音色资产名称
      • 删除定制声音资产
      • 同步至短视频平台
      • 同步至直播平台
    • 素材准备和编辑
      • 配音-录音上传
      • 获取上传的录音
      • 背景上传
      • 背景查询-静态背景
      • 背景查询-获取上传的背景
      • 根据音频生成字幕
      • 解析抖音短视频
      • 生成字幕
      • 获取oss签名
      • 获取oss上传ststoken
  • 直播OpenApi
    • 调用须知
    • 常见问题
    • 实时信息同步
    • 直播阿凡达模式WS连接
    • 直播流程相关
      • 直播间详情
      • 添加直播间素材,创建直播间
      • 开始直播
      • 获取开播的详情
      • 结束直播
      • 插入播放音频
      • 获取当前播放的音频信息
      • 跳转到指定场景指定音频播放
      • 直播间ping后端的接口 10s/次轮训
      • 获取当前账号正在直播的直播间信息
      • 导购商品手动加到插播列表
      • 开播前更新直播间配置
      • 直播中更新直播间素材
      • 直播中插入播放副本到列表
      • 预览直播接口
      • 获取预览链接
      • 获取当前账号正在直播的直播间列表
      • 直播并发列表接口
      • 删除直播间
      • 更新直播间的推流地址
      • 场景隐藏和公开
      • 删除当前已有的音频
      • 新增场景
      • 场景排序
    • 直播素材准备和编辑
      • 背景上传
      • 获取背景的集合
      • 创建素材
      • 素材列表
      • 音色列表
      • 新建商品
      • 类目列表
      • 删除商品
      • 商品列表
      • 编辑商品
  • 数字人互动
    • 互动素材准备和编辑
      • 删除素材
        GET
      • 背景上传
        POST
      • 素材列表
        POST
      • 获取背景的集合
        GET
      • 创建素材
        POST
    • 互动TalkTo版
      • 创建直播间
      • 开始直播
      • 对话接口
      • 退出直播
  1. 互动素材准备和编辑

创建素材

POST
/openApiDigitalPerson/liveProcess/createMaterial

请求参数

Header 参数
authorization
string 
必需
所有接口都需 MD5(APP_ID+APP_SECRET+timestamp) 32位小写 APP_SECRET需要我们提供
示例值:
{{auth|md5}}
req_from
string 
必需
直销客户传C ,代理商传D
示例值:
C
timestamp
integer 
时间戳
必需
示例值:
{{timestamp}}
app_id
string 
必需
APPID,开启后获得
示例值:
{{appId}}
account
string 
可选
代理商的客户账号,直销客户不传,代理商必传
示例值:
19999999999
Body 参数multipart/form-data
file
file 
可选
示例值:
file://E:\yiwisetest\图片\16945868647245f4b1fc647595618803894181b6a800a.gif
materialName
string 
可选
名称,除上传文本之外这个字段必传
示例值:
1111.gif
liveMaterial
string 
可选
IMAGE :0 图片
VOICE :1 音频
VIDEO :2 视频
TXT :3 文本
示例值:
0
context
string 
文本内容
可选
materialUrl
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/createMaterial' \
--header 'authorization: {{auth|md5}}' \
--header 'req_from: C' \
--header 'timestamp: {{timestamp}}' \
--header 'app_id: {{appId}}' \
--header 'account: 19999999999' \
--form 'file=@"E:\\yiwisetest\\图片\\16945868647245f4b1fc647595618803894181b6a800a.gif"' \
--form 'materialName="1111.gif"' \
--form 'liveMaterial="0"' \
--form 'context=""' \
--form 'materialUrl=""'

返回响应

🟢200成功
application/json
Body
com.yiwise.base.model.bean.ResultModel<com.yiwise.digitalperson.entity.vo.LiveMaterialLibraryVO>
code
integer 
可选
错误代码,200表示执行成功
默认值:
CommonErrorCode.SUCCESS.getCode()
data
object (LiveMaterialLibraryVO) 
返回的数据
可选
liveMaterialLibraryId
integer 
可选
素材id,上传视频、音频和图片的时候返回这个值
materialName
string 
素材上传时的名称
可选
materialUrl
string 
可选
素材链接,上传视频、音频和图片的时候返回这个值
txtContent
string 
可选
文本内容,上传文本的时候有这个值
liveMaterialTextId
integer 
可选
文本素材id 上传文本的时候有这个值
requestId
string 
请求唯一标记
可选
resultMsg
string 
提示信息
可选
默认值:
CommonErrorCode.SUCCESS.getDesc()
host
string 
业务主机名
可选
默认值:
getHostName()
errorStackTrace
string 
异常堆栈
可选
示例
{
  "code": 0,
  "data": {
    "liveMaterialLibraryId": 0,
    "materialName": "",
    "liveGoodsLibraryId": 0,
    "materialUrl": "",
    "vTime": 0,
    "avatar": "",
    "vFeatureUrl": "",
    "txtContent": "",
    "liveMaterialTextId": 0,
    "createTime": "",
    "materialSize": 0,
    "materialType": 0
  },
  "requestId": "",
  "resultMsg": "",
  "host": "",
  "errorStackTrace": ""
}
上一页
获取背景的集合
下一页
创建直播间
Built with