Detailer Upscaler
POST/v2/artworks/detailer-upscaler
Sharpen fine details in an image and optionally upscale it. Set scaleFactor to 1 for detail enhancement only, or 2, 4, or 8 to combine enhancement with upscaling.
Request
- application/json
Body
required
The URL of the image. The image's total area (width × height) must not exceed 1,478,656 pixels (e.g., 1216 × 1216). Accepted image formats: JPEG, JPG, PNG, and WebP.
Default value: 2
Scale factor for upscaling. 1 = enhance details only (no upscaling), 2/4/8 = enhance details + upscale.
Possible values: >= 1 and <= 3
Default value: 2
Detail enhancement level. 1 = Low, 2 = Medium, 3 = High.
Possible values: >= 1 and <= 3
Default value: 2
Modification strength. 1 = Subtle, 2 = Balanced, 3 = Strong.
Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion.
Responses
- 202
- 400
- 401
- 403
- 429
- 500
Response indicating that the artwork enhancement has started.
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [detailer_upscaler]
parameters
object
required
The URL of the image. The image's total area (width × height) must not exceed 1,478,656 pixels (e.g., 1216 × 1216). Accepted image formats: JPEG, JPG, PNG, and WebP.
Default value: 2
Scale factor for upscaling. 1 = enhance details only (no upscaling), 2/4/8 = enhance details + upscale.
Possible values: >= 1 and <= 3
Default value: 2
Detail enhancement level. 1 = Low, 2 = Medium, 3 = High.
Possible values: >= 1 and <= 3
Default value: 2
Modification strength. 1 = Subtle, 2 = Balanced, 3 = Strong.
Optional webhook URL. When provided, the server will POST the final artwork result to this URL upon completion.
Possible values: [starting, processing, succeeded, failed, canceled]
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"artworkType": "detailer_upscaler",
"parameters": {
"imageUrl": "string",
"scaleFactor": 2,
"details": 2,
"modification": 2,
"webhook": "string"
},
"duration": 0,
"results": [
"string"
],
"status": "starting",
"createdAt": "2024-07-29T15:51:28.071Z"
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Too Many Requests
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
Available only when the message includes additional error details.
{
"message": "string",
"statusCode": 0,
"error": "string"
}