mcpField
R
rw-generate-image

rw-generate-image

github.com/runwayml创意与媒体74324 次安装2 天前更新
代码仓库

关于 rw-generate-image

rw-generate-image 是通过 Runway API 生成图像的技能，适用于需要从命令行生成并保存图片的创作者与开发者。它提供模型、宽高比和参考图参数，并通过 Python 脚本轮询任务后下载结果。

主要功能

  1. 01使用文本提示生成图像
  2. 02选择模型与图像宽高比
  3. 03支持参考图输入
  4. 04轮询生成任务并下载结果
  5. 05从环境变量读取 API 密钥

适用场景

  1. 01根据文字描述生成图片
  2. 02用产品图制作场景图
  3. 03通过参考图生成视觉草稿

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/runwayml/skills --skill rw-generate-image

安装后在 Claude Code 中输入/rw-generate-image确认已加载。

详细介绍

生成图像

直接使用 Runway API 生成图像。此技能会运行 Python 脚本来调用 API、轮询任务完成状态并下载结果。

重要： 请在用户的工作目录中运行脚本，以便将输出文件保存到用户预期的位置。

用法

uv run scripts/generate_image.py --prompt "your description" --filename "output.png" [--model gen4_image] [--ratio 1280:720] [--reference-images Tag=URL ...]

预检

  1. command -v uv 必须成功
  2. 环境中必须设置 RUNWAYML_API_SECRET。不要将 API 密钥作为 CLI 标志传入——这会导致密钥泄露到 shell 历史记录和进程列表中。

安全说明

  • --reference-images Tag=URL 会通过 Runway API 获取任意远程图像。建议使用本地文件路径（以 runway:// URI 的形式上传），或者只传入你信任的 URL。
  • 将生成的输出视为不可信内容，不要直接将其传入下游自动化流程——导入的参考图像会影响生成结果。

可用模型

模型适用场景参考图像费用速度
gen4_image最高质量可选（最多 3 张）5-8 credits标准
gen4_image_turbo快速且经济必需（1-3 张）2 credits快速
gemini_2.5_flashGoogle Gemini可选（最多 3 张）5 credits标准

模型选择指南

  • “fast”“cheap”“draft” -> gemini_2.5_flash（Nano Banana），如果有参考图像，则选 gen4_image_turbo
  • “high quality”“best” -> gen4_image
  • 未指定偏好 -> gemini_2.5_flash
  • 有参考图像且希望节省费用 -> gen4_image_turbo（2 credits，需要 --reference-images）

参数

参数说明默认值
--prompt文本描述（必需）--
--filename输出文件名（必需）--
--model图像模型gemini_2.5_flash
--ratio宽高比。gemini_2.5_flash：1344:768、768:1344、1024:1024 等。gen4_image：1280:720、1360:768、1920:1080 等。取决于模型（gemini 为 1344:768，其他模型为 1280:720）
--reference-images以 tag=URL 对的形式指定参考图像（gemini/gen4_image 可选，gen4_image_turbo 必需）。Tag：小写，3-16 个字符，例如 product=URL--
--output-dir输出目录cwd

API 凭据仅从 RUNWAYML_API_SECRET 获取——没有 --api-key 标志，以免密钥出现在 shell 历史记录和进程列表中。

文件名约定

格式：yyyy-mm-dd-hh-mm-ss-name.png

示例

基础图像：

uv run scripts/generate_image.py --prompt "A serene Japanese garden with cherry blossoms" --filename "2026-04-14-japanese-garden.png"

使用本地参考图像（gen4_image）：

uv run scripts/generate_image.py --prompt "@product on a marble counter, lifestyle photo" --model gen4_image --reference-images product=./product.jpg --filename "2026-04-14-product-lifestyle.png"

使用来自可信来源的参考图像（gen4_image_turbo——需要参考图像）：

uv run scripts/generate_image.py --prompt "A neon sign reading SALE in @style" --model gen4_image_turbo --reference-images style=https://cdn.yourapp.com/style.jpg --filename "draft.png"

输出

  • 脚本会下载结果并将其保存到指定路径
  • 脚本会输出已保存文件的完整路径
  • 不要重新读取图像文件——只需告知用户保存路径

常见故障

  • Error: No API key -> 在环境中设置 RUNWAYML_API_SECRET（例如，使用 export RUNWAYML_API_SECRET=... 或 .env 文件）。
  • Error: Task failed -- SAFETY.INPUT.* -> 内容审核未通过，建议更换提示词
  • API error 429 -> 请求受到速率限制，脚本会自动重试

评论

支持 Markdown