>_
SudoMock
POST

Render Mockup

Generate production-ready mockups by compositing your designs into uploaded PSD templates. Sub-second response time, multiple export formats.

POST/api/v1/renders
<1s avg

Lightning Fast

Average render time is under 1 second. Built for high-volume automation with 2M+ renders processed.

Request

Headers

X-API-KEYstringRequired

Your SudoMock API key starting with sm_

Content-TypestringRequired

Must be application/json

Request Body

mockup_uuidstringRequired

UUID of the uploaded mockup template (from /psd/upload response)

smart_objectsarrayRequired

Array of smart object configurations to render

export_optionsobject

Output format, size, and quality settings

export_labelstring

Optional label for the export file naming

Smart Object Configuration

uuidstringRequired

UUID of the smart object to fill (from upload response)

assetobject

Image asset configuration

asset.urlstring

URL to the image to place in the smart object

asset.fitenum= fill

How to fit the image: fill (default), contain, or cover

asset.rotateinteger= 0

Rotation angle in degrees (-360 to 360)

asset.sizeobject

Custom size override: { width, height } in pixels

asset.positionobject

Custom position override: { top, left } in pixels

colorobject

Color overlay configuration

color.hexstring

Hex color code (e.g., '#FF5733')

color.blending_modestring= normal

Blend mode: normal, multiply, screen, overlay, etc.

adjustment_layersobject

Image adjustments to apply

Adjustment Layers

brightnessinteger= 0

Brightness adjustment (-150 to 150)

contrastinteger= 0

Contrast adjustment (-100 to 100)

saturationinteger= 0

Saturation adjustment (-100 to 100)

vibranceinteger= 0

Vibrance adjustment (-100 to 100)

opacityinteger= 100

Layer opacity (0 to 100)

blurinteger= 0

Gaussian blur amount (0 to 100)

Export Options

image_formatenum= webp

Output format: png, jpg, or webp

image_sizeinteger

Output width in pixels (100-8000). Height scales proportionally.

qualityinteger= 95

Quality for JPG/WebP output (1-100)

WebP Recommended

WebP format is ~30% smaller than PNG with similar quality. Perfect for web and e-commerce.
Full Request Example
1
{
2
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
3
  "smart_objects": [
4
    {
5
      "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
6
      "asset": {
7
        "url": "https://your-domain.com/design.png",
8
        "fit": "cover"
9
      },
10
      "color": {
11
        "hex": "#FF5733",
12
        "blending_mode": "multiply"
13
      },
14
      "adjustment_layers": {
15
        "brightness": 10,
16
        "contrast": 5
17
      }
18
    }
19
  ],
20
  "export_options": {
21
    "image_format": "webp",
22
    "image_size": 1920,
23
    "quality": 95
24
  }
25
}

Code Examples

Render Mockup
bash
1
curl -X POST "https://api.sudomock.com/api/v1/renders" \
2
  -H "Content-Type: application/json" \
3
  -H "X-API-KEY: sm_your_api_key" \
4
  -d '{
5
    "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
6
    "smart_objects": [{
7
      "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
8
      "asset": {
9
        "url": "https://your-domain.com/design.png",
10
        "fit": "cover"
11
      }
12
    }],
13
    "export_options": {
14
      "image_format": "webp",
15
      "image_size": 1920,
16
      "quality": 95
17
    }
18
  }'

Response

Success Response

200OK
Response 200 OK
1
{
2
  "success": true,
3
  "data": {
4
    "print_files": [
5
      {
6
        "export_path": "https://cdn.sudomock.com/renders/abc123.webp",
7
        "smart_object_uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9"
8
      }
9
    ]
10
  }
11
}

Response Fields

print_filesarrayRequired

Array of rendered output files

print_files[].export_pathstringRequired

URL to the rendered mockup image (valid for 24 hours)

print_files[].smart_object_uuidstringRequired

UUID of the smart object that was rendered

Error Responses

400Bad Request
json
1
{
2
  "success": false,
3
  "detail": "Invalid smart object UUID"
4
}
401Unauthorized
json
1
{
2
  "success": false,
3
  "detail": "Invalid or missing API key"
4
}
404Not Found
json
1
{
2
  "success": false,
3
  "detail": "Mockup not found"
4
}

Try It Live

POST/api/v1/renders

Render a mockup with your design.

Get your API key from the Dashboard

Image Fit Modes

The fit parameter controls how your design is placed within the smart object bounds:

ModeBehaviorUse Case
fillStretches to fill entire areaWhen aspect ratio matches
containFits inside, may leave spaceWhen design must be fully visible
coverFills area, may crop edgesMost common for product mockups

Blend Modes

Apply color overlays with various blending modes for realistic effects:

normal
multiply
screen
overlay
darken
lighten
color-dodge
color-burn
hard-light
soft-light
difference
exclusion

Bulk Rendering

Parallel Requests

For bulk rendering, send parallel requests up to your plan's concurrency limit. Each request is independent—no need to wait for previous renders to complete.

Need a feature that's not here? Request it or see what's planned.

Bulk Rendering Example
1
// JavaScript: Render 10 variations in parallel
2
const designs = [
3
  "https://cdn.example.com/design-1.png",
4
  "https://cdn.example.com/design-2.png",
5
  // ... more designs
6
];
7
8
const renderPromises = designs.map(designUrl => 
9
  fetch("https://api.sudomock.com/api/v1/renders", {
10
    method: "POST",
11
    headers: {
12
      "Content-Type": "application/json",
13
      "X-API-KEY": "sm_your_api_key"
14
    },
15
    body: JSON.stringify({
16
      mockup_uuid: "your-mockup-uuid",
17
      smart_objects: [{
18
        uuid: "smart-object-uuid",
19
        asset: { url: designUrl, fit: "cover" }
20
      }]
21
    })
22
  }).then(r => r.json())
23
);
24
25
const results = await Promise.all(renderPromises);
26
const renderUrls = results.map(r => r.data.print_files[0].export_path);
Upload PSDn8n Integration