NO.1 API

任务：生成视频.gen3

POST

/runway/tasks

请求参数

Body 参数application/json

taskType

enum<string>

版本

必需

枚举值:

europagen3a_turbo

示例值:

europa

internal

boolean

可选

options

object

必需

name

string

可选

seconds

integer

视频时长

可选

text_prompt

string

提示词

必需

seed

integer

种子

必需

exploreMode

boolean

必需

taskType为europa时：
true gen3模式
false gen3 fast模式

watermark

boolean

可选

enhance_prompt

boolean

可选

width

integer

可选

height

integer

可选

assetGroupName

string

可选

init_image

string

参考图片

可选

通过上传接口获得的图片链接 https开头，如果没有必须把字段删除
gen3 turbo模式必须携带该参数

resolution

string

可选

notify_hook

string

可选

示例

{
  "taskType": "europa",
  "internal": false,
  "options": {
    "name": "Gen-3 Alpha  2275386909",
    "seconds": 5,
    "text_prompt": "Handheld camera moving fast, flashlight light, in a white old wall in a old alley at night a black graffiti that spells ‘openai-hk’",
    "seed": 2275386909,
    "exploreMode": true,
    "watermark": false,
    "enhance_prompt": true,
    "width": 1280,
    "height": 768,
    "assetGroupName": "Generative Video",
    "init_image": "通过上传接口获得的图片链接 https开头，如果没有必须把字段删除",
    "resolution": "720p"
  },
  "notify_hook": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/runway/tasks' \
--header 'Content-Type: application/json' \
--data-raw '{
  "taskType": "europa",
  "internal": false,
  "options": {
    "name": "Gen-3 Alpha  2275386909",
    "seconds": 5,
    "text_prompt": "Handheld camera moving fast, flashlight light, in a white old wall in a old alley at night a black graffiti that spells ‘openai-hk’",
    "seed": 2275386909,
    "exploreMode": true,
    "watermark": false,
    "enhance_prompt": true,
    "width": 1280,
    "height": 768,
    "assetGroupName": "Generative Video",
    "init_image": "通过上传接口获得的图片链接 https开头，如果没有必须把字段删除",
    "resolution": "720p"
  },
  "notify_hook": ""
}'

返回响应

🟢200成功

application/json

Body

task

object

必需

string

必需

name

string

必需

image

null

必需

createdAt

string

必需

updatedAt

string

必需

taskType

string

必需

options

object

必需

status

string

必需

error

null

必需

progressText

null

必需

progressRatio

null

必需

estimatedTimeToStartSeconds

number

必需

artifacts

array[string]

必需

sharedAsset

null

必需

示例

{
    "task": {
        "id": "3320e8b1-dc89-41b5-ba1e-0452ae8055e0",
        "name": "Gen-3 Alpha  3914885184",
        "image": null,
        "createdAt": "2024-07-27T01:16:12.096Z",
        "updatedAt": "2024-07-27T01:16:12.140Z",
        "taskType": "gen3a",
        "options": {
            "name": "Gen-3 Alpha  3914885184",
            "seconds": 5,
            "text_prompt": "Handheld camera moving fast, flashlight light, in a white old wall in a old alley at night a black graffiti that spells ‘openai-hk’.",
            "seed": 3914885184,
            "exploreMode": true,
            "watermark": false,
            "enhance_prompt": true,
            "width": 1280,
            "height": 768,
            "assetGroupName": "Generative Video",
            "recordingEnabled": true
        },
        "status": "PENDING",
        "error": null,
        "progressText": null,
        "progressRatio": null,
        "estimatedTimeToStartSeconds": 1.0526315789473684,
        "artifacts": [],
        "sharedAsset": null
    }
}

修改于 2024-10-18 17:45:20

任务：生成视频.gen2

查询：单个任务