One call, several steps in order: resize, crop, rotate, convert (JPEG/PNG/WebP/AVIF/TIFF), quality, text or image watermark, keep or strip metadata. Sharp under the hood.
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 -H 'Authorization: Bearer $KEY' -F 'file=@photo.jpg' -F 'ops={"resize":{"width":1200},"format":"webp","quality":80}' -o photo.webpAdd 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: “Resize this image to 1200px wide, convert to WebP and strip metadata.” – the model calls the image_process tool.
| Param | Type | Required | Notes |
|---|---|---|---|
file | file | yes | Source image. |
ops | json | yes | Operations object: {resize:{width,height,fit}, crop:{left,top,width,height}, rotate, format, quality, palette, watermark:{text,position,opacity}, keepMetadata} |
watermark | file | no | Optional second file used as image watermark. |
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 |
As given in the ops object: resize → crop → rotate → format/quality → watermark.
Yes, by default – set keepMetadata=true to preserve EXIF/ICC.
Both: watermark.text or a second uploaded file, with gravity and opacity.