Picnow Image Generation Skill
Picnow wraps the api.letmego.top GPT-Image-2 API. This skill handles
text-to-image and image-to-image (edit) generation.
The script uses the async API (/v1/async/images/...) — it submits the
job, polls until completion, and prints the final URL. This avoids the 100s
Cloudflare edge timeout that 2K/4K renders used to hit. A single call may
take up to ~5 minutes for heavy renders; no extra flags needed.
1. Environment check
Before generating, verify the token is set:
if [ -z "$LETMEGO_API_KEY" ]; then
echo "❌ LETMEGO_API_KEY is not set."
echo "Visit https://api.letmego.top to get your 令牌, then:"
echo " export LETMEGO_API_KEY=your_token"
exit 1
fi
2. Gather parameters
Ask the user if not already provided:
| Parameter | Options | Default |
|---|---|---|
prompt |
any text description | (required) |
quality |
1k · 2k · 4k |
1k |
aspect |
square · landscape · portrait |
square |
n |
1 – 10 | 1 |
ref |
local file path (optional) | (none → text-to-image) |
Quality guide:
- 1k — up to 1536×1536, fast and cheap, great for previews and social media
- 2k — up to 2048×2048, suitable for e-commerce and print
- 4k — up to 3840×2160, landscape or portrait only (no 4k square)
3. Locate and run the generation script
# Resolve skill directory (user-global → project-local)
SKILL_DIR="$HOME/.claude/skills/picnow"
[ -d "$SKILL_DIR" ] || SKILL_DIR=".claude/skills/picnow"
node "$SKILL_DIR/scripts/generate.js" \
--prompt "PROMPT_HERE" \
--quality QUALITY \
--aspect ASPECT \
--n N
# add: --ref /path/to/image.jpg for image-to-image
The script outputs a single JSON line:
{ "urls": ["https://...cdn.../image.png"] }
4. Present results
- Display each URL as a clickable link or inline image.
- For multiple images, list them with index labels (1/3, 2/3, …).
- Offer to download, save to a project, or run another variation.
Error handling
| Exit condition | Meaning | Action |
|---|---|---|
LETMEGO_API_KEY missing |
Token not set | Guide user to picnow settings |
| HTTP 401 | Token invalid | Ask user to check or refresh token |
| HTTP 402 / quota | Insufficient balance | Direct to letmego.top recharge |
| HTTP 4xx other | Bad request | Show upstream error message |
| Network error | Connection issue | Suggest retry |
Examples
Text-to-image:
User: 帮我画一张珠宝产品主图，白色背景，高清
→ quality=2k, aspect=square
→ node "$SKILL_DIR/scripts/generate.js" \
--prompt "jewelry product hero shot, white background, studio lighting, photorealistic" \
--quality 2k --aspect square --n 1
Image-to-image:
User: 把这张图改成动漫风格 [uploads reference.jpg]
→ quality=1k, ref=reference.jpg
→ node "$SKILL_DIR/scripts/generate.js" \
--prompt "anime style illustration, vibrant colors, clean linework" \
--quality 1k --aspect square --n 1 --ref reference.jpg
Landscape banner:
User: Generate a landscape banner for a coffee brand
→ quality=1k, aspect=landscape, n=2
→ node "$SKILL_DIR/scripts/generate.js" \
--prompt "coffee brand lifestyle banner, warm tones, morning light, artisan aesthetic" \
--quality 1k --aspect landscape --n 2
