Shopify Product Images at Scale: API Approach

Upload template

curl -X POST "https://api.sudomock.com/api/v1/psd/upload" \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "psd_file_url": "https://storage.com/tshirt-front.psd",
    "psd_name": "T-Shirt Front View"
  }'

const response = await fetch('https://api.sudomock.com/api/v1/psd/upload', {
  method: 'POST',
  headers: {
    'X-API-KEY': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "psd_file_url": "https://storage.com/tshirt-front.psd",
    "psd_name": "T-Shirt Front View"
  }),
});

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

import requests

response = requests.post(
    "https://api.sudomock.com/api/v1/psd/upload",
    headers={
        "X-API-KEY": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "psd_file_url": "https://storage.com/tshirt-front.psd",
        "psd_name": "T-Shirt Front View",
    },
)

print(response.json())

package main

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

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

	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", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

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

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

<?php

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

$ch = curl_init('https://api.sudomock.com/api/v1/psd/upload');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-KEY: YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

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

echo $response;

// Express.js endpoint for Shopify webhook
app.post('/api/shopify/product-create', async (req, res) => {
  const product = req.body;

  // Get design URL from product metafield or description
  const designUrl = product.metafields?.design_url;

  if (!designUrl) {
    return res.status(200).send('No design URL');
  }

  // Generate mockups for all templates
  const templates = ['tshirt_front', 'tshirt_back', 'lifestyle'];
  const mockupUrls = [];

  for (const template of templates) {
    const response = await fetch('https://api.sudomock.com/api/v1/renders', {
      method: 'POST',
      headers: {
        'X-API-KEY': process.env.SUDOMOCK_API_KEY,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        mockup_uuid: TEMPLATE_IDS[template],
        smart_objects: [{
          uuid: SO_IDS[template],
          asset: { url: designUrl }
        }],
        export_options: {
          image_format: 'webp',
          image_size: 1024,
          quality: 90
        }
      })
    });

    const result = await response.json();
    mockupUrls.push(result.data.print_files[0].export_path);
  }

  // Add images to Shopify product
  await addImagesToProduct(product.id, mockupUrls);

  res.status(200).send('Mockups generated');
});

async function shopifyGraphQL(query, variables) {
  const response = await fetch(
    'https://' + process.env.SHOPIFY_SHOP + '.myshopify.com/admin/api/2026-10/graphql.json',
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-Shopify-Access-Token': process.env.SHOPIFY_ACCESS_TOKEN
      },
      body: JSON.stringify({ query, variables })
    }
  );
  return response.json();
}

async function addImagesToProduct(productId, imageUrls) {
  return shopifyGraphQL(
    'mutation AddMedia($product: ProductUpdateInput!, $media: [CreateMediaInput!]) {' +
      ' productUpdate(product: $product, media: $media) {' +
      ' product { id } userErrors { field message } } }',
    {
      product: { id: 'gid://shopify/Product/' + productId },
      media: imageUrls.map((url) => ({ originalSource: url, mediaContentType: 'IMAGE' }))
    }
  );
}

const { data } = await shopifyGraphQL(
  '{ products(first: 250) { nodes { legacyResourceId title media(first: 1) { nodes { id } } } } }'
);

for (const product of data.products.nodes) {
  const designUrl = getDesignUrl(product);

  if (product.media.nodes.length === 0 && designUrl) {
    const mockups = await generateMockups(designUrl);
    await addImagesToProduct(product.legacyResourceId, mockups);

    console.log(`Generated images for: ${product.title}`);

    // Respect rate limits
    await sleep(500);
  }
}