发起新任务 - API中心

请求参数

Header 参数

Authorization

string

可选

默认值:

sk-12345678abcdefg

Body 参数application/json

添加Runway任务参数

callbackUrl

string

回调通知地址

可选

示例值:

http://baidu.com

images

array[object (AddRunwayTaskImageDTO) {2}]

图片资源信息

必需

frameIndex

integer <int32>

可选

图片索引，第一张为0，最后一张为1

示例值:

image

string

图片地址

必需

示例值:

http://baidu.com

ratio

string

必需

图片宽度与高度之比，16:9,9:16

示例值:

16:9

seconds

integer <int32>

必需

视频时长，5 或 10

示例值:

taskType

string

必需

任务类型，gen3a_turbo,gen3a,gen2

示例值:

gen3a_turbo

textPrompt

string

提示词

可选

>= 0 字符<= 2000 字符

示例

{
  "callbackUrl": "http://baidu.com",
  "images": [
    {
      "frameIndex": 0,
      "image": "http://baidu.com"
    }
  ],
  "ratio": "16:9",
  "seconds": 10,
  "taskType": "gen3a_turbo",
  "textPrompt": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

*/*

Body

接口调用返回结果

code

integer <int32>

必需

返回结果状态码，0为成功，非0为失败

示例值:

message

string

返回结果说明信息

可选

示例值:

执行成功

result

object (RunwayTaskVO)

返回结果数据

可选

callbackUrl

string

回调通知地址

可选

示例值:

http://baidu.com

createdTime

string

创建时间

可选

示例值:

yyyy-MM-dd HH:mm:ss

error

string

错误信息

可选

string

必需

Runway任务ID

示例值:

123456

images

array[object (RunwayTaskImageVO) {6}]

图片资源信息

必需

modifiedTime

string

修改时间

可选

示例值:

yyyy-MM-dd HH:mm:ss

ratio

string

必需

图片宽度与高度之比，16:9,9:16

示例值:

16:9

seconds

integer <int32>

必需

视频时长，5 或 10

示例值:

taskStatusCode

integer <int32>

必需

任务状态，0：新增；1：排队中；2：视频制作中；3：视频制作成功；4：视频制作失败

示例值:

taskType

string

必需

任务类型，gen3a_turbo,gen3a,gen2

示例值:

gen3a_turbo

textPrompt

string

提示词

可选

示例值:

fly

videoUrl

string

视频下载地址

可选

示例值:

http://baidu.com

success

boolean

是否成功标志

必需

示例值:

true

timestamp

integer <int64>

返回的时间戳

可选

示例

{
  "code": 0,
  "message": "执行成功",
  "result": {
    "callbackUrl": "http://baidu.com",
    "createdTime": "yyyy-MM-dd HH:mm:ss",
    "error": "string",
    "id": "123456",
    "images": [
      {
        "createdTime": "yyyy-MM-dd HH:mm:ss",
        "frameIndex": 0,
        "imageActual": "string",
        "imageOrg": "string",
        "modifiedTime": "yyyy-MM-dd HH:mm:ss",
        "taskId": "123456"
      }
    ],
    "modifiedTime": "yyyy-MM-dd HH:mm:ss",
    "ratio": "16:9",
    "seconds": 10,
    "taskStatusCode": 0,
    "taskType": "gen3a_turbo",
    "textPrompt": "fly",
    "videoUrl": "http://baidu.com"
  },
  "success": true,
  "timestamp": 0
}

🟢201成功

🟠401没有权限

🟠403禁止访问

🟠404记录不存在