ImgBB API

Upload images to ImgBB and get shareable URLs.

When This Skill Activates

This skill triggers when user wants to upload images to the web for sharing.

Reasoning Framework

Setup

export IMGBB_API_KEY="your_api_key_here"
# or
echo "your_api_key" > ~/.imgbb_api_key

Get API Key

1. Go to https://api.imgbb.com/
2. Click "Get API Key"
3. Copy your API key

Decision Tree

├── Upload single image → python imgbb.py image.jpg
├── Upload from URL → python imgbb.py --url "URL"
├── Custom name → python imgbb.py image.jpg --name myimg
├── Set expiration → python imgbb.py image.jpg --expiration 3600
├── Batch upload → python imgbb.py --batch ./folder/
└── JSON output → python imgbb.py image.jpg --json

Usage

# Upload file
python imgbb.py image.jpg

# With custom API key
python imgbb.py image.jpg --key YOUR_KEY

# From URL
python imgbb.py --url "https://..."

# Batch upload
python imgbb.py --batch ./folder/

# JSON output
python imgbb.py image.jpg --json

Options

Troubleshooting

No API key found

• Fix: Set IMGBB_API_KEY env or use --key

File not found

• Fix: Check file path is correct

Invalid image format

• Fix: Use JPG, PNG, GIF, or WEBP

Image too large

• Fix: Compress under 32MB

Quick Reference