SkillHub

filtrix-image-gen

v1.0.2

Generate and edit images through Filtrix Remote MCP. Use when users ask to create images or refine existing ones. Supports gpt-image-1, nano-banana, and nano-banana-2 through one MCP endpoint.

Sourced from ClawHub, Authored by lumenclaw-cloud

Installation

Please help me install the skill `filtrix-image-gen` from SkillHub official store. npx skills add lumenclaw-cloud/filtrix-image-gen

Filtrix Image Gen (MCP)

This skill is MCP-only.

  • Endpoint: https://mcp.filtrix.ai/mcp
  • Auth: Authorization: Bearer <FILTRIX_MCP_API_KEY>
  • Primary tools:
  • generate_image_text
  • edit_image_text
  • get_account_credits

Available MCP tools:

  • get_account_credits
  • generate_image_text
  • edit_image_text

Setup

Required: - FILTRIX_MCP_API_KEY

Optional: - FILTRIX_MCP_URL (default: https://mcp.filtrix.ai/mcp)

Generate

python scripts/generate.py 
  --prompt "..." 
  [--mode gpt-image-1|nano-banana|nano-banana-2] 
  [--size 1024x1024|1536x1024|1024x1536|auto] 
  [--resolution 1K|2K|4K] 
  [--search-mode] 
  [--enhance-mode] 
  [--idempotency-key KEY] 
  [--output PATH]

Edit

Use this when user wants iterative refinement, style transfer, background changes, object replacement, etc.

python scripts/edit.py 
  --prompt "make the sky sunset orange and add volumetric light" 
  (--image-path /path/to/input.png | --image-url https://...) 
  [--mode gpt-image-1|nano-banana|nano-banana-2] 
  [--size 1024x1024|1536x1024|1024x1536|auto] 
  [--resolution 1K|2K|4K] 
  [--search-mode] 
  [--enhance-mode] 
  [--idempotency-key KEY] 
  [--output PATH]

Mode Mapping

  • gpt-image-1: general quality route
  • nano-banana: fast generation route
  • nano-banana-2: advanced generation route
  1. First pass with generate_image_text (scripts/generate.py).
  2. Use edit_image_text (scripts/edit.py) for targeted changes.
  3. Use a new idempotency_key for each new edit intent.

Idempotency

idempotency_key prevents duplicate billing on retries. If omitted, scripts auto-generate one UUID-based key.

References

  • MCP Tools Reference
  • gpt-image-1 Mode
  • nano-banana Mode
  • nano-banana-2 Mode
  • Prompt Guide