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

TTS合成接口(支持标签)

POST
/openApiDigitalPerson/customer/compose
支持标签的音色说明:公用音色sourceType为0和1的支持标签

请求参数

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 参数application/json
voice
string 
音色
必需
sourceType
integer 
声音类型
必需
role
string 
角色
必需
lang
string 
语言
必需
style
string 
风格
必需
speechStr
integer 
必需
语速 0.5-2 步幅0.1
textList
array[string]
必需

不需要下面的功能,可以只传文本,支持标签的音色说明:公用音色sourceType为0和1的支持标签 1.电话标签,其中1234要这样写<say-as interpret-as="telephone" name="电话" alias="幺二三四">1234 2:停顿1s标签:<break time="1000ms"> 3:数值标签:<say-as interpret-as="cardinal" name="数值" alias="十二万三千四百五十六">123456 4:序列标签:<say-as interpret-as="digits" name="序列" alias="七六九八六">769865:多音字标签,<phoneme alphabet="py" ph="zhi1">知

oriText
array[string]
原始文本
必需
volume
integer 
必需
音量 0-100 步幅1
isVideoWork
boolean 
必需
示例
{
	"isVideoWork": true,
	"voice": "XiaoxiaoNeural",
	"lang": "zh-CN",
	"role": "Default",
	"style": "default",
	"sourceType": 1,
	"speechStr": 1,
	"textList": [
		"<speak>详情<say-as interpret-as=\"telephone\" name=\"电话\" alias=\"幺二三四\">1234</say-as>请私信或评论区留<break time=\"1000ms\"></break>言。<say-as interpret-as=\"cardinal\" name=\"数值\" alias=\"十二万三千四百五十六\">123456</say-as>。<say-as interpret-as=\"digits\" name=\"序列\" alias=\"七六九八六\">76986</say-as>。<phoneme alphabet=\"py\" ph=\"zhi1\">知</phoneme>道吗。</speak>"
	],
	"oriText": [
		"详情1234请私信或评论区留言。123456。76986。知道吗。"
	],
	"volume": 100
}

示例代码

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/customer/compose' \
--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 '{
	"isVideoWork": true,
	"voice": "XiaoxiaoNeural",
	"lang": "zh-CN",
	"role": "Default",
	"style": "default",
	"sourceType": 1,
	"speechStr": 1,
	"textList": [
		"<speak>详情<say-as interpret-as=\"telephone\" name=\"电话\" alias=\"幺二三四\">1234</say-as>请私信或评论区留<break time=\"1000ms\"></break>言。<say-as interpret-as=\"cardinal\" name=\"数值\" alias=\"十二万三千四百五十六\">123456</say-as>。<say-as interpret-as=\"digits\" name=\"序列\" alias=\"七六九八六\">76986</say-as>。<phoneme alphabet=\"py\" ph=\"zhi1\">知</phoneme>道吗。</speak>"
	],
	"oriText": [
		"详情1234请私信或评论区留言。123456。76986。知道吗。"
	],
	"volume": 100
}'

返回响应

🟢200成功
application/json
Body
code
integer 
必需
data
object 
必需
duration
string 
必需
durationList
array[number]
必需
url
string 
必需
requestId
string 
必需
resultMsg
string 
必需
host
string 
必需
errorStackTrace
string 
必需
示例
{
    "code": 500,
    "data": {
        "duration": "8.57475",
        "durationList": [
            8.57475
        ],
        "url": "https://digital-person-daily.oss-cn-hangzhou.aliyuncs.com/virtual_human/audio/zhimi_emo_ZE5dPAlf_e495af3c3be611ee9a0a0242ac110009.wav"
    },
    "requestId": "ngVQ5vUH",
    "resultMsg": "成功",
    "host": "DESKTOP-I3F4OHS",
    "errorStackTrace": "成功"
}
修改于 2024-06-14 05:49:48
上一页
删除音频作品
下一页
免费模特列表查询
Built with