자주 묻는 질문

Pexafy는 AI 기반 이미지 검색 엔진으로, Unsplash, Pexels, Pixabay, Wikimedia Commons 등 다양한 소스에서 수백만 개의 무료 및 프리미엄 이미지를 단일 API로 통합합니다. 수십 개의 이미지 서비스를 개별적으로 연동할 필요 없이, Pexafy에 요청 한 번으로 모든 소스에서 AI 시맨틱 관련성 기준으로 순위가 매겨진 최적의 결과를 얻을 수 있습니다.

pexafy.com/auth/register/에서 무료 계정을 생성한 후, 대시보드 → API 키 → 키 생성으로 이동하세요. 첫 번째 키는 신용카드 없이 즉시 발급됩니다. 무료 플랜에는 월 1K회의 API 요청이 포함됩니다.

네! 무료 플랜은 신용카드 없이 월 1K회의 API 요청을 제공합니다. 텍스트 기반 검색과 모든 무료 이미지 소스에 접근할 수 있습니다. 더 많은 요청, 프리미엄 이미지, 또는 이미지-투-이미지 검색이 필요하신가요? Pro 및 Business 플랜은 요금제 페이지에서 확인하세요.

Pexafy는 현재 Unsplash, Pexels, Pixabay, Wikimedia Commons, Openverse의 이미지를 통합합니다. 소스는 지속적으로 추가되고 있습니다. API의 source 파라미터를 사용하여 소스별로 결과를 필터링할 수 있습니다.

Pexafy는 일반 소비자용 검색 엔진이 아닌 개발자 중심의 API입니다. 무료 사용 및 Creative Commons 소스만을 통합하므로 모든 결과를 제품에 안전하게 사용할 수 있습니다. AI 모델이 시맨틱 의미를 이해하기 때문에 '아늑한 가을 분위기'처럼 검색해도 단순 키워드 일치가 아닌 관련성 높은 이미지를 얻을 수 있습니다. 또한 구조화된 JSON 응답, 페이지네이션, 필터, 사용량 분석을 단일 REST API로 제공합니다.

현재는 상세한 문서가 포함된 REST API를 제공합니다. Python, JavaScript/TypeScript, PHP용 공식 SDK는 로드맵에 포함되어 있습니다. 그 전까지도 API는 간단하게 연동할 수 있으며, API 키 헤더가 포함된 단일 HTTPS 요청만으로 사용할 수 있습니다. 다양한 언어의 코드 예시는 문서에서 확인하세요.

속도 제한은 플랜에 따라 다릅니다: 무료 — 20회 요청/분, Pro — 60회 요청/분, Business — 300회 요청/분. 제한을 초과하면 재시도 가능 시점을 나타내는 Retry-After 헤더와 함께 429 Too Many Requests 응답을 받게 됩니다.

모든 응답은 표준 엔벨로프 형식의 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 키를 추가하세요: X-Api-Key: pxfy_your_key_here. 또는 Bearer 토큰 인증을 사용할 수 있습니다: Authorization: Bearer <jwt_token>. API 키를 클라이언트 측 코드에 노출하지 마세요.

per_page 파라미터를 사용하여 페이지당 최대 80개의 결과를 요청할 수 있습니다(기본값은 20개). 대용량 결과 집합의 경우 커서 기반 페이지네이션을 사용하여 다음 페이지를 가져오세요. 페이지네이션으로 탐색할 수 있는 총 페이지 수에는 제한이 없습니다.

네! 저희 모델은 다국어 데이터로 학습되었기 때문에 영어, 프랑스어, 스페인어, 독일어, 포르투갈어 등 다양한 언어로 검색할 수 있습니다. 의미론적 이해는 영어에서 가장 뛰어나지만, 다른 언어로 이루어진 대부분의 일반적인 쿼리도 정확한 결과를 제공합니다. 최대한의 정확도를 위해 영어 사용을 권장합니다.

네, 대시보드 → 결제에서 언제든지 업그레이드 또는 다운그레이드할 수 있습니다. 업그레이드는 일할 계산 방식으로 즉시 적용됩니다. 다운그레이드는 현재 결제 기간이 끝날 때 적용됩니다. 모든 처리는 Stripe를 통해 자동으로 이루어집니다.

월별 한도에 도달하면 API 요청이 차단되며 — 안내 오류 메시지와 함께 429 응답을 받게 됩니다. API를 계속 사용하려면 대시보드 → 결제에서 더 높은 요금제로 업그레이드하세요.

모든 유료 요금제에 대해 14일 환불 보장을 제공합니다. 구독 후 첫 14일 이내에 만족하지 못하신 경우 [email protected]으로 문의해 주시면 조건 없이 전액 환불해 드립니다.

Visa, Mastercard, American Express 등 주요 신용카드 및 체크카드와 Apple Pay, Google Pay를 지원하며 — 모두 Stripe를 통해 안전하게 처리됩니다. 저희 서버에는 결제 정보를 저장하지 않습니다.

계약도, 약정도 없습니다. 모든 요금제는 월별 구독 방식입니다(원하는 경우 연간 할인 요금제 선택 가능). 대시보드 → 결제에서 버튼 하나로 언제든지 취소할 수 있습니다. 현재 결제 기간이 끝날 때까지 서비스 이용이 유지됩니다.

