图生视频

POST

/runway/v1/image_to_video

将输入图片转换为视频的服务

请求参数

Header 参数

Authorization

string

可选

Body 参数application/json

promptImage

必需

One of

string<uri>

array[object (ImagePosition) {2}]

输入图片的HTTPS URL或数据URI (base64)

model

enum<string>

使用的模型版本

必需

枚举值:

gen3a_turbo

seed

integer

可选

随机种子，用于生成可重复的结果

>= 0<= 4294967295

promptText

string

可选

详细描述期望生成的视频内容

<= 512 字符

watermark

boolean

可选

是否包含Runway水印

默认值:

false

duration

enum<integer>

可选

输出视频的时长（秒）

枚举值:

510

默认值:

ratio

enum<string>

输出视频的分辨率

可选

枚举值:

1280:768768:1280

示例

{
    "promptImage": "https://example.com/image.jpg",
    "model": "gen3a_turbo",
    "duration": 10,
    "ratio": "1280:768",
    "promptText": "一个宁静的风景转场",
    "watermark": false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/runway/v1/image_to_video' \
--header 'Content-Type: application/json' \
--data-raw '{
    "promptImage": "https://example.com/image.jpg",
    "model": "gen3a_turbo",
    "duration": 10,
    "ratio": "1280:768",
    "promptText": "一个宁静的风景转场",
    "watermark": false
}'

返回响应

🟢200成功

application/json

成功响应

Body

string

任务ID

可选

示例值:

d2e3d1f4-1b3c-4b5c-8d46-1c1d7ee86892

示例

{
    "id": "d2e3d1f4-1b3c-4b5c-8d46-1c1d7ee86892"
}

🟠400请求有误

修改于 2025-06-09 15:54:11

生成式放大

任务查询