Photta API

Photta API Wirtualny try-on, ghost mannequin i fotografia produktowa przez REST

W jednym zdaniu

Photta API to oparty na credits REST API: wyślij zdjęcie produktu metodą POST na endpoint danej funkcji, odpytuj jego status endpoint co kilka sekund i pobierz gotowy obraz. 8 funkcji, jeden klucz, jedno saldo credits.

Pobierz klucz API Przeczytaj dokumentację

Możliwości: 8 możliwości
Rate limit: 600 requests/min
Uwierzytelnianie: Klucz Bearer
Wzorzec: asynchroniczne, polling

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono 2026-09-10

RESPONSE=$(curl -s -X POST https://api.photta.app/api/v1/tryon/apparel \
  -H "Authorization: Bearer $PHOTTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "product_type": "top",
  "product_images": [
    "https://cdn.yourstore.com/products/shirt-front.jpg"
  ],
  "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
  "product_category": "t_shirt",
  "mannequin_id": "mnk_f3a9b1",
  "pose_id": "pose_c2d4e5",
  "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
  "lock_background": true,
  "resolution": "2K",
  "aspect_ratio": "3:4",
  "body_size": "M",
  "expression": "neutral",
  "user_instruction": "Keep the collar pattern crisp and centered."
}')
ID=$(echo "$RESPONSE" | jq -r '.data.id')

const res = await fetch("https://api.photta.app/api/v1/tryon/apparel", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "product_type": "top",
    "product_images": [
      "https://cdn.yourstore.com/products/shirt-front.jpg"
    ],
    "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
    "product_category": "t_shirt",
    "mannequin_id": "mnk_f3a9b1",
    "pose_id": "pose_c2d4e5",
    "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
    "lock_background": true,
    "resolution": "2K",
    "aspect_ratio": "3:4",
    "body_size": "M",
    "expression": "neutral",
    "user_instruction": "Keep the collar pattern crisp and centered."
  }),
});
const { data } = await res.json(); // data.id, data.status

import os, requests

res = requests.post(
    "https://api.photta.app/api/v1/tryon/apparel",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
    json={
      "product_type": "top",
      "product_images": [
        "https://cdn.yourstore.com/products/shirt-front.jpg"
      ],
      "product_back_image": "https://cdn.yourstore.com/products/shirt-back.jpg",
      "product_category": "t_shirt",
      "mannequin_id": "mnk_f3a9b1",
      "pose_id": "pose_c2d4e5",
      "background": "https://cdn.yourstore.com/backgrounds/studio-loft.jpg",
      "lock_background": True,
      "resolution": "2K",
      "aspect_ratio": "3:4",
      "body_size": "M",
      "expression": "neutral",
      "user_instruction": "Keep the collar pattern crisp and centered."
    },
)
data = res.json()["data"]  # data["id"], data["status"]

Możliwości

Każdy endpoint według funkcji

Metoda, ścieżka, credits i typowy czas — bezpośrednio z dokumentacji API. Dane na tej stronie są weryfikowane z dokumentacją według daty podanej na dole.

Języki

Brak SDK na ten moment — i wcale go nie potrzebujesz.

Trzy gotowe do wklejenia przewodniki, w 100% zgodne z aktualnymi zaleceniami dokumentacji Photta.

Quickstart

Od rejestracji do pierwszego obrazu w 5 minut.

Każda funkcja działa według tego samego schematu: autoryzacja, wysłanie żądania, polling. Wystarczy opanować to raz.

Krok 1: Zarejestruj się na ai.photta.app i wygeneruj produkcyjny klucz API w panelu Developers.
Krok 2: Wyślij zadanie metodą POST z kluczem w nagłówku Authorization — API natychmiast zwróci ID generowania.
Krok 3: Odpytuj (poll) ten sam endpoint co 3 sekundy, aż status zmieni się na completed, a następnie pobierz URL z wynikiem.

Szybki start

Pytania

O co programiści pytają przed rejestracją

Czym jest Photta API?

API Photta to oparty na credits interfejs REST, który generuje profesjonalną fotografię modową ze zdjęć Twoich produktów. To ten sam pipeline, który zasila aplikacje konsumenckie Photta — wirtualny try-on odzieży, try-on biżuterii oraz ekstrakcję typu ghost mannequin, udostępnione w postaci 8 funkcji, na bazie których deweloperzy mogą budować własne narzędzia.

Jak uzyskać klucz API?

Zarejestruj się na ai.photta.app, otwórz sekcję Developers w panelu i kliknij Generate API key. Twój produkcyjny klucz zaczyna się od `photta_live_`, po którym następuje 32 znaków szesnastkowych. Trzymaj go w zmiennej środowiskowej — nigdy nie commituj go do repozytorium kodu ani nie przesyłaj do przeglądarki.

Czy dostępny jest darmowy pakiet?

Nowe konta otrzymują testowe credits, które można wykorzystać na dowolną funkcję. Gdy będziesz gotowy do wdrożenia na produkcję, przejdź na plan z wyższym miesięcznym saldem credits. Rate limit jest taki sam w każdym planie: 600 żądań na minutę na klucz API. Brak minimalnych limitów per wywołanie.

Jak szybkie jest generowanie?

Zadania try-on i ghost mannequin zazwyczaj trwają od 1.5 do 4 minut; zdjęcia okularów, detali oraz grafiki procesowe od 20 do 60 sekund; generowanie manekina od 30 do 60 sekund. Każdy endpoint generowania jest asynchroniczny: POST od razu zwraca ID generowania, a status sprawdza się przez polling co 3 do 5 sekund do momentu ukończenia zadania. Nie ma potrzeby utrzymywania długich połączeń HTTP.

Czy istnieje oficjalne SDK Photta?

Jeszcze nie. Wspieraną ścieżką integracji jest bezpośredni REST przez cURL, natywny fetch w Node lub bibliotekę requests w Python — wszystkie trzy są w pełni udokumentowane w tym serwisie dla każdej funkcji.

Dokumentacja referencyjna

Części dokumentacji, do których będziesz wracać wielokrotnie.

Każda liczba na tej stronie pochodzi z dokumentacji API Photta · sprawdzono 2026-09-10

Wypróbuj API w 5 minut

Wygeneruj klucz Photta API, wklej powyższy snippet cURL, a otrzymasz swoje pierwsze zdjęcie na modelu, zanim zaparzy się kawa.

Pobierz klucz API Szybki start

8 możliwości
600 requests/min
Klucz Bearer
asynchroniczne, polling