SFIMG API

Upload images programmatically and get direct links. API access is a Pro feature.

Base URL

https://www.sfimg.top

Authentication

Use your API key as a Bearer token. Keys are created in API Keys.

Authorization: Bearer fk_your_api_key

Upload an Image

POST /api/upload — multipart form, field name file.

curl -X POST "https://www.sfimg.top/api/upload"   -H "Authorization: Bearer fk_your_api_key"   -F "file=@photo.png"

Supported formats: JPG, JPEG, PNG, GIF, WEBP, BMP. Max 20MB per image for Pro.

Response

{
  "success": true,
  "url": "https://www.sfimg.top/i/abc123.png",
  "markdown": "![abc123.png](https://www.sfimg.top/i/abc123.png)",
  "bbcode": "[img]https://www.sfimg.top/i/abc123.png[/img]",
  "filename": "abc123.png",
  "status": "pending_review"
}

Rate Limits

PeriodLimit
Hourly120 uploads / key
Daily500 uploads / key

When you hit a limit you will receive HTTP 429 with a JSON error message.

Error Responses

StatusMeaning
403Invalid or inactive API key / Pro required
413File too large (over 20MB)
415Unsupported or invalid image file
429Rate limit reached or storage full
507Site storage is full

Manage API Keys View Pro Plan

← Back to homepage