API Overview

The Shotprose API allows you to generate device mockups programmatically. All API access requires an active Pro subscription.

Base URL

https://shotprose.com/api/v1

Endpoints

Method	Endpoint	Description
POST	/mockup	Generate a device mockup
GET	/health	Check API health status

Authentication

All requests to /api/v1/mockup require a Bearer token in the Authorization header:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

See Authentication for details on obtaining and using API keys.

Response Format

Successful responses return JSON with success: true:

{
  "success": true,
  "image": {
    "data": "base64-encoded-image...",
    "mimeType": "image/png",
    "width": 1920,
    "height": 1080
  },
  "duration": 2340
}

Error responses return JSON with success: false:

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Human-readable error message"
  }
}

Rate Limits

API requests are limited to 60 requests per minute per user. See Rate Limits for details.

Next Steps

• Quick Start - Generate your first mockup
• Generate Mockup - Full endpoint reference
• Error Codes - Handle errors gracefully