# Paqshot API

> Generate product photos with the ProseCaptain Paqshot API: access, token and how it works.

The ProseCaptain Paqshot API turns one product photo into studio packshots, lifestyle photos, mockups and infographics. It produces the same images as the Paqshot app.

Base URL: `https://api-design.prosecaptain.com`

## Access and token

API access is available to business customers. A token belongs to one Paqshot account and is issued on request, together with limits tailored to your volume. [Contact us](mailto:kontakt@prosecaptain.com).

Pass the token in the header:

```text
Authorization: Bearer YOUR_TOKEN
```

Use the token on your server only.

## How it works

- One call, one image. You send the product photo as base64 and get the finished image in the response.
- Generation usually takes 20–60 seconds. Set your client timeout to at least 180 seconds.
- Every image is also saved in your Paqshot library and available at a permanent URL.
- Each successful call uses one image from your plan. Failed calls are not counted.

## Quick start

```bash
curl -X POST https://api-design.prosecaptain.com/api/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --max-time 180 \
  -d '{
    "productImage": { "data": "<base64>", "mimeType": "image/jpeg" },
    "sceneType": "product_packshot",
    "packshotStyle": "studio",
    "aspectRatio": "1:1"
  }'
```

All parameters are described in [Generate an image](/en/docs/paqshot-generate/).