popnow-imagelisted
Install: claude install-skill popnow-ai/popnow-skills
# PopNow image generation and editing
Create and edit images through the PopNow REST API (`https://api.popnow.ai/api/v1`). Every generation is a task: **quote -> confirm -> create -> wait -> download**. The bundled `scripts/popnow.py` (Python 3 standard library only) does all of it. Paths below are relative to this skill's folder.
## Rule: always confirm the price first
Generations spend the user's PopNow API balance, in US dollars. It is separate from website credits, starts at $0 and is funded in API billing (https://popnow.ai/api/console/billing). Run `quote`, tell the user the USD price (`maxChargeUsd`) and their API balance, and only after a clear yes run `create --confirm-usd <maxChargeUsd>`. The script re-quotes and will not start if the price went up (exit code 3, nothing charged). Failed tasks release their hold, so they cost nothing.
## Setup
```bash
export POPNOW_API_KEY="sk-popnow-..." # https://popnow.ai/api/console/keys
python3 scripts/popnow.py balance
```
## Create an image
```bash
python3 scripts/popnow.py quote --model google/nano-banana-2.1/text-to-image \
--prompt "A paper boat on a rainy window sill, soft morning light" --aspect-ratio 4:5
# tell the user: "This costs $0.048 from your API balance. Go ahead?" -> on yes:
python3 scripts/popnow.py create --model google/nano-banana-2.1/text-to-image \
--prompt "A paper boat on a rainy window sill, soft morning light" --aspect-ratio 4:5 \
--confirm-usd 0.048 --download ./popnow-output
```
Image