提酒映画

简易合成

POST

/taskcloud/fastadd

责任人：开发部

简易合成。无需构建数字人，仅通过少量参数，合成简单场景的视频

请求参数

Header 参数

token

string

校验码

必需

Body 参数application/json

materialUrl

string

必需

素材URL,支持mp4(h264),jpg,png,webp,最大不能超过1080P

audioUrl

string

可选

音频URL,仅支持mp3,wav,m4a;音频输入和文本输入二选一

width

number

必需

视频宽度（需要与素材尺寸一致，大于实际素材尺寸，请添加enhance参数）

>= 0<= 1920

height

number

必需

视频高度（需要与素材尺寸一致）

>= 0<= 1920

timbreId

string

可选

音色ID,从/audiotts/getreader接口中获取

textContent

string

可选

文本，最大不能超过300字，注意语言与timbreId设置一致

callbackUrl

string

可选

回调地址，支持公网访问，使用GET回调，返回参数videoId，videoUrl，errcode，errmsg

enhance

number

可选

是否增强画质（选填）0不增强，1增强

示例

{
	"materialUrl": "https://t-9.oss-cn-beijing.aliyuncs.com/aihuman/1872463738406309888/8fd181945ad0a5e8a40c1618a7c131f1.jpg",
	"width":1152,
	"height":1480,
	"timbreId": "longjin",
	"textContent": "吾毕生之愿，欲筑一土墙院子，门内多栽竹树花草，清晨日尚未出，望东海一片红霞，薄暮斜阳满树，立院中高处，俱见烟水平桥。"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/taskcloud/fastadd' \
--header 'token;' \
--header 'Content-Type: application/json' \
--data-raw '{
	"materialUrl": "https://t-9.oss-cn-beijing.aliyuncs.com/aihuman/1872463738406309888/8fd181945ad0a5e8a40c1618a7c131f1.jpg",
	"width":1152,
	"height":1480,
	"timbreId": "longjin",
	"textContent": "吾毕生之愿，欲筑一土墙院子，门内多栽竹树花草，清晨日尚未出，望东海一片红霞，薄暮斜阳满树，立院中高处，俱见烟水平桥。"
}'

返回响应

🟢201成功

application/json

Body

timestamp

string

时间戳

必需

data

object

返回值

必需

videoId

string

视频任务ID

必需

视频合成任务ID

status

integer

状态码

必需

message

string

说明文本

必需

非200状态，则标注错误原因

示例

{
    "timestamp": "2024-12-28 15:56:42",
    "data": {
        "videoId": "1872914559929552896"
    },
    "status": 200,
    "message": "请求成功"
}

获得提审结果

新增任务