ImgBB API

Upload images to ImgBB via local file, URL, or base64 and get shareable direct links, supporting batch uploads and optional expiration settings.

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

Step	Action	Why
1	CHECK	Verify API key is available
2	PREPARE	Get image path or URL
3	UPLOAD	Send to ImgBB API
4	RETURN	Return shareable URL

---

Setup

bash

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

text

├── 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

bash

# 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

Flag	Description
image	Path to image
--key	API key
--url	Upload from URL
--name	Custom name
--expiration	Expiry seconds
--json	JSON output
--batch	Batch folder
--set-key	Save API key

---

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

Task	Command
Upload	python imgbb.py image.jpg
URL	python imgbb.py --url "URL"
Batch	python imgbb.py --batch ./folder/
JSON	python imgbb.py image.jpg --json