提交图生视频任务

将静态图片转换为动态视频。支持多种模型和参数配置。

使用说明

提供图片URL或base64编码的图片作为输入

选择合适的模型版本(gen3a_turbo或gen4_turbo)

设置视频时长、比例等参数

可选择性添加文本提示来指导视频生成

任务创建后返回task_id用于查询结果

注意事项

图片建议分辨率不低于512x512像素

支持的图片格式：JPG、PNG、WebP

文本提示词建议控制在1000字符以内

请求参数

Body 参数application/json

promptImage

string

可选

输入图片，支持以下格式：

图片URL (推荐): https://example.com/image.jpg

Base64编码: data:image/jpeg;base64,/9j/4AAQSkZJ...

示例值:

https://example.com/beautiful_landscape.jpg

seed

integer

可选

随机种子，用于控制生成结果的随机性。
相同的种子和参数会产生相似的结果。
范围：0 - 4294967295

>= 0<= 4294967295

示例值:

123456

model

enum<string>

使用的AI模型版本

可选

枚举值:

gen3a_turbogen4_turbo

示例值:

gen3a_turbo

promptText

string

可选

文本提示词，描述期望的视频动态效果。
例如："人物开始微笑并挥手"、"云朵缓慢移动"等。

<= 1000 字符

示例值:

小猫慢慢睁开眼睛，然后开始伸懒腰

watermark

boolean

可选

是否在生成的视频上添加RunwayML水印

默认值:

false

示例值:

false

duration

enum<integer>

视频时长，单位为秒

可选

枚举值:

510

示例值:

ratio

enum<string>

可选

视频画面比例，不同模型支持的比例不同：

gen3a_turbo 支持：

1280:768 (横屏)

768:1280 (竖屏)

gen4_turbo 支持：

1280:720 (16:9 横屏)

720:1280 (9:16 竖屏)

1104:832 (4:3 横屏)

832:1104 (3:4 竖屏)

960:960 (1:1 正方形)

1584:672 (超宽屏)

枚举值:

1280:768768:12801280:720720:12801104:832832:1104960:9601584:672

示例值:

1280:768

示例

基础示例高级示例

简单的图生视频请求

{
    "promptImage": "https://example.com/cat.jpg",
    "model": "gen3a_turbo",
    "promptText": "小猫开始走动",
    "duration": 5,
    "ratio": "1280:768",
    "watermark": false
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

任务创建成功

Body

string <uuid>

可选

任务唯一标识符，用于查询任务状态

示例值:

13db8785-77bc-4273-883b-e462f3e7ff52

示例

{
    "id": "task_runway_123456"
}

提交图生视频任务

使用说明#

注意事项#

请求参数

示例代码

返回响应

使用说明

注意事项