API 协议

Runway:参数、场景与调用指南

预览指南

粘贴给 AI,帮助理解文档并完成接入。 仅包含文档与示例,不包含真实密钥。

预览指南

Runway:参数、场景与调用指南

直接答案官方 OpenAPI 未列 runway-vip-video;它与 gen4.5、gen4_turbo 的映射未核实。以下仅说明官方 Gen-4.5 文/图生视频字段,不能复制到本站别名请求;示例继续撤下。

更新 · 审核信息

模型定位与适用场景

目录含 runway-vip-video,但当前匿名目录没有可用端点定义。不能套用官方 Gen 系列请求或通用视频参数作为本站可执行示例。

本指南核对本站请求契约,不代表所有场景均已完成收费出片验收。使用模型广场显示的精确模型、分组和有效端点;示例中的 example.com 素材与占位任务 ID 必须替换。先以最小请求确认可用,再逐项添加参考素材和高级参数。价格以模型广场及实际账单为准。

型号与入口

runway-vip-video

本系列暂不提供可直接执行的本站生成请求。以下介绍保留选型和迁移信息;目录记录不代表端点已验收。

参考素材格式

素材字段传输格式文件准备与限制
图片 / 首尾帧—当前本站未发布该系列的可执行素材输入契约;不能依据官方或其他系列接口推断 URL/Base64 支持。先确认模型广场的精确型号与有效端点。本地路径、data URI、原始 Base64 和任务 ID 均不可自行互换。
参考 / 编辑视频—当前本站未发布该系列的可执行素材输入契约;不能依据官方或其他系列接口推断 URL/Base64 支持。先确认模型广场的精确型号与有效端点。本地路径、data URI、原始 Base64 和任务 ID 均不可自行互换。
参考音频—当前本站未发布该系列的可执行素材输入契约;不能依据官方或其他系列接口推断 URL/Base64 支持。先确认模型广场的精确型号与有效端点。本地路径、data URI、原始 Base64 和任务 ID 均不可自行互换。

参数与组合限制

  • 官方 OpenAPI 未列 runway-vip-video;它与 gen4.5、gen4_turbo 的映射未核实。以下仅说明官方 Gen-4.5 文/图生视频字段,不能复制到本站别名请求;示例继续撤下。
  • 当前未提供通过本站发布验收的统一视频调用示例。保留介绍与接入核对项;不要自行拼接端点、模型后缀或恢复已撤下的 Remix 示例。
  • 确认模型广场显示的精确型号、有效端点、分组权限和任务响应;受理成功不等于已出片。
  • 新接入应依次确认文字生成、图片输入、输出规格和异步终态,再单独验证编辑、延展、音频与多参考模式。
字段类型用法与限制
modelofficial stringGen-4.5 使用 gen4.5;其他模型字段及取值不同,runway-vip-video 不是官方列出的 ID。
promptTextofficial stringGen-4.5 必填,1–1000 UTF-16 code units;不是本站已确认的 prompt 映射。
promptImageofficial string / object[]图生必填;官方支持 HTTPS、runway:// 上传 URI 或图片 data URI。多帧对象包含 uri 与 position,按对应模型 schema 使用。本站别名未确认。
durationofficial integerGen-4.5 必填 2–10 秒;不外推为本站别名时长范围。
ratioofficial stringGen-4.5 必填像素比字符串(如 1280:720),不是 16:9。文生支持横竖屏两档,图生另有方形等档位;按官方 schema 选择。
seedofficial integer可选,0–4294967295,省略随机;本站别名未确认。
contentModeration.publicFigureThresholdofficial string可选 auto/low,影响官方公众人物内容过滤;本站未确认开放。
outputFormatofficial string可选,默认 mp4;官方还列 prores、png_sequence 和 HDR/EXR 导出档位,额外费用与交付格式需查官方 schema。本站未确认开放。
proresProfileofficial string仅对应 ProRes 输出可用,合法档位及默认值随 outputFormat 改变;本站未确认开放。
X-Runway-Versionofficial header官方必填版本头;不能仅添加该请求头就让本站别名兼容官方协议。

场景与代码示例

先确认当前型号是否有有效端点及已发布的参数说明,再按最小文生、单图、输出规格、任务终态的顺序验证。不要依据其他平台的后缀自行组合型号,也不要套用本页其他系列的 prompt/content/contents 协议。暂不开放的场景没有发送按钮或可执行样例。

任务结果与下载

保存提交返回的 id 或 task_id。统一视频查询使用 GET /v1/videos/{task_id},等待 queued / in_progress 到 completed 或 failed;完成后读取 video_url(部分响应同时在 metadata.url 提供)。本站相对路径需与调用域名拼接,/content 入口使用本站 Key;外部下载 URL 不携带本站 Key。结果可能过期,请及时下载。网络超时保留任务 ID 继续 GET,不自动重试创建 POST。

统一视频完整 Python / JavaScript 轮询下载示例

常见问题定位

现象检查方式
Error validating image / 图片 URI 错误视频或任务 ID 是否误填到了图片字段;检查媒体 URL 是否返回真实素材
unsupported content type / 字段不支持检查系列、版本和 content/contents/input 的准确类型;不要把音频 URL 填入 voice_id
400 参数冲突检查 prompt 与 input、首尾帧与多参考、秒数与 response_format 的互斥项
HTTP 成功但任务 failed记录本站任务 ID、时间、模型、域名和已脱敏参数;按任务错误定位,不能依据提交 200 宣称成功
404 或不可访问任务确认域名、Key 权限、本站任务类型;不要使用其他站点或官方任务 ID
本地文件无法访问使用系列明确支持的上传方式,或提供可读取的 HTTPS 媒体 URL

资料与适用范围

Runway OpenAPI schema

Runway API guide

适用场景

  • 选择视频模型和素材协议
  • 排查参数与任务失败

API 协议

  • /v1/models

常见问题

拿到 task_id 就代表生成成功吗?

不代表。保存本站任务 ID,查询到成功终态并确认结果可读取后才算完成;failed 要查看错误,不要自动重建任务。

本地图片、视频和 WAV 能直接填写路径吗?

不能。URL 字段需要服务可读取的媒体地址;localhost、电脑路径及需要浏览器登录的链接不可用。Kling 本地 PCM WAV 的 multipart 音色上传需本站先启用该接口(2026-11-15 两站实测均为 404);其他素材按该系列上传或素材流程处理。

能把不同模型的参数和任务 ID 互换吗?

不能假定兼容。核对精确型号、入口、大小写、媒体角色及互斥字段。编辑、草稿和音色都要求对应类型、本人可访问的成功任务;官方能力也不等于本站已验收。

官方来源

  1. Runway OpenAPI schema 官方
  2. Runway API guide 官方