Generate Media

One generation per invocation through a provider API. The file lands in $HOME/.cache/generate-media/.

Provider reference — read before the first API call:

• OpenRouter (default): providers/openrouter.md

Rules

1. Stop if the provider key is missing. For OpenRouter that is OPENROUTER_API_KEY — check .env in the project root, then the environment. Never write a key into a tracked file. If missing, point the user at https://openrouter.ai/settings/keys and stop.

2. Look up model IDs from the API. Never guess them. IDs change and a wrong one wastes a paid round trip.

3. Pick the cheapest model that meets the need, unless the user named one. Exceptions worth saying out loud: openai/gpt-image-2 for legible text inside an image, a -pro tier when the user asked for production quality.