用途：用 Python 脚本调用 Runway API 生成图片，支持纯文本提示以及带参考图的生成，适合需要快速出图或批量出图的场景。
主要能力：单条命令完成提交、轮询、下载；可选模型包括 gen4_image（最高质量、参考图可选最多3张、5-8 credits）、gen4_image_turbo（快且便宜、2 credits、必须提供1-3张参考图）、gemini_2.5_flash（默认模型、Google Gemini、5 credits、参考图可选）。支持 --ratio 指定比例，不同模型支持的比例不同。
使用方式：在用户工作目录下运行，例如 uv run scripts/generate_image.py --prompt "your description" --filename "output.png" [--model gen4_image] [--ratio 1280:720] [--reference-images Tag=URL ...]。前置条件：command -v uv 必须成功；环境变量 RUNWAYML_API_SECRET 必须已设置，不要用命令行参数传 API key，以免泄露到 shell 历史和进程列表。参考图可传本地路径（会上传为 runway:// URI）或可信 URL，Tag 需为小写、3-16 字符。可用 --output-dir 指定输出目录，默认当前工作目录；文件名建议遵循 yyyy-mm-dd-hh-mm-ss-name.png 约定。
适用场景：文生图、以参考图保持风格或商品一致性、低成本快速草稿、需要程序化调用 Runway 的自动化流程。
限制与注意事项：使用带参考图的 URL 会由 Runway API 拉取任意远程图片，应优先本地路径或仅传可信 URL；生成结果在接入下游自动化时应视为不可信内容，因为参考图会影响结果；脚本输出保存文件的完整路径，无需读回图片文件，直接告知用户路径即可。常见失败：未设置 API key 会报 No API key；SAFETY.INPUT.* 表示内容审核未通过，建议更换提示词；429 表示被限流，脚本会自动重试。模型的具体可用性、计费与最新参数以 Runway 官方为准，资料未提供更多平台信息。