BigImg API

Call BigImg's tools from your own code. Get a key from your dashboard — usage counts against that account's own free monthly images, credits, or plan. There's no separate API-only free tier.

Authentication

Send your key as a bearer token on every request:

Authorization: Bearer bigimg_live_...

Upscale an image

POST https://bigimg.ai/api/v1/upscale

Field	Type	Description
`imageUrl`	string (required)	Publicly accessible URL of the source image
`scale`	number	2, 4, 8, or 16. Default 2. 8/16 require a paid plan or credits.
`imageType`	string	"photo" or "anime". Default "photo".
`denoise`	string	"none" \| "low" \| "mid" \| "high" \| "max". Default "max".

Example

curl https://bigimg.ai/api/v1/upscale \
  -H "Authorization: Bearer bigimg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://example.com/photo.jpg",
    "scale": 4
  }'

Response

{
  "url": "https://replicate.delivery/.../output.png",
  "resizedTo": null,
  "via": "credit"
}

url is a temporary link (expires in roughly an hour) — download or re-host it if you need it to persist. via tells you which quota it drew from: free_pool, credit, unlimited, or share_bonus.

Errors

Status	Meaning
401	Missing, invalid, or revoked key
400	Bad request (missing imageUrl, invalid scale, file too large for your plan)
403	Feature requires a paid plan (scale/file size beyond the free tier)
429	Out of quota — buy credits or subscribe to Unlimited
502 / 504	Upstream model error or timeout — safe to retry

More tools

Only /api/v1/upscale is available today. Background removal, watermark removal, denoise, and enhance are next — let us know which one you need first.