potluck-imagelisted

# Potluck — Image Generation Requires `POTLUCK_URL` (and `POTLUCK_KEY` if auth enabled). See https://raw.githubusercontent.com/Ezero23/potluck/refs/heads/main/skills/potluck/SKILL.md for setup. ## Discover ```bash curl $POTLUCK_URL/v1/models/image | jq '.data[].id' # Per-model params/options (size enum, quality enum, capabilities like edit) curl "$POTLUCK_URL/v1/models/info?id=openai/dall-e-3" ``` ## Endpoint `POST $POTLUCK_URL/v1/images/generations` | Field | Required | Notes | |---|---|---| | `model` | yes | from `/v1/models/image` | | `prompt` | yes | image description | | `n` | no | count (provider-dependent) | | `size` | no | `1024x1024`, `1792x1024`, ... | | `quality` | no | `standard` / `hd` (OpenAI) | | `response_format` | no | `url` (default) or `b64_json` | Add query `?response_format=binary` to receive raw image bytes (handy for saving file). ## Examples Save to file (binary): ```bash curl -X POST "$POTLUCK_URL/v1/images/generations?response_format=binary" \ -H "Authorization: Bearer $POTLUCK_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"gemini/gemini-3-pro-image-preview","prompt":"watercolor mountains at sunrise","size":"1024x1024"}' \ --output out.png ``` JS (URL response): ```js const r = await fetch(`${process.env.POTLUCK_URL}/v1/images/generations`, { method: "POST", headers: { "Authorization": `Bearer ${process.env.POTLUCK_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({ model: "gemini/gemini-3-pro-ima