Dimensions, format, colour space, EXIF/ICC presence as JSON. The cheap look-before-you-leap call for agent pipelines.
Get a key first – no signup: curl -X POST https://api.bigapi.dev/v1/keys (100 free operations, 7 days).
curl -X POST https://api.bigapi.dev/v1/image/info -H 'Authorization: Bearer $KEY' -F 'file=@photo.jpg'
Add BiGapi to Claude Desktop, Cursor or any MCP client – the server fetches its own key on first use:
{
"mcpServers": {
"bigapi": { "command": "npx", "args": ["-y", "@bigapi/mcp"] }
}
}
Then simply ask: “Check this image: what format and size is it?” – the model calls the image_info tool.
| Param | Type | Required | Notes |
|---|---|---|---|
file | file | yes |
Idempotency-Key are free · prepaid credit from $5, never expires.Every response carries X-BigAPI-Cost, X-BigAPI-Balance and X-BigAPI-Free-Ops – your agent can budget on its own.
| Status | Meaning | Agent action |
|---|---|---|
401 | missing/invalid key | POST /v1/keys for a fresh one |
402 | credit exhausted | show the upgrade_url from the response to a human |
413 | file too large | split the input (limit 100 MB) |
422 | conversion failed | check the detail field – costs $0 |
429 | rate limited | wait retry_after seconds |
It reports presence and key fields – for full pixel work use /v1/image.
Everything sharp reads: JPEG, PNG, WebP, AVIF, TIFF, GIF, SVG and more.
A JSON fact costs 1 cent and is always right – tokens are more expensive.