Dokumentacja PrzymierzTo

PrzymierzTo pokazuje klientce, jak wygląda w ubraniu z Twojego sklepu. Klientka wgrywa raz zdjęcie sylwetki, a przy produkcie klika „Przymierz na sobie”. Po kilku sekundach dostaje obraz wygenerowany przez AI.

Trzy sposoby integracji

Sposób	Dla kogo	Ile pracy
REST API	Platformy z własnym zespołem i interfejsem	Własne ekrany, pełna kontrola
Widżet JS	Sklepy internetowe	Jeden skrypt i znacznik przy produkcie
Flutter SDK	Aplikacje mobilne	Jeden przycisk, gotowe ekrany

Wszystkie trzy korzystają z tego samego API i tych samych zasad bezpieczeństwa.

Jak to działa

1. Twój backend przekazuje nam butiki i produkty (nazwa, opis, zdjęcia). Z każdego produktu robimy kartę: rodzaj ubrania, długość, krój, ważne detale.
2. Twój backend wydaje klientce krótki token (POST /v1/session-tokens). Klucz API nigdy nie trafia do przeglądarki ani aplikacji.
3. Aplikacja klientki wgrywa zdjęcie sylwetki ze zgodami i zleca przymiarkę.
4. My generujemy obraz, sprawdzamy go filtrem treści, oznaczamy jako AI i wysyłamy wynik: na żywo do aplikacji (WebSocket) i do Twojego serwera (webhook).

Adres API

Wszystkie ścieżki zaczynają się od /v1. Pełna, interaktywna referencja: OpenAPI.

Notatka

Domena produkcyjna nie jest jeszcze wybrana. W przykładach używamy https://api.przymierzto.example. Twój adres API dostaniesz razem z kluczem.