Skip to content
EN

提交视频生成任务

方法: POST路径: /runwayml/v1/image_to_video

https://docs.dev.runwayml.com/api/#tag/Start-generating/paths/~1v1~1image_to_video/post

请求参数

Header 参数

text
Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

text
promptImage
array
[object]
可选
uri
string
必需
A HTTPS URL or data URI containing an encoded image. See our docs on image inputs for more information.
position
enum<string>
必需
图像在输出视频中的位置。“first”将使用图像作为视频的第一帧,“last”将使用图像作为视频的最后一帧。
枚举值:
first
last
seed
integer
可选
model
string
必需
"gen3a_turbo"、"gen4_turbo"
promptText
string
必需
watermark
boolean
可选
duration
integer
5 \ 10
可选
ratio
string
可选
gen3a_turbo 仅支持 1280:768为横屏 768:1280为竖屏,gen4_turbo 支持 1280:720 720:1280 1104:832 832:1104 960:960 1584:672
示例
{
"promptImage"
:
[
{
"uri"
:
"string"
,
"position"
:
"first"
}
]
,
"seed"
:
0
,
"model"
:
"string"
,
"promptText"
:
"string"
,
"watermark"
:
true
,
"duration"
:
0
,
"ratio"
:
"string"
}

请求示例代码

Shell

bash
curl --location --request POST '/runwayml/v1/image_to_video' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "promptImage": [
        {
            "uri": "string",
            "position": "first"
        }
    ],
    "seed": 0,
    "model": "string",
    "promptText": "string",
    "watermark": true,
    "duration": 0,
    "ratio": "string"
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

text
id
string
必需

示例

json
{
    "id": "13db8785-77bc-4273-883b-e462f3e7ff52"
}