Replace a Smart Object in a PSD With Code: One Request per Design

To replace a Smart Object in a PSD with code, upload your mockup PSD once and send one request for each design. The request takes the Smart Object you name and the artwork you point at, and returns the finished image as a URL. Renders match Photoshop’s own output, and you never open Photoshop. SudoMock is a mockup generator and rendering API with a free library of 6,800+ ready-made mockups across 104 product types. It renders a ready-made mockup, your own PSD template, or your own product photo with your artwork and returns the finished image.

Upload the template once

const response = await fetch("https://api.sudomock.com/api/v1/psd/upload", {
  method: "POST",
  headers: {
    "x-api-key": "$SUDOMOCK_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "psd_file_url": "https://example.com/tshirt-mockup.psd"
  }),
});

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

<?php

$payload = <<<'JSON'
{
  "psd_file_url": "https://example.com/tshirt-mockup.psd"
}
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: $SUDOMOCK_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://example.com/tshirt-mockup.psd'}

response = requests.post(
    "https://api.sudomock.com/api/v1/psd/upload",
    headers={"x-api-key": "$SUDOMOCK_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"] = "$SUDOMOCK_API_KEY"
request["Content-Type"] = "application/json"

request.body = <<~JSON
  {
    "psd_file_url": "https://example.com/tshirt-mockup.psd"
  }
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://example.com/tshirt-mockup.psd"
}`)

	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", "$SUDOMOCK_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://example.com/tshirt-mockup.psd"
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/psd/upload"))
    .header("x-api-key", "$SUDOMOCK_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://example.com/tshirt-mockup.psd"
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.sudomock.com/api/v1/psd/upload");
request.Headers.Add("x-api-key", "$SUDOMOCK_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: $SUDOMOCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "psd_file_url": "https://example.com/tshirt-mockup.psd"
  }'

Keep data.uuid, and from data.smart_objects the uuid of the Smart Object that takes the artwork. Each entry carries the layer name from your PSD.

One request per design

const response = await fetch("https://api.sudomock.com/api/v1/renders", {
  method: "POST",
  headers: {
    "x-api-key": "$SUDOMOCK_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "mockup_uuid": "MOCKUP_UUID",
    "smart_objects": [
      {
        "uuid": "SMART_OBJECT_UUID",
        "asset": {
          "url": "https://example.com/design-001.png"
        }
      }
    ],
    "export_options": {
      "image_format": "jpg"
    }
  }),
});

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

<?php

$payload = <<<'JSON'
{
  "mockup_uuid": "MOCKUP_UUID",
  "smart_objects": [
    {
      "uuid": "SMART_OBJECT_UUID",
      "asset": {
        "url": "https://example.com/design-001.png"
      }
    }
  ],
  "export_options": {
    "image_format": "jpg"
  }
}
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: $SUDOMOCK_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': 'MOCKUP_UUID',
 'smart_objects': [{'uuid': 'SMART_OBJECT_UUID',
                    'asset': {'url': 'https://example.com/design-001.png'}}],
 'export_options': {'image_format': 'jpg'}}

response = requests.post(
    "https://api.sudomock.com/api/v1/renders",
    headers={"x-api-key": "$SUDOMOCK_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"] = "$SUDOMOCK_API_KEY"
request["Content-Type"] = "application/json"

request.body = <<~JSON
  {
    "mockup_uuid": "MOCKUP_UUID",
    "smart_objects": [
      {
        "uuid": "SMART_OBJECT_UUID",
        "asset": {
          "url": "https://example.com/design-001.png"
        }
      }
    ],
    "export_options": {
      "image_format": "jpg"
    }
  }
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": "MOCKUP_UUID",
  "smart_objects": [
    {
      "uuid": "SMART_OBJECT_UUID",
      "asset": {
        "url": "https://example.com/design-001.png"
      }
    }
  ],
  "export_options": {
    "image_format": "jpg"
  }
}`)

	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", "$SUDOMOCK_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": "MOCKUP_UUID",
  "smart_objects": [
    {
      "uuid": "SMART_OBJECT_UUID",
      "asset": {
        "url": "https://example.com/design-001.png"
      }
    }
  ],
  "export_options": {
    "image_format": "jpg"
  }
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/renders"))
    .header("x-api-key", "$SUDOMOCK_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": "MOCKUP_UUID",
  "smart_objects": [
    {
      "uuid": "SMART_OBJECT_UUID",
      "asset": {
        "url": "https://example.com/design-001.png"
      }
    }
  ],
  "export_options": {
    "image_format": "jpg"
  }
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.sudomock.com/api/v1/renders");
request.Headers.Add("x-api-key", "$SUDOMOCK_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: $SUDOMOCK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mockup_uuid": "MOCKUP_UUID",
    "smart_objects": [
      {
        "uuid": "SMART_OBJECT_UUID",
        "asset": {
          "url": "https://example.com/design-001.png"
        }
      }
    ],
    "export_options": {
      "image_format": "jpg"
    }
  }'

The finished image is at data.print_files[0].export_path. Output is PNG, JPG or WebP. The average SudoMock render finishes in under a second; we measure render time in milliseconds.

A batch of 100, and every week after that

A Photoshop script is enough for a one-time batch on your own computer. When the same work comes back every week, the two requests above run on a server instead: 100 designs are 100 requests, plans render 3, 10 or 25 of them at the same time, and the same request runs as one step in n8n or Make when you do not write code. A new design, order or listing then produces its mockups with nobody opening a file.

What it costs

Plans start at $25/month. Subscriptions from $0.002 per render. Signup includes 500 credits, no credit card required.

Next steps

The two requests above with every field: Quickstart
What renders from your file as authored: What PSD features are supported
No code: n8n and Make
No PSD yet: ready apparel templates

Overview

PSD mockups

Photo mockups

Text and fonts

Integrations

Reference

Advanced

Choosing an approach

Troubleshooting

Working with the API

Account and billing

Changes