Generate and edit images via OpenAI, Gemini, or fal.ai.
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.
python scripts/generate.py --provider <openai|gemini|fal> --prompt "..." [--size WxH|RATIO] [--model MODEL] [--resolution 1K|2K|4K] [--output PATH] [--seed N]
python scripts/edit.py --provider <openai|gemini|fal> --image input.png --prompt "edit instruction" [--mask mask.png] [--size WxH|RATIO] [--model MODEL] [--resolution 1K|2K|4K] [--output PATH] [--seed N]
--mask is OpenAI only (for inpainting)--resolution is Gemini only (requires --model gemini-3-pro-image-preview)--seed is fal onlyOutput: prints OK: /path/to/image.png (N bytes) on success.
gpt-image-1. Supports mask-based inpainting for edits.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.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.
| 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.
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 |
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.
共 1 个版本