Часто задаваемые вопросы

Всё, что нужно знать о Pexafy. Не нашли ответ? Свяжитесь с нами.

Начало работы

Что такое Pexafy?

Pexafy — это поисковая система изображений на базе ИИ, которая агрегирует миллионы бесплатных изображений из 9 источников — Unsplash, Pexels, Pixabay, Kaboompics, Burst и других — в единый API. Один запрос Pexafy = один семантический поиск по всем 9 источникам. При использовании собственных API провайдеров тот же поиск требует от 3 до 5 вызовов, плюс логика объединения и нормализация JSON: код, который вы пишете, поддерживаете и за который платите.

Как получить ключ API?

Зарегистрируйте бесплатную учётную запись на pexafy.com/auth/register/, затем перейдите в Панель управления → Ключи API → Создать ключ. Первый ключ создаётся мгновенно, без привязки банковской карты. Бесплатный план включает 5K API-запросов в месяц.

Нужно ли одобрение моей заявки?

Нет. Ваш ключ работает с первого же запроса: без проверки заявки, без периода ожидания и без обязательного вызова отслеживания загрузок при каждом скачивании. Unsplash ограничивает неодобренные приложения до 50 запросов/час до завершения проверки; Pexels допускает 200/час.

Является ли Pexafy бесплатным?

Да! Тариф Free даёт 5K API-запросов в месяц — без банковской карты — и, как и любой другой тариф, ищет по всем источникам, которые индексирует Pexafy. Нужно больше запросов? Платные тарифы, от Starter до Enterprise, повышают лимиты: смотрите нашу страницу с ценами.

Какие источники изображений использует Pexafy?

В настоящее время Pexafy агрегирует 9 источников, крупнейшими из которых являются Unsplash, Pexels, Pixabay, Kaboompics, Burst. Мы постоянно добавляем новые. Вы можете фильтровать результаты по источнику, используя параметр source в API.

Чем Pexafy отличается от Google Images?

Pexafy — это API для разработчиков, а не потребительская поисковая система. Мы агрегируем только источники с открытой лицензией и Creative Commons, поэтому каждый результат безопасен для использования в вашем продукте. Наша модель ИИ понимает семантический смысл — ищите «уютная осенняя атмосфера» и получайте релевантные изображения, а не просто совпадения по ключевым словам. Кроме того, вы получаете структурированные JSON-ответы, пагинацию, фильтры и аналитику использования — всё через единый REST API.

Предоставляете ли вы SDK или клиентские библиотеки?

В настоящее время мы предоставляем REST API с исчерпывающей документацией. Официальные SDK для Python, JavaScript/TypeScript и PHP включены в наш план развития. Тем временем API очень прост в интеграции — достаточно одного HTTPS-запроса с заголовком API-ключа. Ознакомьтесь с нашей документацией, где есть примеры кода на нескольких языках.

API и технические вопросы

Каков лимит запросов к API?

Лимиты запросов зависят от вашего плана: Бесплатный — 20 запросов/мин, Pro — 60 запросов/мин, Business — 300 запросов/мин. При превышении лимита вы получите ответ 429 Too Many Requests с заголовком Retry-After, указывающим, когда можно повторить запрос.

В каком формате возвращает данные API?

Все ответы представлены в формате JSON со стандартной оболочкой: {success, data, meta, pagination, error}. Каждый объект фотографии включает: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors и relevance score.

Как работает пагинация?

Pexafy использует пагинацию на основе курсора. Каждый ответ содержит значение pagination.next_cursor. Передайте его в качестве параметра cursor в следующем запросе, чтобы получить следующую страницу. Когда next_cursor равен null, вы достигли конца.

Можно ли фильтровать результаты поиска?

