Skip to main content
POST
cURL
使用此端点通过 Runway 的图生视频工作流转换现有源片段。它会启动一个异步任务,而不是立即返回最终输出。

调用前准备

  • 准备一个符合提供方输入要求的源视频
  • 包含所需的 X-Runway-Version 请求头,以启用你想要的功能集
  • 从一条描述变更的简短 Prompt 开始,而不是完整分镜脚本

输出比例

此端点要求使用以冒号分隔的 ratio 值。对 1280x720 输出使用 1280:720,对 720x1280 输出使用 720:1280;并非每个 Runway 图生视频路由都接受 1280x720

任务流程

1

提交源片段和 Prompt

从此端点启动任务,并保存返回的任务 id。
2

轮询任务详情

使用 获取 Runway 任务,直到任务进入终态。
3

存储转换结果

通过你的常规媒体处理流水线下载或持久化已完成的资源。

授权

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

请求头

X-Runway-Version
string
必填

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

请求体

application/json
videoUri
string
默认值:https://your-video-host/source.mp4
必填

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
默认值:A cat yawning in slow motion.
必填

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
默认值:1
必填

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

model
string
默认值:gen4_aleph
必填

Model variant to use.

references
object[]
必填

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

ratio
string
默认值:1280:720
必填

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

contentModeration
object
必填

响应

200 - application/json

success

id
string
必填

The ID of the task that was created. Use this to retrieve the task later.