Preguntas frecuentes

Todo lo que necesita saber sobre Pexafy. ¿No encuentra su respuesta? Contáctenos.

Primeros pasos

¿Qué es Pexafy?

Pexafy es un motor de búsqueda de imágenes impulsado por IA que agrega millones de imágenes gratuitas y de pago de múltiples fuentes —Unsplash, Pexels, Pixabay, Wikimedia Commons y más— en una sola API. En lugar de integrar decenas de servicios de imágenes, realizas una única solicitud a Pexafy y obtienes los mejores resultados de todas las fuentes, clasificados por relevancia semántica mediante IA.

¿Cómo obtengo una clave de API?

Regístrate para obtener una cuenta gratuita en pexafy.com/auth/register/, luego ve a Panel → Claves de API → Crear clave. Tu primera clave se crea al instante sin necesidad de tarjeta de crédito. El plan gratuito incluye 1K solicitudes de API al mes.

¿Es Pexafy gratuito?

¡Sí! Nuestro plan gratuito te ofrece 1K solicitudes de API al mes, sin necesidad de tarjeta de crédito. Puedes realizar búsquedas por texto y acceder a todas las fuentes de imágenes gratuitas. ¿Necesitas más solicitudes, imágenes premium o búsqueda por imagen? Consulta nuestra página de Precios para los planes Pro y Business.

¿Qué fuentes de imágenes busca Pexafy?

Pexafy actualmente agrega imágenes de Unsplash, Pexels, Pixabay, Wikimedia Commons y Openverse. Estamos añadiendo más fuentes continuamente. Puedes filtrar los resultados por fuente usando el parámetro source en la API.

¿En qué se diferencia Pexafy de Google Imágenes?

Pexafy es una API orientada a desarrolladores, no un motor de búsqueda para consumidores. Solo agregamos fuentes de uso libre y Creative Commons, por lo que cada resultado es seguro para usar en tu producto. Nuestro modelo de IA comprende el significado semántico: busca «ambiente acogedor de otoño» y obtén imágenes relevantes, no simples coincidencias de palabras clave. Además, obtienes respuestas JSON estructuradas, paginación, filtros y análisis de uso, todo a través de una única API REST.

¿Ofrecen SDKs o bibliotecas cliente?

Actualmente ofrecemos una API REST con documentación completa. Los SDKs oficiales para Python, JavaScript/TypeScript y PHP están en nuestra hoja de ruta. Mientras tanto, la API es sencilla de integrar: solo requiere una solicitud HTTPS con un encabezado de clave de API. Consulta nuestra documentación para ver ejemplos de código en varios lenguajes.

API y aspectos técnicos

¿Cuál es el límite de frecuencia de la API?

Los límites de frecuencia dependen de tu plan: Gratuito — 20 solicitudes/minuto, Pro — 60 solicitudes/minuto, Business — 300 solicitudes/minuto. Si superas el límite, recibirás una respuesta 429 Too Many Requests con un encabezado Retry-After que indica cuándo puedes volver a intentarlo.

¿Qué formatos devuelve la API?

Todas las respuestas son JSON con un sobre estándar: {success, data, meta, pagination, error}. Cada objeto de foto incluye: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors y puntuación de relevancia.

¿Cómo gestiono la paginación?

Pexafy utiliza paginación basada en cursor. Cada respuesta incluye un valor pagination.next_cursor. Pásalo como parámetro cursor en tu siguiente solicitud para obtener la página siguiente. Cuando next_cursor sea null, habrás llegado al final.

¿Puedo filtrar los resultados de búsqueda?

