API reference

创建舞蹈视频任务

开发中

POST

/viggle/video-task

最后修改时间：2025-05-31 02:13:36

请求体 templateID 跟 videoID 必选一个

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Authorization

string

可选

默认值:

Body 参数application/json

imageID

string

必需

自己上传的模版 ID

bgMode

integer

必需

背景模式 0 白色背景 1 绿色背景 2是模版背景 3是角色背景

modelInfoID

integer

必需

背景模式 2是 V2 3 V2-Turbo 4 V3-Beta

templateID

string

官网模版视频 ID

必需

videoID

string

必需

用户自上传的视频 ID

示例

{
  "imageID": "548a06c6-568c-4d93-80ae-1b6221ea64ba",
  "bgMode": 2,
  "modelInfoID": 3,
  "templateID": "67d1cdaf-d1fb-4bdf-959e-72c5a80b23e4"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/viggle/video-task' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "imageID": "548a06c6-568c-4d93-80ae-1b6221ea64ba",
  "bgMode": 2,
  "modelInfoID": 3,
  "templateID": "67d1cdaf-d1fb-4bdf-959e-72c5a80b23e4"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

string

必需

reason

string

必需

data

object

必需

taskID

string

必需

mqType

integer

必需

fee

integer

价格倍数

必需

示例

{
    "code": 0,
    "message": "ok",
    "ts": "",
    "reason": "",
    "data": {
        "taskID": "7bf6fa01-607a-4420-87a9-92592f95ac9c",
        "mqType": 0
    },
    "fee": 2
}

上传舞蹈视频模板

获取任务结果