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

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

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

Что такое Pexafy?

Pexafy — это поисковая система изображений на основе ИИ, которая объединяет миллионы бесплатных и платных изображений из множества источников — Unsplash, Pexels, Pixabay, Wikimedia Commons и других — в единый API. Вместо того чтобы интегрировать десятки сервисов изображений, вы делаете один запрос к Pexafy и получаете лучшие результаты из всех источников, ранжированные по семантической релевантности ИИ.

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

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

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

Да! Наш бесплатный план предоставляет 1K API-запросов в месяц — без привязки банковской карты. Вы можете выполнять текстовый поиск и получать доступ ко всем бесплатным источникам изображений. Нужно больше запросов, платные изображения или поиск по изображению? Ознакомьтесь с нашей страницей Цены для планов Pro и Business.

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

Pexafy в настоящее время агрегирует изображения из Unsplash, Pexels, Pixabay, Wikimedia Commons и Openverse. Мы постоянно добавляем новые источники. Вы можете фильтровать результаты по источнику с помощью параметра 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 многоязычные поисковые запросы?

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

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

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

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

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

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

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

Мы предоставляем 14-дневную гарантию возврата денег на все платные планы. Если вы не удовлетворены в течение первых 14 дней после подписки, свяжитесь с нами по адресу [email protected], и мы оформим полный возврат средств без лишних вопросов.

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

Мы принимаем все основные кредитные и дебетовые карты (Visa, Mastercard, American Express), а также Apple Pay и Google Pay — всё обрабатывается безопасно через Stripe. Мы не храним никакую платёжную информацию на наших серверах.

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

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

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

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

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

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

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

Все цены указаны в долларах США. Stripe, наш платёжный провайдер, автоматически конвертирует сумму в вашу местную валюту при оформлении заказа. Ваш банк может взимать небольшую комиссию за конвертацию валюты в зависимости от типа карты и страны.

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

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

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

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

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

Чем премиум-изображения отличаются от обычных?

Премиум-изображения отображаются в результатах поиска, однако для загрузки в полном разрешении может потребоваться подписка или покупка на сайте-источнике. API возвращает превью/миниатюры для всех изображений. В планах Free и Pro URL источника в ответе укажет, где можно получить полное изображение.

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

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

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

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

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

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

Перейдите в 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 Блог