✛ Images
Upscale & Restore
Send an image by link or as base64. You get a PNG at 2x or 4x, or fitted to A6, A5, A4 or A3 at 300 DPI. Images up to 1024 by 1024 pixels are answered in the same call, in a few seconds; images up to 4 megapixels and paper sizes are queued. Face restoration is not included yet.
Queue an upscale. Charged per image, and refunded if it fails.
POST/v1/upscale/image
Try it ↓Answers 202 with a job_id. Poll GET /v1/jobs/{id} (free) or pass callback_url. How long jobs work.
- Price
- $0.0048 per large image · REST and MCP
- RapidAPI
- $0.006 per large image · listing at launch
- Returns
- application/json
- MCP tool
- upscale_restore_upscale
Request body
| Field | Type | Description |
|---|---|---|
| image_url | string | Direct https link to a PNG, JPEG or WebP, up to 40 MB and 4 megapixels. |
| image_base64 | string | The file itself, base64, when it fits in the 2 MB request limit. |
| scale | integer | 2 or 4. Leave out when you set paper. |
| paper | a6 a5 a4 a3 | Fit inside this paper size at 300 DPI, in the image's own orientation. Refused if that would take more than 4×. |
| callback_url | string | Told the job's id and status when it ends, signed with your webhook secret. |
example
curl https://readymadeapi.com/v1/upscale/image \
-H "Authorization: Bearer $READYMADE_KEY" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://readymadeapi.com/samples/product.jpg",
"scale": 4
}'What comes back
At once, from this call (202){
"job_id": "01a1f553-f0fb-74dc-8c44-05117bb0e9eb",
"status": "queued",
"status_url": "/v1/jobs/01a1f553-f0fb-74dc-8c44-05117bb0e9eb",
"result_url": "/v1/jobs/01a1f553-f0fb-74dc-8c44-05117bb0e9eb/result"
}Later, from GET /v1/jobs/{id}, when the job is done{
"job_id": "01a1f553-f0fb-74dc-8c44-05117bb0e9eb",
"status": "succeeded",
"late": false,
"deadline": "2026-11-20T19:41:21.528789Z",
"completed_at": "2026-11-19T19:41:42.442212Z",
"error": null,
"result": {
"width": 7200,
"height": 7200,
"png_base64": "iVBORw0KGgoAAAANSUhEUgAAHCAAABwgCAIAAAD4ik0VAAEAAElEQVR4nOzc... (24584844 characters)"
}
}Upscale one image 2x or 4x and get the result in the same call, in a few seconds. Images up to 1024 by 1024 pixels.
POST/v1/upscale/instant
Try it ↓- Price
- $0.0016 per image · REST and MCP
- RapidAPI
- $0.002 per image · listing at launch
- Returns
- application/json
- MCP tool
- upscale_restore_upscale_now
Request body
| Field | Type | Description |
|---|---|---|
| image_url | string | Direct https link to a PNG, JPEG or WebP, up to 40 MB and 4 megapixels. |
| image_base64 | string | The file itself, base64, when it fits in the 2 MB request limit. |
| scale | integer | 2 or 4. Leave out when you set paper. |
| paper | a6 a5 a4 a3 | Fit inside this paper size at 300 DPI, in the image's own orientation. Refused if that would take more than 4×. |
| callback_url | string | Told the job's id and status when it ends, signed with your webhook secret. |
example
curl https://readymadeapi.com/v1/upscale/instant \
-H "Authorization: Bearer $READYMADE_KEY" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://readymadeapi.com/samples/small.jpg",
"scale": 4
}'What comes back
{
"png_base64": "iVBORw0KGgoAAAANSUhEUgAABQAAAAUACAIAAACXhmigAAEAAElEQVR4nOz9... (1092796 characters)",
"width": 1280,
"height": 1280
}Use it from an agent
Every endpoint above is also an MCP tool. Add the server to Claude, Cursor or any MCP client and the tools appear with their prices; calls draw from the same credit.
mcp config
{
"mcpServers": {
"readymade": {
"type": "http",
"url": "https://readymadeapi.com/mcp",
"headers": {
"Authorization": "Bearer ${READYMADE_KEY}"
}
}
}
}