Skip to main content
POST
Upscale an image with P-Image Upscale

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
image
string
required

Image to upscale. A public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads.

enhance_details
boolean
default:false

Enhance textures and fine detail (may increase contrast).

enhance_realism
boolean
default:false

Improve realism — recommended for AI-generated images.

output_format
enum<string>
default:jpg

Output format (jpg recommended; png files get very large at high megapixel targets).

Available options:
jpg,
png,
webp
target
enum<integer>
default:4

Target output resolution in megapixels. Sets the price: 4 MP = 10, 8 MP = 15, 16 MP = 30, 32 MP = 60 credits.

Available options:
4,
8,
16,
32

Response

Job accepted.

credits
integer

Total price of this job (flat per image

id
string

Opaque job id — use it to poll status.

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout