Sesje zdjęciowe

Lista wygenerowanych zdjęć z sesji i rejestrowanie nowych zadań sesji zdjęciowych.

GET /api/external/image-picker

Zwraca listę wygenerowanych zdjęć z sesji zdjęciowych.

Nagłówki

Nagłówek	Wymagany	Opis
X-Api-Key	Tak	Twój API key w formacie `mk_live_xxx.secret`

Parametry zapytania

Pole	Typ	Wymagany	Opis
statusFilter	string	Nie	Filtruj po statusie: `all` (domyślnie) lub `approved`
productId	string	Nie	Filtruj zdjęcia po konkretnym ID produktu

Odpowiedź

{
  "images": [
    {
      "id": "img_abc123",
      "name": "Fashion Shoot - White T-Shirt",
      "thumbnail": "https://cdn.example.com/images/thumb_abc123.jpg",
      "status": "DONE",
      "voting": "APPROVED",
      "createdAt": "2026-03-20T16:00:00.000Z"
    }
  ],
  "count": 1
}

Odpowiedzi z błędem

Kod	Znaczenie
401	Brakujący lub nieprawidłowy API key
500	Wewnętrzny błąd serwera

Uwagi

Ten endpoint nie zużywa kredytów.
Użyj productId, aby zawęzić wyniki do konkretnego produktu.

Przykład

curl -X GET "https://app.qamera.ai/api/external/image-picker?statusFilter=approved&productId=prod_abc123" \
  -H "X-Api-Key: mk_live_abc123.secret456"

POST /api/external/image-picker/register-ideas

Rejestruje nowe zadanie generowania sesji zdjęciowej. Kredyty są rezerwowane natychmiast i zużywane po zakończeniu przetwarzania.

Nagłówki

Nagłówek	Wymagany	Opis
X-Api-Key	Tak	Twój API key w formacie `mk_live_xxx.secret`
Content-Type	Tak	`application/json`

Treść zapytania

Pole	Typ	Wymagany	Opis
config.product.id	string	Tak	ID produktu do sfotografowania
config.model.id	string	Nie	ID modelu AI (manekina) do użycia
config.scenery.id	string	Nie	ID scenerii/tła
config.preset.id	string	Nie	ID presetu do zastosowania
config.industry	string	Nie	Kategoria branży (np. `fashion`)
config.suggestions	string	Nie	Wskazówki kreatywne w formie tekstu
count	number	Nie	Liczba zdjęć do wygenerowania (domyślnie: 10, maks.: 20)

Odpowiedź

{
  "createdRecordIds": ["img_001", "img_002", "img_003"],
  "batchId": "batch_abc123",
  "orderId": "order_xyz789",
  "reservationId": "res_def456",
  "creditsReserved": 30
}

Odpowiedzi z błędem

Kod	Znaczenie
400	Nieprawidłowa treść zapytania lub brak wymaganych pól
401	Brakujący lub nieprawidłowy API key
402	Niewystarczające kredyty
500	Wewnętrzny błąd serwera

Uwagi

Przetwarzanie jest asynchroniczne. Zadanie jest publikowane w kolejce komunikatów i przetwarzane przez worker.
Śledź status wygenerowanych zdjęć za pomocą endpointu GET.
Kredyty są rezerwowane przy tworzeniu, zużywane po pomyślnym przetworzeniu i zwracane w przypadku niepowodzenia.
Każde zapytanie generuje correlationId do śledzenia w logach.
Maksymalnie 20 zdjęć na zapytanie.

Przykład

curl -X POST "https://app.qamera.ai/api/external/image-picker/register-ideas" \
  -H "X-Api-Key: mk_live_abc123.secret456" \
  -H "Content-Type: application/json" \
  -d '{
    "config": {
      "product": { "id": "prod_abc123" },
      "model": { "id": "model_xyz" },
      "scenery": { "id": "scenery_001" },
      "industry": "fashion",
      "suggestions": "Outdoor urban setting, natural lighting"
    },
    "count": 10
  }'