네! 연간 결제 시 약 17%를 절약할 수 있습니다: Pro는 월 $29 대신 연 $290(월 $24)입니다. Business는 월 $299 대신 연 $2990(월 $249)입니다. 대시보드 → 결제에서 연간 요금제로 전환하세요.

네! Business 요금제를 초과하는 요구 사항 — 더 높은 속도 제한, 전용 인프라, 맞춤형 SLA 또는 온프레미스 배포 — 이 있으신 경우 요구 사항을 담아 [email protected]으로 문의해 주세요. 귀사에 맞는 맞춤형 요금제를 제안해 드리겠습니다.

모든 가격은 USD로 표시됩니다. 결제 처리사인 Stripe가 결제 시 자동으로 현지 통화로 환산해 드립니다. 카드 종류 및 국가에 따라 은행에서 소액의 외환 수수료가 부과될 수 있습니다.

아닙니다. Pexafy는 검색 엔진으로 — Unsplash, Pexels, Pixabay 등 서드파티 플랫폼에 호스팅된 이미지를 색인화하고 검색합니다. 실제 이미지 파일을 저장, 호스팅 또는 재배포하지 않습니다. 모든 이미지는 해당 사진작가 및 플랫폼의 소유입니다.

출처 라이선스에 따라 다릅니다. Unsplash, Pexels, Pixabay는 대부분의 이미지에 대해 무료 상업용 라이선스를 제공합니다. Wikimedia Commons와 Openverse는 다양한 Creative Commons 라이선스를 사용하며 — 상업적 이용을 허용하는 것도 있고 그렇지 않은 것도 있습니다. 이미지를 상업적으로 사용하기 전에 항상 API 응답의 라이선스 필드를 확인하고 출처 URL에서 직접 검증하시기 바랍니다.

프리미엄 이미지는 검색 결과에 표시되지만, 원본 소스에서 전체 해상도로 다운로드하려면 구독 또는 구매가 필요할 수 있습니다. API는 모든 이미지에 대해 미리 보기/썸네일을 반환합니다. Free 및 Pro 플랜에서는 응답의 소스 URL을 통해 전체 이미지에 접근할 수 있습니다.

Pexafy는 이미지가 호스팅된 원본 플랫폼의 URL을 반환하며, API를 통해 이미지 파일을 직접 제공하지 않습니다. 무료 이미지(Unsplash, Pexels, Pixabay)의 경우 응답에 포함된 소스 URL에서 전체 해상도 이미지를 다운로드할 수 있습니다. 항상 소스 플랫폼의 이용 약관을 준수하시기 바랍니다.

저희 인덱싱 파이프라인은 모든 주요 소스에 대해 매일 실행됩니다. Unsplash, Pexels, Pixabay 및 기타 플랫폼에 새로 업로드된 이미지는 일반적으로 24~48시간 이내에 Pexafy에서 검색할 수 있습니다. 현재 인덱스에는 500만 장 이상의 이미지가 포함되어 있으며 매일 증가하고 있습니다.

대시보드 → 설정 → 위험 구역 → 계정 삭제로 이동하세요. 계정 삭제는 영구적이며 모든 API 키, 사용 기록 및 개인 데이터가 제거됩니다. GDPR/삭제권에 따른 삭제 요청은 [email protected]으로 이메일을 보내셔도 됩니다.

네. 저희는 모든 통신에 HTTPS를 사용하고, 비밀번호 해싱에는 bcrypt를, 세션 저장에는 단기 JWT 토큰과 함께 Redis를 사용합니다. 데이터를 제3자에게 판매하거나 공유하지 않습니다. API 키는 저장 전에 해싱됩니다. 데이터 처리 방식에 대한 자세한 내용은 개인정보 처리방침을 참조하세요.

네, 플랜에 따라 다릅니다: Free (1개), Pro (5개), Business (∞개). 여러 키를 사용하면 애플리케이션, 환경(dev/staging/prod) 또는 팀원별로 사용량을 분리하고, 다른 키에 영향을 주지 않고 개별 키를 폐기할 수 있습니다.

즉시 대시보드 → API 키에서 노출된 키를 폐기하고 새 키를 생성하세요. 폐기는 즉시 적용되며, 기존 키를 사용하는 모든 요청은 401 오류로 거부됩니다. API 키를 버전 관리 시스템에 커밋하지 말고 환경 변수를 사용하세요.

저희는 API 가용성에 대해 99.9%의 업타임을 목표로 합니다. 비즈니스 플랜 고객에게는 업타임 보장이 포함된 SLA가 제공됩니다. 이 사이트 하단의 푸터에서 접근할 수 있는 상태 페이지에서 실시간 및 과거 서비스 상태를 모니터링할 수 있습니다.

네. 저희는 서비스 운영에 필요한 최소한의 데이터(이메일, 해싱된 비밀번호, 사용 로그)만 수집합니다. 데이터를 제3자에게 판매하지 않습니다. 대시보드 → 설정에서 언제든지 전체 데이터 내보내기 또는 삭제를 요청하거나 [email protected]으로 이메일을 보내실 수 있습니다. 자세한 내용은 개인정보 처리방침을 참조하세요.