创建视频合成任务-TTS合成

POST

/openApiDigitalPerson/customer/composeWithTTS

文件格式和大小说明，超过限制会造成合成失败：

背景：
支持JPG/JPEG/PNG图片，最多可同时上传100张背景，图片限制30M。

音频/配音
仅支持mp3、wav、m4a、flac格式

图片：
JPG/JPEG/PNG/GIF格式图片，限制30M

视频：
mp4/webm/mov/flv格式，限制500M

请求参数

Header 参数

authorization

string

必需

所有接口都需 MD5(APP_ID+APP_SECRET+timestamp) 32位小写 APP_SECRET需要我们提供

示例值:

req_from

string

必需

直销客户传C ，代理商传D

示例值:

timestamp

integer

时间戳

必需

示例值:

app_id

string

必需

APPID，开启后获得

示例值:

account

string

可选

代理商的客户账号，直销客户不传，代理商必传

示例值:

19999999999

Body 参数application/json

sceneVOList

array [object {10}]

场景列表

可选

trackPO

object

可选

speechStr

string

播放速度

必需

播放速度，用于tts合成

textList

array[string]

文案列表

必需

文案列表，用于tts合成时的文字传参,sourceType不为0的情况下不支持List，建议整段文字都放在List[0]的位置

digitalPersonWorksId

integer

数字人作品id

可选

orderBy

integer

排序

必需

顺序（升序），用于场景排序

voice

string

音色

必需

用于tts合成时的音色，根据音色列表查询获得，合成音查询接口返回的templateId参数值

sourceType

integer

音色类型

必需

音色查询列表中的sourceType字段

lang

string

语言

必需

语言音色列表languageList.microsoftName

role

string

角色

必需

角色音色列表characterStyleList.microsoftName

style

string

状态

必需

状态音色列表speakingStyleList.microsoftName

isPreview

boolean

可选

是否预览（true-作品预览；false-作品合成）

name

string

xxx作品

必需

作品名

align

enum<string>

VERTICAL

必需

横竖屏 VERTICAL：竖版 HORIZONTAL横版

枚举值:

HORIZONTALVERTICAL

resolution

string

1080P

必需

分辨率

示例

{
  "name": "测试TTS作品",
  "align": "VERTICAL",
  "resolution": "1080P",
  "sceneVOList": [
    {
      "orderBy": 1,
      "voice": "ailun",
      "speechStr": "1",
      "textList": [
        "1111111",
        "222222",
        "333333",
        "4444444"
      ],
      "trackPO": {
        "backGroundImageTrack": {
          "backgroundId": 324,
          "mediaURL": "https://digital-person-daily.oss-cn-hangzhou.aliyuncs.com/FileUpload/1/UID_1/Image/Background/766217fa27993ecdc73d8abf326cbec8_1678409491325.jpg"
        },
        "digitalPersonTrack": [
          {
            "z": 1,
            "digitalPersonAssetsId": 135,
            "previewUrl": "virtual_human/templates/白白_1682217983080_1682242874279632/sample.mp4",
            "scale": null,
            "height": 1920,
            "type": "Video",
            "x": 0,
            "y": 0,
            "mediaURL": "https://digital-person-daily.oss-cn-hangzhou.aliyuncs.com/virtual_human/templates/白白_1682217983080_1682242874279632/白白_1682217983080_1682242874279632.png",
            "width": 1080
          }
        ]
      }
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/openApiDigitalPerson/customer/composeWithTTS' \
--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 '{
    "name": "测试TTS作品",
    "align": "VERTICAL",
    "resolution": "1080P",
    "sceneVOList": [
        {
            "orderBy": 1,
            "voice": "ailun",
            "speechStr": "1",
            "textList": [
                "1111111",
                "222222",
                "333333",
                "4444444"
            ],
            "trackPO": {
                
                "backGroundImageTrack": {
                    "backgroundId": 324,
                    "mediaURL": "https://digital-person-daily.oss-cn-hangzhou.aliyuncs.com/FileUpload/1/UID_1/Image/Background/766217fa27993ecdc73d8abf326cbec8_1678409491325.jpg"
                },
                "digitalPersonTrack": [
                    {
                        "z": 1,
                        "digitalPersonAssetsId": 135,
                        "previewUrl": "virtual_human/templates/白白_1682217983080_1682242874279632/sample.mp4",
                        "scale": null,
                        "height": 1920,
                        "type": "Video",
                        "x": 0,
                        "y": 0,
                        "mediaURL": "https://digital-person-daily.oss-cn-hangzhou.aliyuncs.com/virtual_human/templates/白白_1682217983080_1682242874279632/白白_1682217983080_1682242874279632.png",
                        "width": 1080
                    }
                ]
            }
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

com.yiwise.base.model.bean.ResultModel<java.lang.Long>

code

integer

可选

错误代码，200表示执行成功

默认值:

CommonErrorCode.SUCCESS.getCode()

data

integer

返回的数据

可选

requestId

string

请求唯一标记

可选

resultMsg

string

提示信息

可选

默认值:

CommonErrorCode.SUCCESS.getDesc()

host

string

业务主机名

可选

默认值:

getHostName()

errorStackTrace

string

异常堆栈

可选

示例

{
  "code": 200,
  "data": 2455,
  "requestId": "cNHs1ZpE",
  "resultMsg": "执行成功",
  "host": "develop-007",
  "errorStackTrace": null
}

修改于 2024-12-13 01:50:04

创建视频合成任务-音频文件

更新视频作品名称