Render a PSD without Photoshop

If you already own the PSD templates, you do not need Photoshop in the loop to produce images from them. Upload a template once and every later image is an HTTP request: no Photoshop licence, no Actions or scripts, no machine to keep running. This page is the whole job end to end. The Quickstart is the shorter version if you only want the two calls.

What stays in Photoshop and what leaves it

Photoshop keeps the work it is good at: building the template, placing the smart objects, and setting the transforms and effects. That happens once per product. Everything that repeats leaves. Filling a slot with a design, swapping a headline, changing a colour, exporting at print resolution: each of those is a field on a render request.

1. Upload the template once

const response = await fetch("https://api.sudomock.com/api/v1/psd/upload", {
  method: "POST",
  headers: {
    "x-api-key": "sm_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "psd_file_url": "https://your-storage.com/tshirt-front.psd",
    "psd_name": "T-shirt front"
  }),
});

const data = await response.json();
console.log(data);

<?php

$payload = <<<'JSON'
{
  "psd_file_url": "https://your-storage.com/tshirt-front.psd",
  "psd_name": "T-shirt front"
}
JSON;

$ch = curl_init("https://api.sudomock.com/api/v1/psd/upload");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: sm_your_api_key",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

payload = {
    "psd_file_url": "https://your-storage.com/tshirt-front.psd",
    "psd_name": "T-shirt front"
}

