Generate an Image via BlockEden OpenAI Proxy

You are helping the user generate an AI image using the BlockEden OpenAI proxy, which is fully compatible with the OpenAI Images API (DALL-E 3 / DALL-E 2).

Prerequisites

The BLOCKEDEN_API_KEY environment variable must be set. If it's missing, tell the user:

Please set the BLOCKEDEN_API_KEY environment variable before using this skill.

How to generate an image

Use the bundled script at scripts/generate_image.py (relative to this SKILL.md):

python <skill_dir>/scripts/generate_image.py "<prompt>" [options]

Options

Flag	Default	Choices	Notes
--size	1024x1024	1024x1024, 1792x1024, 1024x1792	Landscape: 1792x1024, Portrait: 1024x1792
--quality	standard	standard, hd	hd gives finer detail, costs more
--model	dall-e-3	dall-e-3, dall-e-2	DALL-E 3 is recommended
--style	vivid	vivid, natural	DALL-E 3 only. vivid = dramatic, natural = realistic
--output-dir	.	any path	Directory where the PNG will be saved

Example

python /path/to/skill/scripts/generate_image.py \
  "a cozy coffee shop on a rainy day, impressionist painting style" \
  --size 1792x1024 \
  --quality hd \
  --style natural \
  --output-dir ~/Desktop

After generation

The script prints a JSON object to stdout:

{
  "filepath": "/path/to/image_1234567890.png",
  "revised_prompt": "...",
  "model": "dall-e-3",
  "size": "1024x1024",
  "quality": "standard",
  "style": "vivid"
}

Once the image is saved:

1. Tell the user the file path so they can open it.
2. Show the revised_prompt if DALL-E rewrote it — this helps the user refine future prompts.
3. Offer to regenerate with different parameters (size, quality, style) if the user wants to iterate.

Interpreting the user's request

• Extract the core visual description from what the user says and use it as the prompt.
• If the user specifies an aspect ratio (wide, tall, square), map it to the appropriate --size.
• If the user says "high quality", "detailed", or "HD", add --quality hd.
• If the user says "realistic" or "photorealistic", use --style natural.
• If the user says "artistic", "dramatic", or "vivid", use --style vivid (the default).
• If the user provides an output location, pass it via --output-dir.
• If no output location is given, save to the current working directory.

Prompt crafting tips

Good image prompts are specific and visual. If the user's request is vague, enhance it slightly:

• Add a medium/style if none given (e.g., "digital art", "watercolor", "photorealistic")
• Add lighting or atmosphere if it feels generic (e.g., "golden hour lighting", "moody atmosphere")
• Don't over-engineer — keep the user's intent central