图生视频

POST

/runwayml/v1/image_to_video

以图片为起始帧生成视频。提交后返回任务 id，通过 GET /runwayml/v1/tasks/{task_id} 轮询。

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

图生视频提交视频生成任务

{
    "model": "gen4_turbo",
    "promptImage": "https://example.com/start-frame.jpg",
    "promptText": "The camera slowly zooms in",
    "ratio": "1280:720",
    "duration": 5
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

图生视频提交视频生成任务

curl --location '/runwayml/v1/image_to_video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gen4_turbo",
    "promptImage": "https://example.com/start-frame.jpg",
    "promptText": "The camera slowly zooms in",
    "ratio": "1280:720",
    "duration": 5
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "4665a07c-7641-4809-a133-10786201bb56",
    "prompt": "",
    "state": "pending",
    "created_at": "2024-12-22T13:38:40.139Z",
    "batch_id": ""
}

🟠400请求有误

🟠401没有权限

修改于 2026-10-24 18:33:17

查询任务状态