{"openapi":"3.1.0","info":{"title":"Image API","version":"1.0.0","description":"Inspect image metadata (dimensions, format, size, colour space, transparency) and resize or convert images between JPEG, PNG, WebP and AVIF straight from a URL. Perfect for thumbnails, format optimisation and on-the-fly image transforms.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/image-api","description":"oanor gateway"}],"tags":[{"name":"Image"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/file":{"get":{"operationId":"get_v1_file","tags":["Image"],"summary":"Resize/convert (raw image)","description":"","parameters":[{"name":"url","in":"query","required":true,"description":"Image URL","schema":{"type":"string"},"example":"https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg"},{"name":"width","in":"query","required":false,"description":"Target width 1-4000","schema":{"type":"string"},"example":"200"},{"name":"height","in":"query","required":false,"description":"Target height 1-4000","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"jpeg|png|webp|avif","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/info":{"get":{"operationId":"get_v1_info","tags":["Image"],"summary":"Image metadata","description":"","parameters":[{"name":"url","in":"query","required":true,"description":"Image URL","schema":{"type":"string"},"example":"https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"url":"https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg","width":172,"format":"jpeg","height":178,"density":100,"channels":3,"has_alpha":false,"size_bytes":9022,"color_space":"srgb"},"meta":{"timestamp":"2026-05-30T01:04:59.939Z","request_id":"1e7e6920-f3a5-4084-b5a7-857ef40d63d2"},"status":"ok","message":"Image info retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/resize":{"get":{"operationId":"get_v1_resize","tags":["Image"],"summary":"Resize/convert (base64 JSON)","description":"","parameters":[{"name":"url","in":"query","required":true,"description":"Image URL","schema":{"type":"string"},"example":"https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg"},{"name":"width","in":"query","required":false,"description":"Target width 1-4000","schema":{"type":"string"},"example":"200"},{"name":"height","in":"query","required":false,"description":"Target height 1-4000","schema":{"type":"string"}},{"name":"format","in":"query","required":false,"description":"jpeg|png|webp|avif","schema":{"type":"string"}},{"name":"fit","in":"query","required":false,"description":"inside|cover|contain|fill|outside","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"bytes":5109,"image":"data:image/jpeg;base64,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","width":200,"format":"jpeg","height":207},"meta":{"timestamp":"2026-05-30T01:05:00.285Z","request_id":"814a323d-ad31-49b5-b842-96367dd0f672"},"status":"ok","message":"Image resized successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":750,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":700,"monthly_call_quota":25000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":120000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5900,"monthly_call_quota":500000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/image-api"}