Presety

Lista, tworzenie i aktualizacja presetów fotograficznych z wytycznymi i zdjęciami referencyjnymi.

GET /api/external/presets

Zwraca listę dostępnych presetów. Presety są współdzielone globalnie i definiują wytyczne fotograficzne dla zadań generowania.

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
maxRecords	number	Nie	Maksymalna liczba presetów do zwrócenia (domyślnie: 20)

Odpowiedź

{
  "presets": [
    {
      "id": "preset_abc123",
      "name": "E-commerce Standard",
      "guidelines": "Clean white background, centered product, soft shadows",
      "quantityGuidelines": "3-5 angles per product",
      "qualityGuidelines": "High resolution, consistent lighting, no reflections",
      "createdAt": "2026-03-15T10: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.
Zwraca zarówno presety systemowe, jak i utworzone przez użytkownika.

Przykład

curl -X GET "https://app.qamera.ai/api/external/presets?maxRecords=50" \
  -H "X-Api-Key: mk_live_abc123.secret456"

POST /api/external/presets

Tworzy nowy preset użytkownika z wytycznymi i opcjonalnymi zdjęciami referencyjnymi.

Nagłówki

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

Treść zapytania

Pole	Typ	Wymagany	Opis
name	string	Tak	Nazwa presetu
quantityGuidelines	string	Tak	Wytyczne dotyczące liczby i różnorodności generowanych zdjęć
qualityGuidelines	string	Tak	Wytyczne dotyczące jakości zdjęć, oświetlenia i stylu
cover	file	Nie	Zdjęcie okładkowe presetu
gallery	file[]	Nie	Galeria zdjęć referencyjnych

Odpowiedź

{
  "success": true,
  "presetId": "preset_new123"
}

Odpowiedzi z błędem

Kod	Znaczenie
400	Brak wymaganych pól (name, quantityGuidelines lub qualityGuidelines)
401	Brakujący lub nieprawidłowy API key
500	Wewnętrzny błąd serwera

Uwagi

Utworzony preset ma typ USER, status published i widoczność private.
Preset jest powiązany z kontem przypisanym do API key.
Ten endpoint nie zużywa kredytów.

Przykład

curl -X POST "https://app.qamera.ai/api/external/presets" \
  -H "X-Api-Key: mk_live_abc123.secret456" \
  -F "name=My Custom Preset" \
  -F "quantityGuidelines=Generate 5 variations per product" \
  -F "qualityGuidelines=Bright studio lighting, minimal shadows, 4K resolution" \
  -F "cover=@/path/to/cover.jpg" \
  -F "gallery=@/path/to/ref1.jpg" \
  -F "gallery=@/path/to/ref2.jpg"

PUT /api/external/presets

Aktualizuje istniejący preset użytkownika. Można zmienić wytyczne, zastąpić zdjęcie okładkowe i zarządzać zdjęciami w galerii.

Nagłówki

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

Treść zapytania

Pole	Typ	Wymagany	Opis
presetId	string	Tak	ID presetu do aktualizacji
name	string	Nie	Zaktualizowana nazwa presetu
quantityGuidelines	string	Nie	Zaktualizowane wytyczne ilościowe
qualityGuidelines	string	Nie	Zaktualizowane wytyczne jakościowe
cover	file	Nie	Nowe zdjęcie okładkowe (zastępuje istniejące)
gallery	file[]	Nie	Nowe zdjęcia galerii do dodania
existingGalleryIds	string	Nie	Tablica JSON z ID istniejących zdjęć galerii do zachowania (np. `["id1","id2"]`)
removeCover	string	Nie	Ustaw na `"true"`, aby usunąć bieżące zdjęcie okładkowe

Odpowiedź

{
  "success": true
}

Odpowiedzi z błędem

Kod	Znaczenie
400	Brak presetId lub nieprawidłowe zapytanie
401	Brakujący lub nieprawidłowy API key
403	Nie jesteś właścicielem tego presetu
500	Wewnętrzny błąd serwera

Uwagi

Możesz aktualizować wyłącznie presety należące do Twojego konta. Próba aktualizacji presetu innego użytkownika zwraca błąd 403.
Galeria obsługuje maksymalnie 6 zdjęć.
Użyj existingGalleryIds, aby określić, które bieżące zdjęcia galerii zachować. Zdjęcia nie wymienione na liście zostaną usunięte.
Ustaw removeCover na "true", aby usunąć zdjęcie okładkowe bez przesyłania nowego.
Ten endpoint nie zużywa kredytów.

Przykład

curl -X PUT "https://app.qamera.ai/api/external/presets" \
  -H "X-Api-Key: mk_live_abc123.secret456" \
  -F "presetId=preset_abc123" \
  -F "name=Updated Preset Name" \
  -F "qualityGuidelines=Soft natural lighting, warm tones, lifestyle feel" \
  -F "gallery=@/path/to/new_ref.jpg" \
  -F 'existingGalleryIds=["gallery_img_001","gallery_img_002"]' \
  -F "removeCover=false"