Skip to main content
POST
Upscale an image (existing API)
This is a legacy endpoint for existing integrations. New integrations should use the public v1 API. For existing integrations. Use the upscale guide for new work. Existing response formats and version handling →

Authorizations

Authorization
string
header
required

Create an API key in Studio → account menu → API Keys. Keep it on your server.

Path Parameters

id
string<uuid>
required

Image or asset ID from a previous response. Resource ID.

Body

application/json
upscale_factor
enum<integer>
required

Upscale option. 4 selects the 4K workflow; do not assume it literally multiplies both dimensions by four.

Available options:
1,
2,
4
Example:

2

version_id
string<uuid>

Optional selection from an existing Studio image history. When chaining completed API results, use result.id from the v1 job response as the source image and omit this field.

denoise
number

Legacy detail-change setting. Ignored by the SeedVR processor used for upscale_factor 1 and 2; that processor chooses noise internally.

Required range: 0 <= x <= 1

Response

Returns the parent image with a new version. The original may already be completed. Track the new version id and poll its source_image_id for the operation’s result.

id
string<uuid>
required

Resource ID.

status
enum<string>
required

Job state. Only completed has a finished result.

Available options:
pending,
generating,
completed,
failed,
policy_blocked,
nsfw_filtered
path
string | null

Result URL. Can be null while the job is pending.

watermarked_path
string | null
width_px
integer | null
height_px
integer | null
size_bytes
integer | null
extension
string | null
is_generated
boolean
for_training
boolean

Whether the upload is a reusable asset reference.

task
string | null

Operation that created this job.

type
string | null
created_timestamp
string<date-time>
finish_timestamp
string<date-time> | null
fail_reason
string | null

Human-readable failure detail.

failure_code
enum<string> | null

Machine-readable failure category, when available.

Available options:
input_rejected,
provider_unavailable,
queue_timeout,
policy_blocked
asset_ids
string<uuid>[] | null

Linked reusable assets.

Resource ID.

versions
object[]

Related versions. May be omitted or empty. Never infer a new version is completed from the parent status.