Справочник · Аутентификация

Аутентификация в Photta API один ключ, один заголовок

В двух словах

Передавайте ключ в заголовке `Authorization: Bearer photta_live_xxx` при каждом вызове Photta API. Ключи создаются в панели управления, не разграничиваются по эндпоинтам и используют общий баланс credits.

Получить API-ключ Документация

Аутентификация: Ключ Bearer
Лимиты: 600 запросов/мин
Обработка: async, polling

Все показатели на этой странице взяты из документации API Photta · проверено 2026-09-10

Ожидаемый формат запроса

Аутентификация кратко

Заголовок: Authorization: Bearer photta_live_xxx
Префикс ключа: photta_live_
Базовый URL: https://api.photta.app/api/v1
Где создаются ключи: https://ai.photta.app
Область видимости: Один ключ открывает доступ ко всем эндпоинтам и единому балансу credits

Проверка ключа одним запросом

Эндпоинт аккаунта бесплатен, поэтому это безопасный способ проверить работоспособность ключа.

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"]

Работа с ключами

Ротация при малейшем подозрении
В документации четко сказано: немедленно отзовите ключ при подозрении на компрометацию. Сначала создайте замену, разверните ее и только потом удалите старый ключ.
Храните ключ только на сервере
Ключ, попавший в браузер, становится доступен каждому, кто откроет страницу. Вызывайте API из бэкенда и передавайте клиенту готовые результаты.
401 указывает на ключ, а не на тело запроса
Отсутствующий, недействительный или истекший ключ возвращает `authentication_error`. Прежде чем искать причину в другом месте, проверьте заголовок на опечатки и лишние пробелы.
Единый баланс для всех ключей
Ключи не разделяются по возможностям API. Несколько ключей для разных окружений расходуют один и тот же баланс credits, который возвращает GET `/api/v1/account`.

Вопросы об аутентификации

Как аутентифицировать запрос?

Передавайте ключ в заголовке Authorization в виде Bearer-токена при каждом вызове. Отдельного шага логина или обмена токенов нет.

Где создать ключ?

В панели управления Photta. Там же выпускаются ключи на замену — именно туда направляет документация при получении 401.

Можно ли вызывать API из браузера?

Не с вашим ключом. Все, что отправляется в браузер, доступно пользователям, поэтому вызывайте API через собственный сервер и пересылайте результат.

Что делать при утечке ключа?

Немедленно смените его: сгенерируйте новый ключ, задеплойте его и затем удалите старый. Потраченные credits вернуть нельзя, поэтому сначала ротация, а разбирательства — потом.

Эндпоинты и справочные материалы

Все показатели на этой странице взяты из документации API Photta · проверено 2026-09-10

Протестируйте API за пять минут

Сгенерируйте API-ключ Photta, вставьте пример cURL выше, и вы получите первое изображение на модели быстрее, чем сварится кофе.

Создать аккаунт и получить API-ключ API

Ключ Bearer
600 запросов/мин
async, polling