Image Upscale
studio-upscale-imageUpscale a single image to 2K or 4K with neural super-resolution. Synchronous JPEG output.
Send a source image URL and a target resolution. The service reconstructs texture and edges with a generative super-resolution model and returns a sharp 2K or 4K JPEG. The result URL is returned immediately in the response.
POST
/v1/proxy/studio-upscale-imageImage upscale to 2K or 4K (synchronous)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
imageUrl | string | required | Public URL of the source image (JPEG or PNG, ≤ 4.7 MB, ≤ 4096×4096, aspect ratio 1:3–3:1) |
resolution | string | optional | "2k" (default) or "4k" |
curl -X POST https://api.cn8.io/v1/proxy/studio-upscale-image \
-H "X-API-Key: <cn8_api_key>" \
-H "Content-Type: application/json" \
-d '{"imageUrl":"https://example.com/file"}'Response
{
"status": "success",
"data": {
"url": "https://cdn.example.com/images/upscale/abc123.jpg",
"key": "images/upscale/ab/cd/abcd1234.jpg",
"folder_id": "abcd1234",
"content_type": "image/jpeg",
"resolution": "2k",
"width": 2048,
"height": 1448
},
"cost": { "tokens": 1, "unit_price": 6, "balance": 1234 }
}
Billing: 6 credits per image, 2K and 4K alike. Rejected (400) and failed requests are not charged. No polling required; the result is synchronous.
Input limits
| Limit | Value |
|---|---|
| Formats | JPEG, PNG |
| File size | up to 4.7 MB |
| Dimensions | up to 4096 × 4096 px |
| Aspect ratio | between 1:3 and 3:1 |
| Output | JPEG, about 2048 px (2K) or 4096 px (4K) on the long edge |
| Images per request | 1 |