需用代码调用runway api批量生成视频，包括text/ image/ video to video三类任务；须提前获取api密钥、安装runwayml库、确保pro订阅及积分充足；提示词限120字符且禁用中文标点；图像/视频输入必须先上传获取file_id/video_id再拼接url；motion brush需导出json坐标，导演模式与音频保留需显式配置参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要用代码调用Runway API批量生成视频，而不是在网页端手动操作——比如给电商商品图批量加旋转动画、把100篇博客自动转成营销短视频、或接入内部CMS系统实现“一键成片”。
准备API密钥和基础环境
登录Runway官网→右上角头像→Settings→API Keys→点击“Create New Key”，复制生成的密钥。注意：【该密钥一旦关闭页面就无法再次查看，必须立即保存】。
安装Python 3.9+环境，执行 pip install runwayml。
确认你已开通Pro订阅且账户余额充足——Gen-3 Alpha模型调用每秒消耗15积分，4秒视频即60积分，免费额度仅125积分/月，不够跑两轮测试。
发送文本生成视频请求（Text to Video）
方法一：使用官方SDK（推荐新手）
初始化客户端后直接传参，提示词必须控制在120字符内，且不能含中文标点：“A vintage typewriter on a wooden desk, keys pressing down one by one, soft shadows, film grain”。
调用 run.generate_video(prompt=...) 后返回任务ID，需轮询 get_job_status(task_id) 直到 status 变为 completed，再用 get_result(task_id) 下载MP4。
发送图像生成视频请求（Image to Video）
第一步：将本地图片上传至Runway托管存储
调用 run.upload_file("product.jpg") 获取 file_id，该ID是后续请求的必需参数，不是URL。
第二步：构造带图像引用的生成请求
body = { "model": "gen-3-alpha", "prompt": "the shoe rotates slowly, studio lighting, clean white background", "image_url": f"https://cdn.runwayml.com/files/{file_id}", "duration": 4 }；注意【image_url必须用run.upload_file返回的file_id拼接，不可直接传本地路径或公网URL】。
第三步：发起POST请求到 https://api.runwayml.com/v1/video-generation，Header中携带 Authorization: Bearer YOUR_API_KEY。
处理视频转视频（Video to Video）的特殊参数
① 必须先上传原始视频，获取 video_id；
② Motion Brush轨迹需预先导出为JSON格式坐标数组，包含每帧x/y偏移量与蒙版掩码，否则API会忽略笔刷效果；
③ 开启导演模式需显式设置 camera_motion: { "type": "dolly-in", "intensity": 0.7 }，不填则默认无摄像机动画；
④ 若想保留音频轨道，必须在请求体中添加 keep_audio: true，否则生成结果永远静音。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
