使用说明
openrouter imgen mcp
让你的AI助手能够生成和编辑图像。一次安装，多种型号，无供应商锁定。
截图
| 之前 | 之后 |
|---|---|
适用于Claude Code、Claude Desktop、Cursor、VS Code、Windsurf和任何MCP客户端。
为什么这样
- 一个API密钥，每个图像模型。 Gemini、GPT-5等 开放路由.用单词切换模型，而不是更改代码。
- 生成、编辑和批处理。 文本到图像、带参考的图像编辑和批处理操作（最多20个并行任务）。
- 样式预设。 说“水彩风格”或“像素艺术”，并得到一致的结果。8种内置样式。
- 变化。 从一个提示中生成最多4个镜头。挑最好的一个。
- 智能文件输出。 保存到路径或目录。文件会自动获得描述性名称。
- 为你使用的东西付费。 OpenRouter的按令牌和按图像定价意味着没有订阅。
如何安装
得到一个 OpenRouter API密钥，然后将服务器添加到客户端。
克劳德代码
# macOS / Linux
claude mcp add openrouter-imgen-mcp -s user -e OPENROUTER_API_KEY=YOURAPIKEY -- npx -y openrouter-imgen-mcp@latest
# Windows
claude mcp add openrouter-imgen-mcp -s user -e OPENROUTER_API_KEY=YOURAPIKEY -- cmd /c npx -y openrouter-imgen-mcp@latest
克劳德桌面/光标/VS代码/Windsurf
添加到MCP配置JSON：
{
"mcpServers": {
"openrouter-imgen-mcp": {
"command": "npx",
"args": ["-y", "openrouter-imgen-mcp@latest"],
"env": {
"OPENROUTER_API_KEY": "YOURAPIKEY"
}
}
}
}
你能做什么
只需与您的助手聊天：
Generate a product photo of a ceramic mug on a wooden table, warm lighting
Generate 3 variations of a logo concept for a coffee brand, pixel-art style
Edit /path/to/headshot.png: make the background a gradient, keep the subject
Batch generate 5 social media banners: summer sale, back to school, holiday promo,
new arrivals, free shipping. All in illustration style, 16:9, save to ./banners/
List image models. What's cheapest for quick drafts?
质量预设
跳过模型ID。只需说“快速”、“平衡”或“质量”：
| 预设 | 型号 | 何时使用 |
|---|---|---|
fast |
Gemini 2.5 Flash | 草稿、迭代、保持低成本 |
balanced |
Gemini 3 Pro | 日常使用（默认） |
quality |
GPT-5图像 | 最终交付成果，最大保真度 |
或通过任何 OpenRouter型号ID 直接：
Generate a cat using model google/gemini-2.5-flash-image
风格预设
关键字修改样式：
| 风格 | 你得到了什么 |
|---|---|
photo |
真实感、数码单反、自然光 |
illustration |
干净的数字艺术，鲜艳的色彩 |
watercolor |
柔软的洗涤，纸张质感 |
pixel-art |
复古16位，有限调色板 |
3d-render |
工作室照明、基于物理的渲染 |
anime |
Cel着色，日本动画 |
sketch |
纸上铅笔，单色 |
oil-painting |
笔触，impasto，古典 |
工具参考
方便的工具：
| 工具 | 它做什么 |
|---|---|
generate_image |
文本到图像，具有质量/风格预设、变体（1-4）、宽高比、文件输出 |
edit_image |
使用提示转换图像+最多12个参考图像（文件、URL、数据URI） |
batch_images |
与并发控制并行运行多达20个生成/编辑任务 |
list_image_models |
浏览有价格的可用型号 |
check_balance |
检查您的OpenRouter信用余额 |
支持的输出： 1:1, 2:3, 3:2, 16:9, 9:16, 4:3, 3:4 宽高比。 0.5K, 1K, 2K, 4K 尺寸。PNG、JPEG、WebP、GIF输入。
无头配置
| 标志 | 环境变量 | 默认值 |
|---|---|---|
--api-key |
OPENROUTER_API_KEY |
（必填） |
--default-model |
OPENROUTER_IMG_DEFAULT_MODEL |
google/gemini-3-pro-image-preview |
--batch-concurrency |
OPENROUTER_IMG_BATCH_CONCURRENCY |
3 |
--cache-ttl |
OPENROUTER_IMG_CACHE_TTL |
300000 （5分钟） |
--log-level |
OPENROUTER_IMG_LOG_LEVEL |
warn |
安全
API密钥从不出现在日志或错误消息中。文件路径会阻止目录遍历。图像URL根据SSRF模式进行验证。批处理操作的内存上限为200MB。所有输入都经过模式验证。
面向开发者
要为开发人员构建：
pnpm install && pnpm build && pnpm test # 57 tests
许可证
麻省理工学院
制作时<3 比特币网
