必须先将视频上传至Runway平台获取video_id,再用API密钥调用Aleph编辑接口;请求需含Authorization头、JSON体(含video_id/prompt/model),通过task_id轮询结果,output_url为24小时有效下载链接。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要用Runway Aleph API对已有视频做文本提示词编辑,必须先确保视频已上传至Runway平台并获得可操作的video_id,直接调用未授权或未托管的本地视频路径会返回404错误。
准备视频与获取API凭证
登录Runway官方控制台(app.runwayml.com),进入「API Keys」页面,点击「Create new key」生成专属密钥;该密钥仅显示一次,请立即复制保存,丢失后无法找回。
将待编辑的MP4或MOV格式视频拖入「Projects」→「Upload」区域,等待转码完成;成功后右侧栏显示「Ready」状态,并生成唯一video_id(形如vid_abc123xyz)。
【video_id是后续所有编辑请求的必要参数,不可用文件名、URL或本地路径替代】
构造HTTP请求调用Aleph编辑接口
向 https://api.runwayml.com/v1/video/edit 发送POST请求,Header中必须包含:Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。
Body中填写JSON对象,至少包含三个字段:video_id(字符串)、prompt(字符串)、model(固定为"aleph-2.0");例如:
{"video_id": "vid_abc123xyz", "prompt": "将画面中穿红色外套的人物替换为穿银色机甲的机器人,保留原动作和镜头运动", "model": "aleph-2.0"}
注意:prompt需具体到对象属性、空间关系与动作连续性,模糊描述如“让画面更好看”会导致任务失败或返回空结果。
提交后获取编辑结果
发送请求后,接口立即返回task_id(如task_edt_789def)和status(initializing);该ID用于轮询结果。
每2秒调用一次GET https://api.runwayml.com/v1/task/{task_id},直到status变为completed。
响应体中output_url字段指向生成的MP4下载链接,有效期24小时;链接不可续期,需及时保存。
若status为failed,检查response.message——常见错误包括prompt含违禁词、video_id不存在、API Key权限不足(免费版不支持Aleph调用)。


















