PixGB API

REST JSON API for uploads, library management, and ImgBB-style replace. Auth with your Library API token.

Auth

X-Api-Token: YOUR_TOKEN
X-API-Key: YOUR_TOKEN
Authorization: Bearer YOUR_TOKEN
# or
?key=YOUR_TOKEN

Token lives on Library after you sign in.

Upload

curl -X POST "https://pixgb.com/api/v1/upload" \
  -H "X-Api-Token: YOUR_TOKEN" \
  -F "image=@photo.jpg" \
  -F "name=optional-title.jpg" \
  -F "isPrivate=false"

Also accepts field name file, base64 in image (ImgBB-style), and optional resize fields (resizeMode, allowUpscale).

Response shape

{
  "success": true,
  "data": {
    "url": "https://pixgb.com/i/…",
    "display_url": "https://pixgb.com/o/…",
    "thumb_url": "https://pixgb.com/t/…",
    "links": { "bbcode": "[img]…[/img]", "markdown": "…", "html": "…" }
  }
}

Other endpoints

• GET /api/v1 — discovery
• GET /api/v1/account — plan, storage, bandwidth
• GET /api/v1/images — paginated library
• GET /api/v1/images/{code}
• PATCH /api/v1/images/{code} — {"isPrivate":true,"customSlug":"my-pic"}
• POST /api/v1/images/{code}/replace — keep same link, new file
• POST /api/v1/images/{code}/resize — resizeMode=2x|3840|custom (+ optional width/height)
• DELETE /api/v1/images/{code}