用途:通过 Runway ML 的 REST API 进行 AI 视频与图像生成,适合在命令行或脚本中调用。
主要能力:支持图生视频、文生视频、视频转视频、文生图、视频 4X 放大以及音效生成,并可查询组织额度、轮询任务状态和取消任务。
使用方式:需先设置环境变量 RUNWAY_TOKEN。基础地址为 https://api.dev.runwayml.com/v1,所有请求需带请求头 Authorization: Bearer ${RUNWAY_TOKEN}、X-Runway-Version: 2024-11-06 和 Content-Type: application/json。示例:查询额度用 curl -s -X GET "https://api.dev.runwayml.com/v1/organization" --header "Authorization: Bearer $RUNWAY_TOKEN" --header "X-Runway-Version: 2024-11-06";生成任务用 POST 到对应端点(如 /image_to_video、/text_to_video、/video_to_video、/text_to_image、/video_upscale、/sound_effect),请求体写入 /tmp/runway_request.json 后用 -d @/tmp/runway_request.json 提交。任务为异步,返回 id 后轮询 GET /tasks/<your-task-id>,状态有 PENDING、RUNNING、SUCCEEDED、FAILED;取消用 DELETE /tasks/<your-task-id>。
模型与参数:图生视频可用 gen4_turbo、gen3a_turbo、veo3.1、veo3;文生视频可用 veo3.1、veo3.1_fast、veo3,且时长仅支持 4、6、8 秒;视频转视频用 gen4_aleph;文生图用 gen4_image_turbo、gen4_image;放大用 upscale_v1;音效用 eleven_text_to_sound_v2。常用比例有 1280:720、720:1280、1024:1024。
限制与排错:请求失败可运行 zero doctor check-connector --env-name RUNWAY_TOKEN 或 zero doctor check-connector --url https://api.dev.runwayml.com/v1/organization --method GET 检查连接。输出 URL 可能过期,需及时下载;API 限流时返回 429,应增加延迟;可通过 /organization 端点监控额度。