Getting started

MeetMockup generates photorealistic mockups with displacement mapping. This guide walks through the fastest path to your first API request.

1. Create an account

Sign up at meetmockup.com/signup to get access to your account area and API credentials.

2. Make your first request

curl -X POST https://api.meetmockup.com/api/v1/mockups/generate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "design_url": "https://meetmockup.com/samples/sample-design-1.png",
    "template_id": "white_male_front",
    "placement": {
      "scale": 0.4,
      "offset_x": 0,
      "offset_y": -50
    }
  }'

3. Handle the response

The API returns a base64-encoded PNG in mockup_url alongside metadata including generation time and output dimensions.

{
  "success": true,
  "mockup_url": "data:image/png;base64,iVBORw0KGgo...",
  "metadata": {
    "generation_time_ms": 1450,
    "template_used": "white_male_front",
    "dimensions": {
      "width": 2400,
      "height": 3200
    }
  }
}

4. Explore the catalog

Browse templates visually on the templates page or integrate the listing endpoints directly from your backend.