Modele

Lista i generowanie modeli AI (manekinów) do fotografii produktowej.

GET /api/external/models

Zwraca listę dostępnych modeli AI (manekinów).

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`

Odpowiedź

{
  "models": [
    {
      "id": "model_abc123",
      "name": "Female Model - Casual",
      "thumbnail": "https://cdn.example.com/models/thumb_abc123.jpg",
      "status": "DONE",
      "voting": "APPROVED",
      "createdAt": "2026-03-20T14: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.

Przykład

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

POST /api/external/models/register-ideas

Rejestruje nowe zadanie generowania modelu AI. 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
preferences	string	Tak	Tekstowy opis pożądanego wyglądu i cech modelu
count	number	Nie	Liczba modeli do wygenerowania (domyślnie: 10, maks.: 20)

Odpowiedź

{
  "createdRecordIds": ["model_001", "model_002", "model_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 pola preferences
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 modeli 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 modeli na zapytanie.

Przykład

curl -X POST "https://app.qamera.ai/api/external/models/register-ideas" \
  -H "X-Api-Key: mk_live_abc123.secret456" \
  -H "Content-Type: application/json" \
  -d '{
    "preferences": "Young female model, athletic build, natural makeup, suitable for sportswear photography",
    "count": 5
  }'