arrow_back All endpoints

AI Image Upscale

POST/api/v1/tools/image-upscale30 credits per callimageupscaleenlargeaiesrgan

Downloads a PNG, JPEG, WebP or BMP from a public URL and upscales it on the media worker. Factor 2 is the default; factor 4 costs the same credits but takes longer and rejects larger source files.

receipt_long
Why 30 credits?

Real-ESRGAN is the heaviest synchronous job in the catalogue. One call can occupy the worker for tens of seconds.

Any HTTP client works. Replace the key with one from your dashboard.

bash
curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/image-upscale \
  -H "Authorization: Bearer tb_live_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "fileUrl": "https://example.com/photo.jpg",
  "factor": 2
}'

Input

FieldTypeRequiredDefaultDescription
fileUrlstringrequired- Publicly reachable URL of the image.
factorintegeroptional2 Upscale factor. 2 or 4. Defaults to 2.

Output

FieldTypeDescription
fileBase64stringUpscaled image, base64-encoded, without a data URI prefix.
mimeTypestringOutput image MIME type.
fileNamestringSuggested download name.
sizeBytesintegerSize of the decoded image.
factorintegerThe factor that was applied.

Try it

Sends a real POST /api/v1/tools/image-upscale from your browser and charges 30 credits to your account.

Sign in to run this endpoint. New accounts start with free credits.