¡Sí! Puedes filtrar por: color_name (red, blue, green…), color_hex (p. ej. #FF5733 con color_tolerance opcional), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…) y score_threshold (relevancia mínima 0.0–1.0). Combina filtros para obtener resultados más precisos.

¿Cómo autenticó las solicitudes a la API?

Añade tu clave de API como encabezado de la solicitud: X-Api-Key: pxfy_your_key_here. También puedes usar autenticación mediante token Bearer: Authorization: Bearer <jwt_token>. Nunca compartas tu clave de API en código del lado del cliente.

¿Cuál es el número máximo de resultados por solicitud?

Puedes solicitar hasta 80 resultados por página usando el parámetro per_page (el valor predeterminado es 20). Para conjuntos de resultados grandes, utiliza la paginación basada en cursor para obtener páginas siguientes. No hay límite en el número total de páginas por las que puedes paginar.

¿Pexafy admite consultas de búsqueda en varios idiomas?

¡Sí! Nuestro modelo fue entrenado con datos multilingües, por lo que puedes buscar en inglés, francés, español, alemán, portugués y muchos otros idiomas. La comprensión semántica funciona mejor en inglés, pero la mayoría de las consultas habituales en otros idiomas producen resultados precisos. Recomendamos el inglés para obtener la máxima precisión.

Facturación y planes

¿Puedo cambiar mi plan?

Sí, puedes actualizar o cambiar a un plan inferior en cualquier momento desde Panel → Facturación. Las actualizaciones surten efecto de inmediato con facturación prorrateada. Los cambios a planes inferiores entran en vigor al final de tu período de facturación actual. Todo se gestiona automáticamente a través de Stripe.

¿Qué ocurre si supero mi cuota?

Las solicitudes a la API se bloquean una vez que alcanzas tu límite mensual — recibirás una respuesta 429 con un mensaje de error informativo. Para continuar usando la API, actualiza a un plan superior desde Panel → Facturación.

¿Ofrecen reembolsos?

Ofrecemos una garantía de devolución de dinero de 14 días en todos los planes de pago. Si no estás satisfecho dentro de los primeros 14 días de tu suscripción, contáctanos en [email protected] y realizaremos un reembolso completo, sin preguntas.

¿Qué métodos de pago aceptan?

Aceptamos todas las principales tarjetas de crédito y débito (Visa, Mastercard, American Express), así como Apple Pay y Google Pay — todo procesado de forma segura a través de Stripe. No almacenamos ningún dato de pago en nuestros servidores.

¿Existe un contrato a largo plazo?

Sin contratos, sin compromisos. Todos los planes son mensuales (o anuales con descuento si lo prefieres). Cancela en cualquier momento desde Panel → Facturación con un solo clic. Tu acceso continúa hasta el final del período de facturación actual.

¿Hay descuento por pago anual?

¡Sí! Pagar anualmente ahorra aproximadamente un 17 %: Pro es $290/año ($24/mes) en lugar de $29/mes. Business es $2990/año ($249/mes) en lugar de $299/mes. Cambia a facturación anual desde Panel → Facturación.

¿Ofrecen planes empresariales personalizados?

¡Sí! Si tus necesidades superan el plan Business — límites de solicitudes más altos, infraestructura dedicada, SLA personalizado o implementación local — contáctanos en [email protected] con tus requisitos. Prepararemos un plan a medida para tu organización.

¿Qué monedas admiten para el pago?

Todos los precios están indicados en USD. Stripe, nuestro procesador de pagos, convierte automáticamente a tu moneda local en el momento del pago. Tu banco puede aplicar una pequeña comisión por cambio de divisa según el tipo de tarjeta y el país.

Imágenes y licencias

¿Pexafy es propietario de las imágenes?

No. Pexafy es un motor de búsqueda — indexamos y buscamos imágenes alojadas en plataformas de terceros (Unsplash, Pexels, Pixabay, etc.). No almacenamos, alojamos ni redistribuimos los archivos de imagen reales. Todas las imágenes siguen siendo propiedad de sus respectivos fotógrafos y plataformas.

¿Puedo usar las imágenes con fines comerciales?

Depende de la licencia de la fuente. Unsplash, Pexels y Pixabay ofrecen licencias de uso comercial gratuito para la mayoría de sus imágenes. Wikimedia Commons y Openverse utilizan diversas licencias Creative Commons — algunas permiten el uso comercial y otras no. Consulta siempre el campo de licencia en la respuesta de la API y verifica en la URL de la fuente antes de utilizar una imagen con fines comerciales.

¿En qué se diferencian las imágenes premium?

Las imágenes premium aparecen en los resultados de búsqueda, pero pueden requerir una suscripción o compra en la fuente para descargarlas en resolución completa. La API devuelve vistas previas/miniaturas de todas las imágenes. En los planes Free y Pro, la URL de origen incluida en la respuesta indica dónde acceder a la imagen completa.

¿Puedo descargar imágenes a través de la API?

Pexafy devuelve URLs de imágenes alojadas en sus plataformas originales; no servimos archivos de imagen directamente a través de la API. Para imágenes gratuitas (Unsplash, Pexels, Pixabay), puedes descargar la imagen en resolución completa desde la URL de origen proporcionada en la respuesta. Respeta siempre los términos de servicio de la plataforma de origen.

¿Con qué frecuencia se actualiza el índice de imágenes?

Nuestro proceso de indexación se ejecuta diariamente para todas las fuentes principales. Las nuevas imágenes subidas a Unsplash, Pexels, Pixabay y otras plataformas suelen estar disponibles para búsqueda en Pexafy en un plazo de 24–48 horas. Nuestro índice contiene actualmente más de 5 millones de imágenes y crece cada día.

Cuenta y seguridad

¿Cómo elimino mi cuenta?

Ve a Dashboard → Settings → Danger Zone → Delete Account. La eliminación de la cuenta es permanente y borra todas tus claves de API, el historial de uso y tus datos personales. También puedes enviarnos un correo a [email protected] para solicitar la eliminación según el RGPD/derecho al olvido.

¿Están seguros mis datos?

Sí. Usamos HTTPS en todas partes, bcrypt para el hash de contraseñas y almacenamos sesiones en Redis con tokens JWT de corta duración. No vendemos ni compartimos tus datos con terceros. Las claves de API se hashean antes de almacenarse. Lee nuestra Política de privacidad para obtener información completa sobre el tratamiento de datos.

¿Puedo tener varias claves de API?

Sí, según tu plan: Free (1 clave), Pro (5 claves), Business (∞ claves). Contar con varias claves te permite separar el uso por aplicación, entorno (dev/staging/prod) o miembro del equipo, y revocar claves individuales sin afectar a las demás.

¿Qué ocurre si mi clave de API se ve comprometida?

Revoca inmediatamente la clave comprometida desde Dashboard → API Keys y crea una nueva. La revocación surte efecto de forma instantánea: cualquier solicitud que use la clave antigua será rechazada con un error 401. Nunca incluyas claves de API en el control de versiones; usa variables de entorno en su lugar.

¿Cuál es su garantía de tiempo de actividad?

Nuestro objetivo es una disponibilidad de la API del 99,9 por ciento. Los clientes del plan Business reciben un SLA con compromisos de tiempo de actividad. Puede supervisar el estado del servicio en tiempo real e histórico en nuestra página de Estado, accesible desde el pie de página de este sitio.

¿Cumple Pexafy con el RGPD?

Sí. Solo recopilamos los datos mínimos necesarios para operar el servicio (correo electrónico, contraseña hasheada, registros de uso). No vendemos datos a terceros. Puedes solicitar una exportación completa de tus datos o su eliminación en cualquier momento desde Dashboard → Settings o enviando un correo a [email protected]. Consulta nuestra Política de privacidad para obtener información completa.

¿Aún tiene preguntas?

¿No encuentra lo que busca? Nuestro equipo estará encantado de ayudar.

Contactar con soporte Lea la documentación de la API

Acerca de Pexafy Blog