response = requests.post(
    "https://api.sudomock.com/api/v1/psd/upload",
    headers={"x-api-key": "sm_your_api_key"},
    json=payload,
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/psd/upload")
request = Net::HTTP::Post.new(uri)
request["x-api-key"] = "sm_your_api_key"
request["Content-Type"] = "application/json"

request.body = <<~JSON
  {
    "psd_file_url": "https://your-storage.com/tshirt-front.psd",
    "psd_name": "T-shirt front"
  }
JSON

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{
  "psd_file_url": "https://your-storage.com/tshirt-front.psd",
  "psd_name": "T-shirt front"
}`)

	req, err := http.NewRequest("POST", "https://api.sudomock.com/api/v1/psd/upload", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String payload = """
{
  "psd_file_url": "https://your-storage.com/tshirt-front.psd",
  "psd_name": "T-shirt front"
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/psd/upload"))
    .header("x-api-key", "sm_your_api_key")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var payload = """
{
  "psd_file_url": "https://your-storage.com/tshirt-front.psd",
  "psd_name": "T-shirt front"
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.sudomock.com/api/v1/psd/upload");
request.Headers.Add("x-api-key", "sm_your_api_key");
request.Content = new StringContent(payload, Encoding.UTF8, "application/json");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

curl -X POST "https://api.sudomock.com/api/v1/psd/upload" \
  -H "x-api-key: sm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "psd_file_url": "https://your-storage.com/tshirt-front.psd",
    "psd_name": "T-shirt front"
  }'

Keep data.uuid as the template id, and each data.smart_objects[].uuid as a slot id. Store them next to your product record. Nothing in your render loop touches this endpoint again. Upload a PSD covers the response in full.

2. Render as many images as you need

const response = await fetch("https://api.sudomock.com/api/v1/renders", {
  method: "POST",
  headers: {
    "x-api-key": "sm_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "mockup_uuid": "YOUR_MOCKUP_UUID",
    "smart_objects": [
      {
        "uuid": "YOUR_SMART_OBJECT_UUID",
        "asset": {
          "url": "https://your-cdn.com/design-001.png",
          "fit": "crop"
        }
      }
    ],
    "export_options": {
      "image_format": "webp",
      "image_size": 1920
    }
  }),
});

const data = await response.json();
console.log(data);

<?php

$payload = <<<'JSON'
{
  "mockup_uuid": "YOUR_MOCKUP_UUID",
  "smart_objects": [
    {
      "uuid": "YOUR_SMART_OBJECT_UUID",
      "asset": {
        "url": "https://your-cdn.com/design-001.png",
        "fit": "crop"
      }
    }
  ],
  "export_options": {
    "image_format": "webp",
    "image_size": 1920
  }
}
JSON;

$ch = curl_init("https://api.sudomock.com/api/v1/renders");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: sm_your_api_key",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

payload = {
    "mockup_uuid": "YOUR_MOCKUP_UUID",
    "smart_objects": [
        {
            "uuid": "YOUR_SMART_OBJECT_UUID",
            "asset": {
                "url": "https://your-cdn.com/design-001.png",
                "fit": "crop"
            }
        }
    ],
    "export_options": {
        "image_format": "webp",
        "image_size": 1920
    }
}

response = requests.post(
    "https://api.sudomock.com/api/v1/renders",
    headers={"x-api-key": "sm_your_api_key"},
    json=payload,
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/renders")
request = Net::HTTP::Post.new(uri)
request["x-api-key"] = "sm_your_api_key"
request["Content-Type"] = "application/json"

request.body = <<~JSON
  {
    "mockup_uuid": "YOUR_MOCKUP_UUID",
    "smart_objects": [
      {
        "uuid": "YOUR_SMART_OBJECT_UUID",
        "asset": {
          "url": "https://your-cdn.com/design-001.png",
          "fit": "crop"
        }
      }
    ],
    "export_options": {
      "image_format": "webp",
      "image_size": 1920
    }
  }
JSON

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{
  "mockup_uuid": "YOUR_MOCKUP_UUID",
  "smart_objects": [
    {
      "uuid": "YOUR_SMART_OBJECT_UUID",
      "asset": {
        "url": "https://your-cdn.com/design-001.png",
        "fit": "crop"
      }
    }
  ],
  "export_options": {
    "image_format": "webp",
    "image_size": 1920
  }
}`)

	req, err := http.NewRequest("POST", "https://api.sudomock.com/api/v1/renders", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String payload = """
{
  "mockup_uuid": "YOUR_MOCKUP_UUID",
  "smart_objects": [
    {
      "uuid": "YOUR_SMART_OBJECT_UUID",
      "asset": {
        "url": "https://your-cdn.com/design-001.png",
        "fit": "crop"
      }
    }
  ],
  "export_options": {
    "image_format": "webp",
    "image_size": 1920
  }
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/renders"))
    .header("x-api-key", "sm_your_api_key")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var payload = """
{
  "mockup_uuid": "YOUR_MOCKUP_UUID",
  "smart_objects": [
    {
      "uuid": "YOUR_SMART_OBJECT_UUID",
      "asset": {
        "url": "https://your-cdn.com/design-001.png",
        "fit": "crop"
      }
    }
  ],
  "export_options": {
    "image_format": "webp",
    "image_size": 1920
  }
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.sudomock.com/api/v1/renders");
request.Headers.Add("x-api-key", "sm_your_api_key");
request.Content = new StringContent(payload, Encoding.UTF8, "application/json");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

curl -X POST "https://api.sudomock.com/api/v1/renders" \
  -H "x-api-key: sm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "mockup_uuid": "YOUR_MOCKUP_UUID",
    "smart_objects": [
      {
        "uuid": "YOUR_SMART_OBJECT_UUID",
        "asset": {
          "url": "https://your-cdn.com/design-001.png",
          "fit": "crop"
        }
      }
    ],
    "export_options": {
      "image_format": "webp",
      "image_size": 1920
    }
  }'

The finished image is at data.print_files[0].export_path.

3. Walk a catalogue

A design list plus one template is a catalogue of images. This is the shape most integrations settle on.

import os, requests

API = "https://api.sudomock.com/api/v1"
HEADERS = {"x-api-key": os.environ["SUDOMOCK_API_KEY"]}

MOCKUP_UUID = "c315f78f-d2c7-4541-b240-a9372842de94"
SLOT_UUID = "128394ee-6758-4f2f-aa36-e2b19b152bd9"

designs = [
    "https://your-cdn.com/design-001.png",
    "https://your-cdn.com/design-002.png",
    "https://your-cdn.com/design-003.png",
]

for url in designs:
    res = requests.post(
        f"{API}/renders",
        headers=HEADERS,
        json={
            "mockup_uuid": MOCKUP_UUID,
            "smart_objects": [
                {
                    "uuid": SLOT_UUID,
                    "asset": {"url": url, "fit": "crop"},
                }
            ],
            "export_options": {
                "image_format": "webp",
                "image_size": 1920,
            },
        },
    )
    res.raise_for_status()
    print(res.json()["data"]["print_files"][0]["export_path"])

const API = "https://api.sudomock.com/api/v1";
const headers = {
  "x-api-key": process.env.SUDOMOCK_API_KEY,
  "Content-Type": "application/json"
};

async function render(designUrl) {
  const res = await fetch(`${API}/renders`, {
    method: "POST",
    headers,
    body: JSON.stringify({
      mockup_uuid: MOCKUP_UUID,
      smart_objects: [
        {
          uuid: SLOT_UUID,
          asset: { url: designUrl, fit: "crop" }
        }
      ],
      export_options: { image_format: "webp", image_size: 1920 }
    })
  });

  const { data } = await res.json();
  return data.print_files[0].export_path;
}

const urls = await Promise.all(designs.map(render));

Requests run in parallel up to your plan’s concurrency, and anything beyond it queues rather than failing. For long runs, send is_async: true and collect the results from a webhook instead of holding connections open.

Change more than the artwork

The same template also carries text and colour, so one file covers variants that would otherwise be separate PSDs.

{
  "mockup_uuid": "YOUR_MOCKUP_UUID",
  "smart_objects": [
    {
      "uuid": "YOUR_SMART_OBJECT_UUID",
      "asset": {
        "url": "https://your-cdn.com/design-001.png",
        "fit": "crop"
      },
      "color": { "hex": "#1F3A93", "blending_mode": "multiply" }
    }
  ],
  "text_layers": [
    { "uuid": "YOUR_TEXT_LAYER_UUID", "text": "Jane Smith" }
  ],
  "export_options": {
    "image_format": "png",
    "image_size": 3600,
    "dpi": 300
  }
}

Text layers covers wording, font, size and colour, and Artwork placement covers fit, offset and rotation.

Print-ready output

dpi stamps a print resolution tag into the file metadata; it does not change the pixels. Size the pixels yourself with image_size = print_inches x dpi. A 12 inch print at 300 DPI is image_size: 3600. Choose png or jpg for the widest print-tool support.

What carries over from the file

Smart object transforms, warps, perspective, layer masks, clipping masks, blend modes, opacity, and Drop Shadow, Stroke and Blend If all render from the template as authored. The row-by-row list, including what to send instead where a feature is not rendered today, is on PSD compatibility.

Preparing a PSD

Build the template so every slot is addressable.

Text layers

Personalise wording on the same template.

Overview

PSD mockups

Photo mockups

Text and fonts

Integrations

Reference

Advanced

Changes

Render a PSD without Photoshop

What stays in Photoshop and what leaves it

1. Upload the template once

2. Render as many images as you need

3. Walk a catalogue

Change more than the artwork

Print-ready output

What carries over from the file

Preparing a PSD

Text layers

​What stays in Photoshop and what leaves it

​1. Upload the template once

​2. Render as many images as you need

​3. Walk a catalogue

​Change more than the artwork

​Print-ready output

​What carries over from the file

Preparing a PSD

Text layers

What stays in Photoshop and what leaves it

1. Upload the template once

2. Render as many images as you need

3. Walk a catalogue

Change more than the artwork

Print-ready output

What carries over from the file