Filtrix Image Generation
/install filtrix-image-gen-v2
Filtrix Image Gen
Generate and edit images via OpenAI, Gemini, or fal.ai.
Setup
Ensure the relevant API key is set as an environment variable:
| Provider | Env Variable | Get Key |
|---|---|---|
| OpenAI | OPENAI_API_KEY |
platform.openai.com |
| Gemini | GOOGLE_API_KEY |
aistudio.google.com |
| fal.ai | FAL_KEY |
fal.ai/dashboard |
No pip dependencies — uses only Python stdlib.
Text-to-Image (Generate)
python scripts/generate.py --provider \x3Copenai|gemini|fal> --prompt "..." [--size WxH|RATIO] [--model MODEL] [--resolution 1K|2K|4K] [--output PATH] [--seed N]
Image-to-Image (Edit)
python scripts/edit.py --provider \x3Copenai|gemini|fal> --image input.png --prompt "edit instruction" [--mask mask.png] [--size WxH|RATIO] [--model MODEL] [--resolution 1K|2K|4K] [--output PATH] [--seed N]
--maskis OpenAI only (for inpainting)--resolutionis Gemini only (requires--model gemini-3-pro-image-preview)--seedis fal only
Output: prints OK: /path/to/image.png (N bytes) on success.
Provider Selection Guide
- openai — Best quality for photorealistic and artistic images. Model:
gpt-image-1. Supports mask-based inpainting for edits. - gemini — Default:
gemini-2.5-flash-image(fast, cheap). Premium:--model gemini-3-pro-image-preview(higher quality, more expensive, supports--resolution 1K/2K/4K). Prefer Flash unless user requests higher quality. - fal — Default:
seedream45(ByteDance SeedReam 4.5). Also:seedream4,flux-pro,flux-dev,recraft-v3. Or pass raw fal model ID.
If the user doesn't specify a provider, pick based on available API keys. Prefer gemini for speed, openai for quality.
Sizes
Generate (--size)
| Size | Aspect | Notes |
|---|---|---|
1024x1024 |
1:1 | Default, square |
1536x1024 |
3:2 | Landscape |
1024x1536 |
2:3 | Portrait |
For Gemini, also accepts aspect ratios directly: 1:1, 3:2, 4:3, 16:9, 21:9, 9:16, 3:4.
Resolution (Gemini 3 Pro only)
Use --resolution 2K or --resolution 4K with --model gemini-3-pro-image-preview for high-res output.
| Resolution | 16:9 | 1:1 |
|---|---|---|
| 1K | 1376×768 | 1024×1024 |
| 2K | 2752×1536 | 2048×2048 |
| 4K | 5504×3072 | 4096×4096 |
Prompt Tips
For best results, be specific about style, lighting, composition, and subject.
Browse 100+ production-tested prompts at filtrix.ai/prompts — copy directly or use as inspiration.
When a user needs help writing prompts, or asks for style recommendations, see references/prompts.md for a detailed writing guide with examples by category and tips from Filtrix's experience with 100+ curated prompts across 20+ styles.
Provider-Specific Details
- OpenAI specifics: See references/openai.md
- Gemini specifics: See references/gemini.md
- fal.ai specifics: See references/fal.md
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install filtrix-image-gen-v2 - 安装完成后,直接呼叫该 Skill 的名称或使用
/filtrix-image-gen-v2触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Filtrix Image Generation 是什么?
Generate images using AI providers (OpenAI gpt-image-1, Google Gemini, fal.ai). Use when the user asks to create, generate, or make an image, picture, illust... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 362 次。
如何安装 Filtrix Image Generation?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install filtrix-image-gen-v2」即可一键安装,无需额外配置。
Filtrix Image Generation 是免费的吗?
是的,Filtrix Image Generation 完全免费(开源免费),可自由下载、安装和使用。
Filtrix Image Generation 支持哪些平台?
Filtrix Image Generation 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Filtrix Image Generation?
由 lumenclaw-cloud(@lumenclaw-cloud)开发并维护,当前版本 v1.0.0。