Skip to main content
POST
/
v1
/
upscale
POST /v1/upscale — Upscale Images via API
curl --request POST \
  --url https://api.example.com/v1/upscale \
  --header 'Content-Type: application/json' \
  --data '
{
  "image": "<string>",
  "scale": 123
}
'
{
  "success": true,
  "image_url": "<string>",
  "request_id": "<string>",
  "credits_used": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.artnex.app/llms.txt

Use this file to discover all available pages before exploring further.

The /v1/upscale endpoint uses AI super-resolution to enlarge an image while preserving and recovering detail. Submit your image by URL or as a base64 string, and receive a link to the upscaled result.

​
Endpoint

POST https://api.artnex.ai/v1/upscale

​
Request parameters

​
image
string
required
The image to upscale. Provide either:
  • A publicly accessible HTTPS URL pointing to the image, or
  • A base64-encoded image string with a data URI prefix (e.g., data:image/jpeg;base64,...).
Supported formats: JPEG, PNG, WebP. Maximum input file size: 10 MB.
​
scale
number
default:"2"
The upscale multiplier applied to the original dimensions. For example, a 2 on a 512×512 image produces a 1024×1024 output. Common values: 2, 4.

​
Response fields

​
success
boolean
required
true when the request completed successfully.
​
image_url
string
required
Direct HTTPS URL to the upscaled image. Available for 24 hours; download promptly if you need to keep the result.
​
request_id
string
Unique identifier for this request.
​
credits_used
integer
Credits deducted from your balance. Upscaling costs 100 credits per request.

​
Credit cost

OperationCredits
Upscale (any scale factor)100

​
Example requests

curl --request POST \
  --url https://api.artnex.ai/v1/upscale \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "image": "https://example.com/product-photo.jpg",
    "scale": 4
  }'

​
Example response

{
  "success": true,
  "image_url": "https://cdn.artnex.ai/upscale/req_ups_abc123xyz/upscaled.jpg",
  "request_id": "req_ups_abc123xyz",
  "credits_used": 100
}

​
Error codes

HTTP statusError codeCause
400missing_imageThe image field is absent
400invalid_image_formatThe image format is not supported or the file is corrupt
400image_too_largeThe image exceeds the 10 MB size limit
400invalid_scaleThe scale value is outside the supported range
401invalid_api_keyThe API key is missing, malformed, or revoked
402insufficient_creditsYour account does not have enough credits
429rate_limit_exceededYou have exceeded your plan’s daily request quota
Upscaling works best on images that are already sharp. Heavily compressed or blurry source images will produce limited improvement.