Render product mockups with Flask

This page turns one Flask route into a mockup renderer. You upload a PSD template once, and every request to that route places new artwork on it and answers with the URL of the finished image.

Hand this to your coding agent before it writes a SudoMock call.

Open in Cursor

Prerequisites

Before you start, you will need:

An API key, beginning with sm_
A PSD with at least one smart object, prepared for rendering
Python 3.9 or newer, and Flask 2.2 or newer with room for one more route

Guide

Install

Add the official Python SDK to your project.

pip install sudomock

uv add sudomock

poetry add sudomock

Put the key in the environment your app runs in.

export SUDOMOCK_API_KEY="sm_your_api_key"

Upload the mockup once

A template is parsed once and rendered forever, so this belongs in your setup rather than in the route. Run it as a one-off script and keep the two UUIDs it prints.

upload.py

import os

from sudomock import SudoMock

client = SudoMock(api_key=os.environ["SUDOMOCK_API_KEY"])

mockup = client.psd.upload(
    url="https://example.com/tshirt-mockup.psd",
    name="T-shirt front",
)

print("mockup:", mockup.uuid)
for layer in mockup.smart_objects:
    print("smart object:", layer.name, layer.uuid)

The mockup UUID and the smart object UUID are the two values the route needs. Put them in the environment beside the key.

Render from a route

The route takes an artwork URL, places it on the stored template and answers with the rendered image. fit decides how the artwork meets the smart object area, and each value gives a different result.

app.py

import os

from flask import Flask, jsonify, request
from sudomock import SudoMock, SudoMockError

client = SudoMock(api_key=os.environ["SUDOMOCK_API_KEY"])

MOCKUP_UUID = os.environ["SUDOMOCK_MOCKUP_UUID"]
SMART_OBJECT_UUID = os.environ["SUDOMOCK_SMART_OBJECT_UUID"]

app = Flask(__name__)


@app.post("/render")
def render_mockup():
    artwork_url = request.get_json()["artwork_url"]

    render = client.renders.create(
        mockup_uuid=MOCKUP_UUID,
        smart_objects=[
            {
                "uuid": SMART_OBJECT_UUID,
                "asset": {"url": artwork_url, "fit": "crop"},
            }
        ],
        export_options={
            "image_format": "webp",
            "image_size": 1920,
        },
    )

    return jsonify({"url": render.url})


@app.errorhandler(SudoMockError)
def handle_render_failure(error):
    body = {
        "error": error.error_code or "render_failed",
        "message": error.message,
    }
    return jsonify(body), error.status_code or 502


if __name__ == "__main__":
    app.run()

One error handler covers every rejection the API answers with, because each one reaches your code as a SudoMockError carrying the status and the error code behind it.

Run it

Start the app and post an artwork URL to the route.

flask --app app run

curl -X POST "http://127.0.0.1:5000/render" \
  -H "Content-Type: application/json" \
  -d '{"artwork_url": "https://example.com/artwork.png"}'

{
  "url": "https://cdn.sudomock.com/renders/8f2c1d90/render.webp"
}

render.url is the first rendered file. A mockup that fills several smart objects returns one entry per object on render.print_files.

Get started

Learn

Resources

Render product mockups with Flask

Prerequisites

Guide

Next steps

Errors

Webhooks

​Prerequisites

​Guide

​Next steps

Errors

Webhooks

Prerequisites

Guide

Next steps