Quick Start

Upload an image, get a URL. The URL serves your image from a global CDN, and query params resize, crop, or convert it on the fly. Your first request needs no account and no key.

Base URL https://api.img.pro/v1

Upload

Send a file to POST /v1/images — no token required for your first request:

curl -X POST "https://api.img.pro/v1/images" \
  -F "file=@photo.jpg"

{
  "id": "abc12345",
  "url": "https://src.img.pro/4j2/abc12345.jpg",
  "page_url": "https://img.pro/abc12345",
  "sizes": {
    "small":  { "url": "https://src.img.pro/4j2/abc12345.jpg?size=s", "width": 426,  "height": 320 },
    "medium": { "url": "https://src.img.pro/4j2/abc12345.jpg?size=m", "width": 853,  "height": 640 },
    "large":  { "url": "https://src.img.pro/4j2/abc12345.jpg?size=l", "width": 1440, "height": 1080 }
  },
  "width": 4000,
  "height": 3000,
  "status": "ready"
}

url is the image itself: a direct CDN URL you can drop into an <img> tag. page_url is the viewer page, the link you send to a person. That’s the short version; the full shape is in The Image object.

Prefer to import from a URL? Send JSON instead of a file and the same Image object comes back:

curl -X POST "https://api.img.pro/v1/images" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/photo.jpg"}'

Transform

To transform the image, add query params to its url. A named size is the quickest:

https://src.img.pro/4j2/abc12345.jpg?size=m

The sizes object in every response gives you three ready-made: small, medium, and large, included on every plan. A social/OG card is one request away too (?size=social, 1200×630). For exact dimensions, formats, background removal, or effects, see Transformations.

Next steps

That’s the whole loop. Where to go from here:

• Authentication — get an API key for your own images, or sign your users in as an app.
• API Reference — every endpoint: list, get, update, delete, batch, usage.
• Transformations — the full set of URL parameters.
• Pricing — upload and storage quotas per plan.