Qamera AI
Wypróbuj za darmo

Dokumentacja API

Programowy dostęp do generowania treści Qamera AI przez publiczne REST API.

Qamera AI API pozwala zintegrować generowanie fotografii produktowej bezpośrednio z Twoimi aplikacjami i przepływami pracy. Możesz zarządzać produktami, uruchamiać generowanie treści i pobierać wyniki bez korzystania z interfejsu webowego.

Bazowy URL

Wszystkie zapytania API korzystają z następującego bazowego URL:

https://app.qamera.ai

Jeśli korzystasz z wdrożenia self-hosted, zastąp go własnym adresem URL.

Szybki start

1. Uzyskaj API key

Przejdź do Ustawienia → API Keys w swoim zespołowym workspace i wygeneruj nowy klucz. Twój klucz będzie wyglądał następująco:

mk_live_abc123.secretvalue

Skopiuj go natychmiast — sekretna część jest wyświetlana tylko raz.

2. Wykonaj pierwsze zapytanie

Pobierz katalog produktów:

curl -X GET https://app.qamera.ai/api/external/products \
  -H "X-Api-Key: mk_live_abc123.secretvalue"

Pomyślna odpowiedź zwraca tablicę JSON z Twoimi produktami.

Dostępne endpointy

API jest zorganizowane w następujące grupy zasobów:

  • Products — Lista i pobieranie produktów z katalogu.
  • Packshots — Generowanie czystych zdjęć produktowych na białym lub niestandardowym tle.
  • Photo Shoots — Tworzenie fotografii lifestylowej z generowanymi przez AI scenami i modelami.
  • Videos — Produkcja krótkich rolek wideo ze zdjęć produktów.
  • Styles — Lista i pobieranie gotowych presetów wizualnych.
  • Orders — Śledzenie zamówień generowania treści i ich statusów.
  • Jobs — Monitorowanie poszczególnych zadań generowania w ramach zamówienia.

Endpointy GET są bezpłatne i nie zużywają kredytów. Endpointy POST, które uruchamiają generowanie treści, zużywają kredyty zgodnie z planem cenowym.

Uwierzytelnianie

Wszystkie zapytania wymagają API key. Możesz go przekazać za pomocą nagłówka X-Api-Key lub Authorization: Bearer. Szczegóły dotyczące formatu klucza, scope i bezpieczeństwa znajdziesz na stronie Uwierzytelnianie.

Następne kroki

  • Uwierzytelnianie — Format klucza, scope i najlepsze praktyki bezpieczeństwa.
  • Rate Limiting — Limity zapytań i strategie ponawiania.
  • Kody błędów — Kody statusu HTTP i format odpowiedzi błędów.
  • Kredyty — Jak działa rezerwacja i zużycie kredytów.

Uwierzytelnianie

Format API key, opcje nagłówków, scope i praktyki bezpieczeństwa dla Qamera AI API.

Rate Limiting

Limity zapytań, obsługa odpowiedzi 429 i strategie ponawiania dla Qamera AI API.

Kody błędów

Kody statusu HTTP i format odpowiedzi błędów dla Qamera AI API.

Kredyty

Jak działa rezerwacja, zużycie i zwrot kredytów API przy generowaniu treści.

Produkty

Pobieranie przesłanych zdjęć produktów dla Twojego konta.

Packshoty

Lista, generowanie i zarządzanie zdjęciami packshotowymi produktów.

Sesje zdjęciowe

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

Modele

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

Scenerie

Lista i generowanie scenerii oraz teł do fotografii produktowej.

Wideo

Lista wideo, generowanie pojedynczych wideo ze zdjęć oraz tworzenie rolek z wielu zdjęć.

Presety

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

Przykłady

Kompletne przykłady integracji z użyciem curl, JavaScript i Python.

Dokumentacja API