REST API

Build with Imagenary

Every tool on the platform is available via a simple REST API. Extract text, refresh images, generate descriptions, and host files — all from your own code.

Get API Access View Pricing

Simple integration

Multipart form POST. No SDKs needed — works with curl, fetch, or any HTTP client.

Same pricing

API uses deduct from the same balance as the web tools. No separate API pricing.

All tools included

Extract, describe, refresh, touch-up, generate, and image hosting — one API.

Authentication

All API requests require a Bearer token. Get your token from your account settings after signing in.

Authorization: Bearer YOUR_ACCESS_TOKEN

Your access token is tied to your account and uses your balance. Keep it secret.

Endpoints

POST/api/imageImage Tools

Extract text, describe images, refresh photos, touch-up, and generate faces.

Parameters

NameTypeReqDescription

fileFileYesImage file (PNG, JPG, WebP). Not required for describe with image_url.

toolstringYes"extract" | "describe" | "refresh" | "touchup" | "generate"

modelstringNoFor extract: "cloud_vision" | "gemini" | "gpt4o"

promptstringNoCustom prompt for describe, touchup, or generate.

image_urlstringNoURL of image to describe (alternative to file upload).

strengthnumberNoTouch-up strength 0.15–0.8 (default 0.35).

Example request

curl -X POST https://www.imagenary.ai/api/image \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "[email protected]" \
  -F "tool=extract" \
  -F "model=gemini"

Example response

{
  "result": "Extracted text from the image...",
  "remaining": 480,
  "usedFree": false,
  "preview": false
}

POST/api/imageurlImage to URL

Upload an image or PDF and get a public hosted URL.

Parameters

NameTypeReqDescription

fileFileYesImage or PDF file up to 50MB.

Example request

curl -X POST https://www.imagenary.ai/api/imageurl \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "[email protected]"

Example response

{
  "url": "https://www.imagenary.ai/i/20260407-photo-abc123.jpg",
  "filename": "20260407-photo-abc123.jpg",
  "size": 245760,
  "type": "image/jpeg"
}

Error codes

CodeMeaning

400Bad request — missing or invalid parameters.

401Not authenticated. Sign in or provide a valid Bearer token.

402No balance remaining. Top up at /pricing.

413File too large. Max 20MB for tools, 50MB for image hosting.

500Server error. Try again or contact support.

Ready to integrate?

Get started