Да! Вы можете фильтровать по: color_name (red, blue, green…), color_hex (например, #FF5733 с опциональным color_tolerance), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…) и score_threshold (минимальная релевантность 0.0–1.0). Комбинируйте фильтры для точных результатов.

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

Добавьте ваш API-ключ в заголовок запроса: X-Api-Key: pxfy_your_key_here. Либо используйте аутентификацию через Bearer-токен: Authorization: Bearer <jwt_token>. Никогда не передавайте ваш API-ключ в клиентском коде.

Каково максимальное количество результатов на один запрос?

Вы можете запрашивать до 80 результатов на страницу с помощью параметра per_page (по умолчанию — 20). Для больших наборов результатов используйте пагинацию на основе курсора для получения последующих страниц. Общее количество страниц, по которым можно переходить, не ограничено.

Поддерживает ли Pexafy многоязычные поисковые запросы?

Да! Наша модель обучена на многоязычных данных, поэтому вы можете выполнять поиск на английском, французском, испанском, немецком, португальском и многих других языках. Семантическое понимание лучше всего работает на английском, однако большинство распространённых запросов на других языках также дают точные результаты. Для максимальной точности рекомендуем использовать английский язык.

Тарифы и оплата

Могу ли я изменить тарифный план?

Да, меняйте тариф в любой момент в разделе Панель управления → Оплата. Изменение вступает в силу сразу, а Creem, наш реселлер, пересчитывает его пропорционально: при переходе на более дорогой тариф списывается разница в цене за остаток текущего периода, при переходе на более дешёвый — она возвращается.

Что происходит при превышении квоты?

API-запросы блокируются после достижения ежемесячного лимита — вы получите ответ 429 с информативным сообщением об ошибке. Чтобы продолжить использование API, перейдите на более высокий план через Панель управления → Оплата.

Вы предоставляете возврат средств?

Мы предоставляем 14-дневную гарантию возврата денег на все платные планы. Если вы не удовлетворены в течение первых 14 дней после подписки, свяжитесь с нами по адресу [email protected], и мы оформим полный возврат средств без лишних вопросов. Возврат на исходный способ оплаты выполняет Creem, наш реселлер. Подробности — в нашей политике возврата: pexafy.com/legal/refund/

Какие способы оплаты вы принимаете?

Платежи обрабатывает Creem — наш реселлер и Merchant of Record. Оплатить можно кредитной или дебетовой картой либо другими способами, которые Creem предлагает при оформлении заказа в вашей стране. Мы никогда не видим и не храним данные вашей карты.

Есть ли долгосрочный договор?

Никаких договоров и обязательств. Все планы оплачиваются помесячно (или со скидкой ежегодно, если вы выберете этот вариант). Отмените подписку в любое время через Панель управления → Оплата одним кликом. Доступ сохраняется до окончания текущего расчётного периода.

Есть ли скидка при оплате за год?

Да! При годовой оплате вы экономите до 18%: план Pro — $199/год ($17/месяц) вместо $19/месяц. План Business — $2599/год ($217/месяц) вместо $249/месяц. Перейдите на годовую оплату через Панель управления → Оплата.

Вы предлагаете корпоративные планы по индивидуальным условиям?

Да! Если ваши потребности выходят за рамки плана Enterprise — более высокие лимиты запросов, выделенная инфраструктура, индивидуальное SLA или локальное развёртывание — свяжитесь с нами по адресу [email protected] с описанием ваших требований. Мы подготовим индивидуальный план для вашей организации.

Какие валюты поддерживаются для оплаты?

Все цены указаны в долларах США, и Creem, наш реселлер, списывает их в долларах США. В зависимости от страны при оплате могут добавляться налоги, например НДС. Если ваша карта в другой валюте, банк сконвертирует сумму и может взять небольшую комиссию за конвертацию.

Изображения и лицензирование

Pexafy владеет изображениями?

Нет. Pexafy — это поисковая система: мы индексируем и ищем изображения, размещённые на сторонних платформах (Unsplash, Pexels, Pixabay и др.). Мы не храним, не размещаем и не распространяем сами файлы изображений. Все изображения остаются собственностью соответствующих фотографов и платформ.

Можно ли использовать изображения в коммерческих целях?

Это зависит от лицензии источника. Unsplash, Pexels и Pixabay предоставляют бесплатные лицензии для коммерческого использования большинства своих изображений, и небольшие источники, которые мы индексируем, следуют той же модели. Всегда проверяйте поле лицензии в ответе API и убеждайтесь в наличии прав на исходном URL перед коммерческим использованием изображения.

Плачу ли я за изображения?

Нет. Pexafy не продаёт изображения. Каждый результат берётся из библиотеки свободных изображений — Unsplash, Pexels, Pixabay, Kaboompics, Burst и других — и ведёт обратно на неё, на условиях лицензии этой библиотеки. Тариф оплачивает только поисковый сервис: API-запросы, лимиты частоты, API-ключи и поддержку. Перед использованием проверьте лицензию каждого изображения в источнике.

Могу ли я загружать изображения через API?

Pexafy возвращает URL изображений, размещённых на их исходных платформах — мы не передаём файлы изображений напрямую через API. Вы можете скачать версию в полном разрешении по URL источника, указанному в ответе. Всегда соблюдайте условия использования исходной платформы.

Как часто обновляется индекс изображений?

Наш конвейер индексирования запускается ежедневно для всех основных источников. Новые изображения, загруженные на Unsplash, Pexels, Pixabay и другие платформы, как правило, становятся доступными для поиска через Pexafy в течение 24–48 часов. В настоящее время наш индекс содержит 9M+ изображений и продолжает пополняться каждый день.

Аккаунт и безопасность

Как удалить аккаунт?

Перейдите в Dashboard → Settings → Danger Zone → Delete Account. Удаление аккаунта необратимо: все ваши API-ключи, история использования и персональные данные будут уничтожены. Вы также можете отправить запрос на удаление по адресу [email protected] в соответствии с GDPR / правом на забвение.

Защищены ли мои данные?

Да. Мы используем HTTPS везде, bcrypt для хеширования паролей и храним сессии в Redis с краткосрочными JWT-токенами. Мы не продаём и не передаём ваши данные третьим лицам. API-ключи хешируются перед сохранением. Подробную информацию о практиках работы с данными читайте в нашей Политике конфиденциальности.

Могу ли я иметь несколько API-ключей?

Да, в зависимости от вашего плана: Free (1 ключ), Pro (5 ключа), Business (∞ ключей). Несколько ключей позволяют разграничить использование по приложению, среде (dev/staging/prod) или участнику команды, а также отозвать отдельные ключи, не затрагивая остальные.

Что делать, если мой API-ключ скомпрометирован?

Немедленно отзовите скомпрометированный ключ в разделе Dashboard → API Keys и создайте новый. Отзыв вступает в силу мгновенно — любые запросы с использованием старого ключа будут отклонены с ошибкой 401. Никогда не сохраняйте API-ключи в системе контроля версий; используйте переменные окружения.

Какова ваша гарантия доступности?

Мы стремимся обеспечить доступность API на уровне 99,9% времени безотказной работы. Клиенты тарифного плана Business получают соглашение об уровне обслуживания (SLA) с гарантиями доступности. Вы можете отслеживать состояние сервиса в режиме реального времени и просматривать историю на странице «Статус», доступной через нижнюю часть этого сайта.

Соответствует ли Pexafy требованиям GDPR?

Да. Мы собираем только минимальный объём данных, необходимый для работы сервиса (email, хешированный пароль, журналы использования). Мы не продаём данные третьим лицам. Вы можете запросить полный экспорт или удаление данных в любое время в разделе Dashboard → Settings или по электронной почте [email protected]. Подробнее см. нашу Политику конфиденциальности.

Остались вопросы?

Не нашли то, что искали? Наша команда будет рада помочь.

Связаться с поддержкой Читать документацию API

О Pexafy Блог