REST API · v2.0 · LIVE

T-shirt mockup API
5-minute mockup, real garment

Generate on-model · flat-lay · lifestyle mockups from a single design file. One API call → 12 garment variants · 4 angles · 4K resolution. Hong Kong-hosted · 142ms median response · no monthly fee.

📖 API Docs ⚡ Get Free API Key
  • 5 minutes mockup turnaround
  • 142ms median response
  • 4K PNG / WebP output
  • 12 SKUs · 4 angles each
  • Free tier · 50 mockups/month
📡 REST API

One POST → 48 mockups in 5 minutes

Bring your design file. We handle the rest. Returns 12 garment variants × 4 angles = 48 production-ready mockups.

POST /v2/mockup/generate

{
  "design_url": "https://your-cdn.com/logo.png",
  "sku": "TEE-CLASSIC-WHITE",
  "angles": ["front", "back", "left", "detail"],
  "models": ["on-model", "flat-lay"],
  "resolution": "4k",
  "callback_url": "https://your-app.com/webhook"
}

Response

{
  "job_id": "mkp_8f2a9c1e4b",
  "status": "processing",
  "estimated_seconds": 300,
  "mockups": [],
  "webhook_at": "https://your-app.com/webhook"
}

// Webhook fires when ready (avg 287s)
{
  "job_id": "mkp_8f2a9c1e4b",
  "status": "completed",
  "mockups": [
    { "sku": "TEE", "angle": "front", "url": "..." },
    ...48 results
  ]
}
⚡ Why PERSON.TEES

Built for ecommerce & POD dropship

🎨

Real garments · not placeholders

Photoshoot-grade mockups of real T-shirts, Polos, Hoodies. No generic 3D body templates. Customer-ready.

⚡

5-minute turnaround

Average job completion 287 seconds. Webhook fires when ready. No polling required.

🌏

Hong Kong-hosted

Low latency for Asia-Pacific region · GDPR-friendly · data never leaves our Hong Kong data center.

🔌

Webhook + REST

Standard REST endpoint + webhook callback. SDKs for Node.js, Python, PHP, cURL.

🎯

Brand color support

Pantone / HEX / RGB color matching. Reorder same color across SKUs.

💸

Free tier · 50 mockups/month

No monthly fee. Pay only for what you generate. Volume pricing from 200+ mockups.

🎯 Use cases

Who uses the PERSON.TEES mockup API

🛍️ Ecommerce · Shopify / WooCommerce

Custom product stores

Customer uploads design → instant mockup preview → add to cart → automated production.

  • Shopify app integration (coming Q1)
  • WooCommerce plugin (beta)
  • Wix + Squarespace via Zapier
🚀 Dropship · POD platforms

Print-on-demand resellers

KOLs, freelancers, brand-side operators. Generate mockups for any niche product, sell before producing.

  • 1-piece POD, no MOQ
  • 8-country dropship
  • Webhook → auto-fulfill
💸 Pricing

Pay only for what you generate

Free

$0/month

  • 50 mockups/month
  • 4K resolution
  • Webhook callback
  • Email support

Pay-as-you-go

$0.40/mockup

  • Volume discount at 200+
  • $0.30 per mockup at 1k+
  • $0.20 per mockup at 10k+
  • Priority queue

Enterprise

Custom

  • Dedicated mockup queue
  • SLA: 1-hour turnaround
  • Custom garment SKU
  • Slack support

⚠️ Pricing estimates pending Danny sign-off · Contact for actual pricing

FAQ · t-shirt mockup API

Common questions

How fast is the t-shirt mockup API?
5-minute mockup for standard SKU (12 garment variants × 4 angles = 48 mockups). Average completion time 287 seconds. Express tier available for rush jobs (1-hour turnaround) at premium pricing.
What mockup styles are supported?
On-model (real person wearing the garment), flat-lay (product-only photo), lifestyle (in-context scene). Garments: Tee, Polo, Hoodie, Cap, Tote, Mug, Water Bottle, School Uniform, Apron, Long Sleeve, Jacket, Sport Tee.
Do I need a Printful or Printify account?
No. PERSON.TEES mockup API is independent. Bring your own fulfillment, or use our B2B POD fulfillment (14-day turnaround, 8-country direct). Mockup-only API access is free.
What format does the API return?
4K PNG by default. Optional WebP for smaller file size. CDN-hosted URLs valid for 30 days. Original files also available for download.
How does brand color matching work?
Send Pantone / HEX / RGB in the API request. Mockups render with matched color. ΔE ≤ 2 tolerance against your brand reference. Reorder same color across SKUs — color profile stored in your account.
Where is the API hosted?
Hong Kong data center. Low latency for Asia-Pacific (avg 142ms from HK/SG/JP/KR). GDPR-friendly · data residency in HK. Cloudflare CDN front layer for global edge.
WhatsApp sales