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 的创建或查询路由,不能把本页当作本站可调用接口。
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.
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.
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`.