# bigapi.dev > The output layer for AI agents. One cent per operation. Credits never expire. bigapi gives agents and developers deterministic file operations a language model cannot do itself: render HTML/Markdown/URL to PDF or PNG, merge/split/rotate/compress PDFs, rasterize pages, resize/convert/watermark images. No signup: `POST https://api.bigapi.dev/v1/keys` returns a key with 100 free operations (7 days). After that 1 cent per operation, prepaid from 5 EUR, never expires, no subscription. Errors are free. Servers in Germany, files deleted after processing. ## Get access - `curl -X POST https://api.bigapi.dev/v1/keys` → `{ "key": "bigapi_…", "upgrade_url": … }` - Send `Authorization: Bearer `. Every response carries `X-BigAPI-Cost`, `X-BigAPI-Balance`, `X-BigAPI-Free-Ops`. - Out of credit → HTTP 402 with `upgrade_url`. Monthly cap per key (default 10 EUR) → HTTP 429 `cap_reached`, raise with `PATCH /v1/keys/{id}`. - Optional header `Idempotency-Key` makes retries free. ## MCP - `npx -y @bigapi/mcp` – tools: get_access, render, pdf_merge, pdf_split, pdf_rotate, pdf_compress, pdf_to_images, image_process, image_info, get_balance, get_usage, set_monthly_cap, get_pricing - Claude Desktop config: `{"mcpServers":{"bigapi":{"command":"npx","args":["-y","@bigapi/mcp"]}}}` ## Operations ### Render & output - [HTML / Markdown / URL → PDF or PNG](https://api.bigapi.dev/v1/render): POST /v1/render (json) – Chromium-rendered PDF or screenshot from HTML, Markdown or a URL. Real fonts, CSS, page breaks – not a text-to-PDF shim. 1 cent per operation. - `curl -X POST https://api.bigapi.dev/v1/render -H 'Authorization: Bearer $KEY' -H 'Content-Type: application/json' -d '{"html":"

Invoice 4711

","format":"pdf"}' -o invoice.pdf` ### PDF - [Merge PDFs](https://api.bigapi.dev/v1/pdf/merge): POST /v1/pdf/merge (multipart) – Combine two or more PDFs into one, in the order given. 1 cent per operation. - `curl -X POST https://api.bigapi.dev/v1/pdf/merge -H 'Authorization: Bearer $KEY' -F 'files[]=@a.pdf' -F 'files[]=@b.pdf' -o merged.pdf` - [Split / extract pages](https://api.bigapi.dev/v1/pdf/split): POST /v1/pdf/split (multipart) – Extract a page range into a new PDF. Ranges like 1-3,7,9-z. 1 cent per operation. - `curl -X POST https://api.bigapi.dev/v1/pdf/split -H 'Authorization: Bearer $KEY' -F 'file=@in.pdf' -F 'pages=2-4' -o part.pdf` - [Rotate pages](https://api.bigapi.dev/v1/pdf/rotate): POST /v1/pdf/rotate (multipart) – Rotate all or selected pages by 90, 180 or 270 degrees. 1 cent per operation. - `curl -X POST https://api.bigapi.dev/v1/pdf/rotate -H 'Authorization: Bearer $KEY' -F 'file=@in.pdf' -F 'angle=90' -o rotated.pdf` - [Compress PDF](https://api.bigapi.dev/v1/pdf/compress): POST /v1/pdf/compress (multipart) – Shrink a PDF by downsampling images. Levels screen, ebook, printer, prepress. 1 cent per operation. - `curl -X POST https://api.bigapi.dev/v1/pdf/compress -H 'Authorization: Bearer $KEY' -F 'file=@big.pdf' -F 'level=ebook' -o small.pdf` - [PDF → images](https://api.bigapi.dev/v1/pdf/pages): POST /v1/pdf/pages (multipart) – Rasterize pages to JPEG or PNG. One image or a ZIP when more than one page. 1 cent per operation. - `curl -X POST https://api.bigapi.dev/v1/pdf/pages -H 'Authorization: Bearer $KEY' -F 'file=@in.pdf' -F 'first=1' -F 'last=1' -F 'format=png' -o page1.png` ### Image - [Resize · crop · convert · watermark](https://api.bigapi.dev/v1/image): POST /v1/image (multipart) – One call, several steps: resize, crop, rotate, convert (jpeg, png, webp, avif), quality, palette, text or image watermark, keep or strip metadata. 1 cent per operation. - `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.webp` - [Image info](https://api.bigapi.dev/v1/image/info): POST /v1/image/info (multipart) – Dimensions, format, colour space, EXIF and embedded metadata as JSON. 1 cent per operation. - `curl -X POST https://api.bigapi.dev/v1/image/info -H 'Authorization: Bearer $KEY' -F 'file=@photo.jpg'` ## Coming next - Attach Content Credentials (C2PA) (/v1/image/c2pa/sign) – Embed a signed C2PA manifest marking the image as AI-generated or AI-edited – the machine-readable label Art. 50 AI Act asks for. - Verify Content Credentials (/v1/image/c2pa/verify) – Read and validate an embedded C2PA manifest. Tells whether a file carries an AI label and whether it is intact. - Visible AI label (/v1/image/ai-label) – Stamp the EU AI-content icon or a custom label onto an image, corner or banner, with the metadata marker kept intact. - Website screenshot (/v1/screenshot) – Full-page or viewport screenshot of a URL with device presets. The render tile already does this; this tile is the simpler front door agents search for. - OCR – searchable PDF or text (/v1/ocr) – Scanned PDF or image → searchable PDF, plain text or word boxes. Billed per page. - Office → PDF (/v1/office/pdf) – DOCX, XLSX, PPTX, ODT → PDF via LibreOffice. Billed per page. - Convert to PDF/A (/v1/pdf/pdfa) – Archival PDF/A-2b with embedded fonts and validation report. ## Reference - [OpenAPI 3.1](https://api.bigapi.dev/openapi.json) - [Interactive docs](https://api.bigapi.dev/docs) - [Pricing](https://api.bigapi.dev/v1/pricing) - [Console](https://console.bigapi.dev) – balance, usage, keys