Dokumentacja referencyjna · Uwierzytelnianie

Uwierzytelnianie w Photta API jeden klucz, jeden nagłówek

W jednym zdaniu

Przekazuj klucz jako `Authorization: Bearer photta_live_xxx` w każdym wywołaniu Photta API. Klucze są generowane w panelu, nie mają zakresów per endpoint i współdzielą jedno saldo credits.

Pobierz klucz API Przeczytaj dokumentację

Uwierzytelnianie: Klucz Bearer
Limity: 600 requests/min
Przetwarzanie: asynchroniczne, polling

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

Czego oczekuje API

Uwierzytelnianie w pigułce

Nagłówek: Authorization: Bearer photta_live_xxx
Prefiks klucza: photta_live_
Base URL: https://api.photta.app/api/v1
Gdzie tworzone są klucze: https://ai.photta.app
Zakres (scope): Jeden klucz obsługuje każdy endpoint i jedno saldo credits

Sprawdź klucz jednym wywołaniem

Endpoint konta jest darmowy, więc stanowi bezpieczny sposób na sprawdzenie, czy klucz działa.

curl https://api.photta.app/api/v1/account \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Zarządzanie kluczami

Rotuj klucz w razie podejrzeń
Dokumentacja mówi wprost: natychmiast zrotuj klucz, jeśli podejrzewasz jego wyciek. Najpierw wygeneruj nowy klucz, wdróż go, a dopiero potem unieważnij stary.
Trzymaj klucz na serwerze
Klucz, który trafi do przeglądarki, trafia do każdego, kto otworzy stronę. Wywołuj API z backendu i przekazuj wyniki do klienta.
401 oznacza problem z kluczem, a nie z żądaniem
Brakujący, nieprawidłowy lub wygasły klucz zwraca `authentication_error`. Zanim zaczniesz szukać gdzie indziej, sprawdź nagłówek pod kątem literówek i zbędnych spacji.
Jedno saldo za każdym kluczem
Klucze nie mają zakresów per funkcja. Wiele kluczy dla różnych środowisk nadal korzysta z tego samego salda credits, które zwraca GET `/api/v1/account`.

Pytania dotyczące uwierzytelniania

Jak uwierzytelnić żądanie?

Przesyłaj klucz w nagłówku Authorization jako bearer token przy każdym wywołaniu. Nie ma osobnego kroku logowania ani wymiany tokenów.

Gdzie wygenerować klucz?

W panelu Photta. W tym samym miejscu wygenerujesz nowy klucz, do czego odsyła dokumentacja w przypadku błędu 401.

Czy mogę wywoływać API z poziomu przeglądarki?

Nie z użyciem Twojego klucza. Wszystko, co trafia do przeglądarki, jest widoczne dla użytkowników, dlatego umieść wywołanie na własnym serwerze i przekazuj wynik.

Co zrobić w przypadku wycieku klucza?

Natychmiast go zrotuj — wygeneruj nowy klucz, wdróż go, a następnie usuń stary. Wykorzystane credits nie podlegają zwrotowi, więc najpierw zrotuj klucz, a dopiero potem wyjaśniaj sprawę.

Endpointy i materiały referencyjne

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.

Załóż konto i pobierz klucz API API

Klucz Bearer
600 requests/min
asynchroniczne, polling