图像转视频

使用 CometAPI 调用 Runway 的 image_to_video，将静态图片 URL 转换为原始视频输出，并支持通过 X-Runway-Version 实现兼容性。

POST /runwayml/v1/image_to_video

Create a Runway image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
  "model": "gen3a_turbo"
}
'

200

{
  "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}

使用此端点可将一张源图片制作成 Runway 视频动画。

​

调用前准备

• 发送必需的 X-Runway-Version 请求头，例如 2024-11-06
• 使用 model: gen3a_turbo
• 提供稳定的 HTTPS promptImage
• 先从 duration: 5 和常见比例（如 1280:720）开始

​

任务流程

1. 提交图像转视频请求

   使用源图片以及可选的简短运动提示词创建任务。

2. 保存返回的 id

   保存任务 id，以便后续轮询。

3. 轮询任务状态

   使用 获取任务详情。如果首次轮询返回 task_not_exist，请等待几秒后重试。

在 2026-03-13 的在线验证中，已确认一个最小化的 gen3a_turbo 请求可被接受并返回 id。短暂延迟后，官方 task-details 与反向 feed 都为该任务返回了相同的包装 queued 状态。

授权

Authorization · string · header · 必填

Bearer token authentication. Use your CometAPI key.

请求头

X-Runway-Version · string · 必填

Runway version header, for example 2024-11-06.

请求体

application/json

promptImage · string · 默认值: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · 必填

Source image URL.

model · string · 默认值: gen3a_turbo · 必填

Runway image-to-video model ID. Choose a current model from the Models page.

seed · integer

Random seed for reproducible results. Range: 0–999999999.

promptText · string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark · boolean · 默认值: false

Whether to add a watermark to the output video.

duration · integer · 默认值: 5

Video duration in seconds. Accepted values: 5 or 10.

ratio · enum<string> · 默认值: 1280:720

Aspect ratio of the output video.

可用选项: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

响应

200 - application/json

Task accepted.

id · string · 必填