用途:这是一个面向智能体调用的 Runway 生成式媒体(https://api.dev.runwayml.com/v1)连接器,用于生成与处理图像、视频、音频,并执行营销类一次性任务。属独立、非官方连接器,与 Runway 无隶属、背书或赞助关系;Runway 为其所有者商标,仅用于标识所对接的服务。
主要能力:视觉方面可 generateImage(文生图,可由 1-3 张参考图引导)、generateVideoFromImage(图生视频)、generateVideoFromText(文生视频)、editVideo(用文本提示重塑视频)、upscaleImage / upscaleVideo(放大)、animateCharacter(从驱动视频迁移表演做角色动画)。音频方面可 generateSpeech(文本转语音,支持预设或克隆参考音色)、generateSoundEffect(文生音效)、convertVoice(换声)、dubAudio(配音到目标语言)、isolateVoice(去除背景音、分离人声)。营销配方含 generateProductAd、generateCampaignImages、generateMarketingImage、swapProduct、generateProductUgc、generateMultiShotVideo、localizeAd。任务与账户方面可用 getTask 查任务、cancelTask 取消或删除任务、getOrganization 与 getCreditUsage 读额度与用量。
使用方式:需先安装技能,命令为 npx skills add zapier/connectors --skill runway;运行 CLI、本地 MCP 服务或 zapier-sdk 认证命令前,先执行 npm install --omit=dev。运行环境为 Node.js 22.18+。所有生成、音频与配方类工具均为异步:返回 task id,需轮询 getTask 获取成品资产 URL,或传 wait: true 阻塞至任务终态。鉴权以连接选择器形式传入字符串(如 zapier:<connection-id>),而非密钥本身;不要打印环境值以免泄露凭据。脚本返回 { data, meta } 信封,meta.outputDataValidation 说明校验情况,可用 filterOutputData 的 jq 表达式裁剪 data,或用 skipOutputDataValidation 取原始输出(输入校验不可跳过)。
适用场景:批量生成图片/视频素材、视频重塑与放大、音频配音与音效制作,以及产品广告、活动图、UGC 与广告本地化等营销内容生产。
限制:本连接器不覆盖上传本地文件或原始字节,所有素材输入须为 HTTPS URL 或 data URI;头像、自定义音色管理、文档/知识、实时会话、已保存工作流等属其他 Runway 产品,不在范围内;cancelTask 仅能取消或删除单个任务,无批量或账户级删除;API 不提供按模型的价格目录,无法预先报价,getCreditUsage 为事后实际用量,getOrganization 仅报告限额。生成的资产 URL 会在 24-48 小时后过期,应及时下载并重新托管。