>_
SudoMock

Quick Start

Get your first mockup rendered in under 5 minutes. This guide walks you through the entire process from signup to your first API call.

1
Sign Up
2
Get API Key
3
Upload PSD
4
Render!

Before You Start

You'll need:

  • A Photoshop mockup file (.psd) with smart object layers
  • A design image (PNG/JPG) to place in the mockup
  • A way to host your files (AWS S3, Cloudflare R2, or any public URL)

Don't have a PSD?

You can use any mockup PSD from sites like Freepik, GraphicBurger, or create your own. Just make sure it has at least one smart object layer.

Step 1: Create Your Account

Sign up for a free SudoMock account. No credit card required—you get 500 one-time API credits to test and validate your workflow.

Create Free Account
No credit card500 free creditsUnlimited Dashboard

Step 2: Get Your API Key

After logging in, navigate to the API Keys page and generate a new key.

  1. Go to Dashboard → API Keys
  2. Click "Generate New Key"
  3. Give it a name (e.g., "Development")
  4. Copy and save the key immediately—it won't be shown again!

Keep Your Key Secure

Your API key is like a password. Never commit it to public repositories or expose it in client-side code. Use environment variables instead.
Setting Environment Variable
1
# Store your API key as an environment variable
2
export SUDOMOCK_API_KEY="sm_your_api_key_here"
3
4
# Verify it's set
5
echo $SUDOMOCK_API_KEY

Step 3: Upload Your PSD Template

First, host your PSD file somewhere accessible (S3, R2, or any public URL). Then call the upload endpoint:

Upload PSD
1
curl -X POST "https://api.sudomock.com/api/v1/psd/upload" \
2
  -H "Content-Type: application/json" \
3
  -H "X-API-KEY: $SUDOMOCK_API_KEY" \
4
  -d '{
5
    "psd_file_url": "https://your-storage.com/mockup.psd",
6
    "psd_name": "My T-Shirt Mockup"
7
  }'

You'll receive a response with the mockup UUID and smart object details:

Upload Response
1
{
2
  "success": true,
3
  "data": {
4
    "uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
5
    "name": "My T-Shirt Mockup",
6
    "smart_objects": [
7
      {
8
        "uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
9
        "name": "Design Area",
10
        "size": { "width": 3000, "height": 3413 }
11
      }
12
    ]
13
  }
14
}

Save These UUIDs

  • mockup_uuid: c315f78f-d2c7-4541-b240-a9372842de94
  • smart_object_uuid: 128394ee-6758-4f2f-aa36-e2b19b152bd9
You'll need these for rendering.

Step 4: Render Your First Mockup

Now the magic happens! Call the render endpoint with your design image:

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

In under 1 second, you'll get back your rendered mockup:

Render Response
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
}

🎉 Congratulations!

You've just rendered your first mockup with SudoMock! Open the export_path URL to see your result.

<1s render time1 credit used

Next Steps

Explore Render Options

Learn about fit modes, color overlays, and image adjustments.

Automate with n8n

Connect SudoMock to your automation workflows.

Print on Demand Guide

Scale your POD business with automated mockups.

PSD Preparation

Optimize your Photoshop files for best results.

Try the Playground

Want to test renders visually before writing code? Use the Playground to experiment with your mockups in real-time.