Runway API怎么用？开发者从注册到接口调用完整教程-人工智能-PHP中文网

直接调用runway官方api可实现图生视频批量自动化：注册邮箱账号→创建含gen-3 turbo权限的api密钥→获取模型id→上传图片→提交生成任务→轮询状态→下载视频。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

runway api怎么用？ - php中文网

想用Runway Gen-3 Turbo模型批量生成图生视频，又不想让用户自己注册账号、填提示词、等渲染、手动下载——直接走官方API是最干净的路径。

注册Runway开发者账号并开通API权限

打开 https://runwayml.com ，点击右上角 【Sign Up】 → 选择邮箱注册（不推荐Google/Apple第三方登录，因API密钥绑定需邮箱实名）→ 填写用户名（【一旦设定无法修改】）、密码（必须含大小写字母+数字）、姓名、邮箱 → 提交后立即查收验证邮件，1小时内点击链接完成激活。

登录后进入 【Settings → API Keys】 页面，点击 【Create new API key】 → 输入描述（如“gen3-turbo-prod”），勾选 【Gen-3 Turbo】 权限 → 点击创建 → 复制弹出的密钥字符串（仅显示一次，关闭页面即永久丢失）。

获取可用模型ID与基础参数校验

在终端执行 curl 命令调用模型列表接口：

curl -X GET "https://api.runwayml.com/v1/models" \
-H "Authorization: Bearer YOUR_API_KEY"

返回JSON中查找 "name": "gen-3-alpha-turbo" 对应的 id 字段值，例如 "model_id": "gen3-alpha-turbo-2025-q4" —— 这就是后续所有请求必须使用的模型标识。

注意：若返回空数组或报错 403 Forbidden，说明该API Key未被授予Gen-3 Turbo访问权限，需回到 Settings → API Keys 页面重新编辑密钥并勾选对应模型。

上传图片并触发图生视频任务

第一步：准备一张JPG或PNG格式图像，分辨率建议 ≥1024×1024，主体居中，背景简洁；

第二步：调用上传接口获取临时URL：

curl -X POST "https://api.runwayml.com/v1/uploads" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"content_type":"image/jpeg","file_name":"scene.jpg"}'

php获得文件的mime type类

下载

第三步：拿到响应中的 upload_url 和 file_id，用 PUT 方法上传二进制文件（Linux/macOS下可直接用 curl -T scene.jpg "$UPLOAD_URL"）；

第四步：构造生成请求，POST 到 /v1/generations：

curl -X POST "https://api.runwayml.com/v1/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model_id": "gen3-alpha-turbo-2025-q4",
"prompt": "smooth cinematic motion, gentle pan left, soft ambient light",
"input": {"image": {"file_id": "YOUR_FILE_ID"}},
"duration": 10,
"fps": 24
}'

响应体中会返回 generation_id 和 status: "queued" —— 此时任务已提交成功。