SudoMock API Documentation
Mockup automation infrastructure for automated product rendering. Upload your PSD templates, render unlimited variations programmatically.
Start Free - No Credit Card Required
Quick Start
Get your first render in 60 seconds. Here's everything you need:
Upload a PSD Template
Upload your Photoshop mockup file with smart object layers. We'll extract all editable layers automatically.
See Upload APIRender Your First Mockup
Call the render endpoint with your design URL. Get back a production-ready image via CDN.
1curl -X POST "https://api.sudomock.com/api/v1/renders" \2 -H "Content-Type: application/json" \3 -H "x-api-key: sm_your_api_key" \4 -d '{5 "mockup_uuid": "your-mockup-uuid",6 "smart_objects": [{7 "uuid": "smart-object-uuid",8 "asset": {9 "url": "https://your-domain.com/design.png"10 }11 }]12 }'
Response:
1{2 "success": true,3 "data": {4 "print_files": [{5 "export_path": "https://cdn.sudomock.com/renders/abc123.webp",6 "smart_object_uuid": "smart-object-uuid"7 }]8 }9}
Try it Live
API Endpoints
Three surfaces cover everything: render from your own server, embed the editor on your storefront, or ship that editor white-labeled as your own.
Upload PSD
Upload a Photoshop template and get back its detected Smart Objects, text layers, editable outline groups, and preview.
Learn moreRender (PSD)
Replace Smart Object artwork, personalize text layers, or update group outlines. REST also supports text-only PSD renders.
Learn morePhoto to Mockup (start from a photo)
Turn a product photo into a reusable mockup automatically, review it, then render new artwork onto it. No PSD required.
Learn moreStudio (Embed Editor)
Embed a live, white-label customizer via iframe and receive each settled design's API parameters.
Learn moreNeed video, big batches, or push notifications? These cover async jobs, video, and webhooks:
Remove Background
Turn an image URL or base64 input into a transparent PNG cutout. Pricing starts at about $0.06 per image.
Learn moreRender Video
Turn a mockup into a short product video for ads, listings, and social. Always async: returns a job_id you track to completion.
Learn moreAsync Rendering & Jobs
Submit renders and uploads in the background with is_async, then poll the job by its job_id for the result.
Learn moreWebhooks
Receive a signed HTTPS request the moment a render, upload, or video job finishes. No polling loop required.
Learn moreOfficial REST SDKs
sudomock npm package (npmjs.com/package/sudomock) and the sudomock PyPI package (pypi.org/project/sudomock) cover renders, async submission, video, jobs, and webhooks. For AI assistants, the separate MCP server ships as @sudomock/mcp.Why SudoMock?
Fast Rendering
Built for high-volume automation workflows. CDN-hosted output for fast delivery.
Published Volume Plans
Start with 500 one-time credits, then choose a plan with clear monthly render, template, concurrency, and webhook limits.
Simple REST API
Two endpoints. Upload your PSD, render with your designs. That's it.
Automation Ready
Native support for n8n, Zapier, Make. Trigger renders from any workflow.
One template, every workflow.
Upload your own layered PSD once, then render production-ready variations from structured inputs.
Use the same render engine through the REST API, no-code workflows, native commerce integrations, or MCP.
Integrations
Connect SudoMock to your existing automation workflows:
n8n Automation
Official n8n node for visual workflow automation. Trigger renders from any n8n workflow.
Learn moreZapier
Connect SudoMock with 5,000+ apps. No code required.
Learn moreBuild with code
Step-by-step guides with working examples for Python, Node.js, Next.js, PHP, and Shopify.
Learn moreUse Cases
Print on Demand
Automate product mockup generation for POD platforms. Generate thousands of variations in minutes.
Learn moreEtsy & Shopify
Create professional product images for your online store at scale.
Learn moreStorefront customizer
Let customers personalize a product on your store with the embedded Studio editor, then add the result to cart. No render backend to build.
Learn moreMockups from a photo
Start from a product photo instead of a PSD. SudoMock prepares it once, then you can render any design onto it.
Learn moreAuthentication
All API requests require authentication via the x-api-key header. Generate your API key from the Dashboard.
1curl -X POST "https://api.sudomock.com/api/v1/renders" \2 -H "x-api-key: sm_your_api_key_here" \3 -H "Content-Type: application/json" \4 -d '{ ... }'
Keep Your API Key Secure
Parallel Limits
These limits determine how many simultaneous render or upload operations you can have in flight at once. Pay as you go carries the trial number until a card is verified and the balance is funded, and the funded number after that. The funded number is not a one-time unlock: it holds while a balance remains, and for 90 days after your last top-up once that balance is spent.
Need Help?
PSD Preparation Guide
Learn how to structure your Photoshop files for optimal rendering results.
Learn moreSmart Objects Guide
Understanding smart objects and how SudoMock processes them.
Learn moreRequest a Feature
Have an idea? Help shape SudoMock's future.
Submit requestStill have questions?
Our team is here to help you succeed.
Contact Support →Missing something? Request a feature or view our roadmap