返回模型调用 API 参考
POST/v1/image_to_video

Runway 图生视频:官方参数参考

解释 Runway gen4_turbo 图生视频的官方字段、图片要求及型号差异;本站调用入口请先查看接入状态。

官方鉴权 application/json

功能与适用范围

图生视频将一张图片作为起始画面,再按文字描述生成主体动作、场景变化或运镜,适合产品展示、插画动效与短镜头制作。

本页是 Runway 官方原生格式参考,不是本站已开放接口的调用教程。 本站 Runway 入口尚待确认,请先阅读接入状态与调用说明。旧地址 /runwayml/v1/image_to_video 不应继续用于接入。

模型与组合

gen4_turbo 需要起始图片,不支持删除 promptImage 后改为纯文生视频。gen4.5 有独立的文生与图生请求结构;在其图生结构中 promptText、promptImage、ratio、duration、model 均必填。不要把 gen4_turbo 的可选字段规则直接套用到 gen4.5。

官方模型功能时长(秒)输出尺寸
gen4.5图生视频2–10,整数1280:720 / 720:1280 / 1104:832 / 960:960 / 832:1104 / 1584:672
gen4_turbo图生视频2–10,整数1280:720 / 720:1280 / 1104:832 / 832:1104 / 960:960 / 1584:672
gen4.5文生视频2–10,整数1280:720 / 720:1280

官方地址、鉴权与版本

Runway 官方图生视频接口为 POST https://api.dev.runwayml.com/v1/image_to_video,请求体为 JSON。直接调用该厂商服务需要 Runway 自身的凭据,并使用 X-Runway-Version: 2024-11-06;青云TOP API 的 API Key 不能用于这个厂商域名。

本站 API Key 只用于本站已开放的接口。不要将上述官方 URL 改成本站域名后直接发送,也不要把官方上传的 runway:// 素材标识当作跨服务通用图片地址。

Runway 官方参考(本站待确认)

调用与返回说明

本页展示 Runway 官方 API 的方法、嵌套请求/响应 schema 和状态机。当前青云TOP 尚未确认 Runway 的创建或查询路由,不能把本页当作本站可调用接口。

请求时注意

  • 官方服务地址为 https://api.dev.runwayml.com;需要 Runway 自身访问令牌和 X-Runway-Version: 2024-11-06。
  • 青云TOP API Key 只用于青云TOP 已确认开放的接口,不能发送到 Runway 官方域名;也不能把官方路径直接替换为 top.qingyuntop.ai。
  • gen4_turbo 图生视频必须提供 promptImage;gen4.5 的文生和图生字段组合不同,请按 Request schema 选择分支。

返回时注意

  • 创建响应只表示官方任务已接收,保存 id 和 estimatedCost 后继续查询同一官方服务。
  • output 中的媒体 URL 会过期,成功后应立即下载到自己的存储;credits 是 Runway 计量单位,不是本站价格或余额。
Request

请求

/v1/image_to_video

Body

必填
Bodyapplication/json
Bodyobject
满足其中一个分支
gen4.5object
promptTextstring必填

A non-empty string up to 1000 characters (measured in UTF-16 code units). This should describe in detail what should appear in the output.

长度:1–1000
promptImageunknown必填
可满足一个或多个分支
分支 1unknown

