image-gen-9router

Image Generation via 9Router

9Router is a local OpenAI-compatible gateway that exposes image generation through /v1/images/generations. The same service handles LLM routing (it's the AGY model Hermes uses) and image gen. Image gen is genuinely free via the Cloudflare provider.

When to use this skill

• User wants to generate an image from a text prompt
• User wants AI art for an Instagram post / story / reel
• User wants to compare multiple image models (FLUX vs DALL-E vs Imagen)
• User has a working 9Router setup (NINEROUTER_URL + NINEROUTER_KEY in env)

9Router is the same service as AGY

Discovery: cat ~/.hermes/config.yaml shows

model:
  base_url: http://localhost:20128/v1

That localhost:20128 is 9Router. Image gen and LLM chat go through the same gateway, but with different endpoints and different model IDs. The key (NINEROUTER_KEY) is shared.

Endpoints

Endpoint	Purpose
GET /v1/models/image	List available image models (with owned_by provider)
GET /v1/models/info?id=<model_id>	Per-model params, capabilities, size enum
POST /v1/images/generations	Generate image(s)
POST /v1/images/generations?response_format=binary	Generate and return raw bytes

Auth: Authorization: Bearer $NINEROUTER_KEY (required even for local 9Router).

Discover available models

curl -s $NINEROUTER_URL/v1/models/image \
  -H "Authorization: Bearer $NINEROUTER_KEY" | jq '.data[].id'

Common models:

• cf/@cf/black-forest-labs/flux-2-klein-4b — small, fast, free (Cloudflare)
• cf/@cf/black-forest-labs/flux-2-klein-9b — larger, more detail (Cloudflare)
• cf/@cf/black-forest-labs/flux-2-dev — development build (Cloudflare)
• gemini/gemini-3-pro-image-preview — Google's Imagen 3
• openai/dall-e-3 — OpenAI DALL-E 3
• cf/@cf/leonardo/phoenix-1.0 — Leonardo Phoenix via Cloudflare

Generate an image (Python)

import httpx, os

resp = httpx.post(
    f"{os.environ['NINEROUTER_URL']}/v1/images/generations?response_format=binary",
    headers={"Authorization": f"Bearer {os.environ['NINEROUTER_KEY']}"},
    json={"model": "cf/@cf/black-forest-labs/flux-2-klein-4b",
          "prompt": "your prompt here",
          "size": "1024x1024"},
    timeout=120,
)
resp.raise_for_status()
open("/tmp/out.png", "wb").write(resp.content)