# API Paqshot

> Generowanie zdjęć produktów przez API ProseCaptain Paqshot: dostęp, token i model działania.

API ProseCaptain Paqshot generuje z jednego zdjęcia produktu packshoty studyjne, zdjęcia lifestyle, mockupy i infografiki. Te same obrazy powstają w aplikacji Paqshot.

Bazowy adres: `https://api-design.prosecaptain.com`

## Dostęp i token

Dostęp do API dostają klienci biznesowi. Token należy do jednego konta Paqshot i wydajemy go na prośbę, razem z limitami dopasowanymi do Twojego wolumenu. [Napisz do nas](mailto:kontakt@prosecaptain.com).

Token przekazujesz w nagłówku:

```text
Authorization: Bearer TWOJ_TOKEN
```

Używaj tokenu tylko po stronie serwera.

## Jak to działa

- Jedno wywołanie, jeden obraz. Wysyłasz zdjęcie produktu jako base64 i dostajesz gotowy obraz w odpowiedzi.
- Generowanie trwa zwykle 20–60 sekund. Ustaw limit czasu klienta na co najmniej 180 sekund.
- Każdy obraz jest też zapisany w Twojej bibliotece Paqshot i dostępny pod stałym adresem.
- Jedno udane wywołanie zużywa jeden obraz z planu. Nieudane wywołania nie są liczone.

## Szybki start

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

Wszystkie parametry opisuje strona [Generowanie obrazu](/dokumentacja/paqshot-generowanie/).