A HTTPS URL, Runway or data URI containing an encoded image. See [our docs](/assets/inputs#images) on image inputs for more information.

示例https://example.com/image.jpg
可满足一个或多个分支
分支 1string

A HTTPS URL, Runway upload URI, or base64 data URI (e.g. `data:image/png;base64,...`, up to 5MB) containing an encoded image. See [our docs](/assets/inputs#images) on image inputs for more information.

长度:13–2048格式:^https:\/\/.*
示例https://example.com/image.jpg
seedinteger

If unspecified, a random number is chosen. Varying the seed integer is a way to get different results for the same other request parameters. Using the same seed integer for an identical request will produce similar results.

范围:[0,4294967295]
ratiostring必填

The resolution of the output video.

可选值:1280:720、720:1280、1104:832、960:960、832:1104、1584:672
durationinteger必填

The number of seconds of duration for the output video. Must be an integer from 2 to 10.

范围:[2,10]
contentModerationobject

Settings that affect the behavior of the content moderation system.

不允许额外字段
publicFigureThresholdstring

When set to `low`, the content moderation system will be less strict about preventing generations that include recognizable public figures.

可选值:auto、low
outputFormatstring

The container/encoding of the output. `mp4` (default) returns an H.264 .mp4. `prores` returns a ProRes .mov. `png_sequence` returns a .zip of PNG frames (plus a separate .wav artifact when the output has audio). `hdr10` (HEVC Main 10, BT.2020 + PQ) and `hlg` (HEVC Main 10, BT.2020 + HLG) return true-HDR 10-bit .mp4s; `sdr_rec709_10bit` returns a 10-bit Rec.709 HEVC .mp4 for SDR grading pipelines; `hdr_pq_12bit_master` returns a 12-bit 4:4:4 BT.2020 + PQ HEVC .mov with measured HDR10 content-light metadata for mastering; `hdr_prores` returns a BT.2020 + PQ ProRes .mov editorial mezzanine, whose tier is selectable with `proresProfile` (`422`, `422 HQ`, or `4444`; defaults to `422 HQ`); `hdr_png_sequence` returns a .zip of 16-bit PNG frames carrying the PQ signal losslessly (plus a colorimetry.json sidecar and a separate .wav when the output has audio); `hdr_exr_sequence` returns a .zip of half-float OpenEXR frames carrying the HDR signal as linear BT.2020 display light, 1.0 = 100 nits (plus a colorimetry.json sidecar and a separate .wav when the output has audio); `hdr_exr_acescg_sequence_1_3` returns the same delivery as scene-referred ACEScg (inverted through the ACES 1.3 Output Transform), reading correctly with the stock `ACES - ACEScg` input transform in ACES-configured pipelines, with VFX sequence frame naming (frame.0001.exr). Non-mp4 formats incur an additional per-second credit surcharge: 5 credits per second for `prores` and `png_sequence`, and 20 credits per second for every 10-bit and deeper profile (including the 12-bit, 16-bit, and EXR ones), rising to 40 credits per second when the output is larger than 4 megapixels — that includes 1440p (2560x1440 is under the line, but anything larger crosses it) up through 4K.

可选值:mp4、prores、png_sequence、hdr10、hlg、sdr_rec709_10bit、hdr_pq_12bit_master、hdr_prores、hdr_png_sequence、hdr_exr_sequence、hdr_exr_acescg_sequence_1_3、hdr_exr_acescg_sequence_2_0
proresProfilestring

The ProRes profile to use. Only valid when `outputFormat` is `prores` or `hdr_prores`. For `prores`, any profile is accepted and the default is `4444`. For `hdr_prores`, only `422`, `422 HQ` and `4444` are available and the default is `422 HQ` — `422 Proxy` and `422 LT` quantize too heavily to hold the HDR gradients, and 12-bit output is served by `hdr_pq_12bit_master` instead of `4444 XQ`.

可选值:422、4444、422 Proxy、422 LT、422 HQ、4444 XQ
modelstring必填
固定值:gen4.5

路径、查询与 Header 参数

参数位置类型必填说明示例
AuthorizationHeaderstring是Runway 官方访问令牌;不是青云TOP API Key。Bearer RUNWAY_API_TOKEN
X-Runway-VersionHeaderstring是Runway API 版本。2024-11-06
Response

返回响应 200

官方接口返回的创建结果或任务状态;请以当前厂商文档为准。
响应 200application/json
响应 200object
不允许额外字段
idstring必填

创建的任务 UUID。

格式:^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
estimatedCostobject必填

The maximum credits this task may charge. The final amount may be lower after the task completes.

不允许额外字段
creditsnumber必填

预计 Runway credits。

Runway 官方参考(本站待确认)

调用与返回说明

本页展示 Runway 官方 API 的方法、嵌套请求/响应 schema 和状态机。当前青云TOP 尚未确认 Runway 的创建或查询路由,不能把本页当作本站可调用接口。

请求时注意

  • 官方服务地址为 https://api.dev.runwayml.com;需要 Runway 自身访问令牌和 X-Runway-Version: 2024-11-06。
  • 青云TOP API Key 只用于青云TOP 已确认开放的接口,不能发送到 Runway 官方域名;也不能把官方路径直接替换为 top.qingyuntop.ai。
  • gen4_turbo 图生视频必须提供 promptImage;gen4.5 的文生和图生字段组合不同,请按 Request schema 选择分支。

返回时注意

  • 创建响应只表示官方任务已接收,保存 id 和 estimatedCost 后继续查询同一官方服务。
  • output 中的媒体 URL 会过期,成功后应立即下载到自己的存储;credits 是 Runway 计量单位,不是本站价格或余额。

图片素材要求

这些是 Runway 官方图生视频的输入限制,不代表本站已提供文件上传入口:

  • 使用 JPEG、PNG 或 WebP;GIF 不支持。素材应直接返回正确的图片 Content-Type,不能返回 HTML 或通用 application/octet-stream。
  • HTTPS 图片 URL 不超过 2048 个字符,主机名必须是域名,不能是 IP;服务应支持 HEAD 并返回正确的 Content-Length。不要使用需要登录的地址;官方不跟随重定向。
  • URL 图片文件上限为 16 MB;Data URI 上限为 5 MB,计算的是编码后的完整字符串。Data URI 需带正确的媒体类型和 ;base64,,不能只传裸 Base64。
  • gen4_turbo 输入图的宽高比(宽除以高)须在 0.5–2.358;gen4.5 图生为 0.5–2。输出尺寸以模型表为准,输入比例与输出不同可能导致居中裁剪。

与旧示例的区别

旧示例的 ratio: "1280:768" 不在当前 gen4_turbo 的枚举中;横屏应从本表选择,例如 1280:720。watermark 不属于本表的官方请求字段,不要继续提交,也不要据此承诺无水印输出。

官方原生字段采用 promptText、promptImage、duration。其他视频教程的 prompt、input_reference、seconds 属于不同调用格式,不能混在同一个原生请求中。

提交后的结果

Runway 官方创建接口返回任务 id,并提供 estimatedCost 估算信息;这只代表任务已创建,不表示视频已经完成。保存返回的 ID,用同一服务的任务查询接口等待 SUCCEEDED 后读取 output,详见任务查询与状态参考。

官方 credits 是厂商自己的计量单位,不能直接当作本站余额、人民币价格或免费承诺。本站费用以实际可用模型的价格信息为准。

官方参考