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 de uso libre provenientes de 9 fuentes — Unsplash, Pexels, Pixabay, Kaboompics, Burst y más — en una única API. Una solicitud a Pexafy = una búsqueda semántica en las 9 fuentes a la vez. Con las APIs propias de los proveedores, la misma búsqueda requiere entre 3 y 5 llamadas, más la lógica de fusión y la normalización de JSON: código que tú escribes, mantienes y pagas.

¿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 5K solicitudes de API al mes.

¿Necesito que mi aplicación sea aprobada?

No. Tu clave funciona desde la primera llamada: sin revisión de aplicación, sin período de espera y sin necesidad de realizar una llamada de seguimiento de descargas en cada descarga. Unsplash limita las aplicaciones no aprobadas a 50 solicitudes/hora hasta revisar tu aplicación; Pexels permite 200/hora.

¿Es Pexafy gratuito?

¡Sí! Nuestro plan Free te da 5K solicitudes de API al mes —sin tarjeta de crédito— y busca en todas las fuentes que indexa Pexafy, como cualquier otro plan. ¿Necesitas más solicitudes? Los planes de pago, de Starter a Enterprise, amplían los límites: consulta nuestra página de precios.

¿Qué fuentes de imágenes busca Pexafy?

Pexafy agrega actualmente 9 fuentes, siendo las principales Unsplash, Pexels, Pixabay, Kaboompics, Burst. Seguimos añadiendo más. 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í, cambia de plan cuando quieras desde Panel → Facturación. El cambio se aplica de inmediato y Creem, nuestro revendedor, lo prorratea: pasar a un plan superior cobra la diferencia de precio por el resto de tu período actual; pasar a uno inferior la reembolsa.

¿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. Creem, nuestro revendedor, lo devuelve a tu método de pago original. Detalles en nuestra Política de reembolso: pexafy.com/legal/refund/

¿Qué métodos de pago aceptan?

Los pagos los procesa Creem, nuestro revendedor y Merchant of Record. Puedes pagar con tarjeta de crédito o débito, o con los demás métodos de pago que Creem ofrece al pagar en tu país. Nunca vemos ni guardamos los datos de tu tarjeta.

¿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 hasta un 18 %: Pro es $199/año ($17/mes) en lugar de $19/mes. Business es $2599/año ($217/mes) en lugar de $249/mes. Cambia a facturación anual desde Panel → Facturación.

¿Ofrecen planes empresariales personalizados?

¡Sí! Si tus necesidades superan el plan Enterprise — 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 en USD, y Creem, nuestro revendedor, los cobra en USD. Según tu país, al pagar pueden añadirse impuestos como el IVA. Si tu tarjeta usa otra moneda, tu banco convierte el importe y puede aplicar una pequeña comisión por cambio de divisa.

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, y las fuentes menores que indexamos siguen el mismo modelo. Comprueba siempre el campo de licencia en la respuesta de la API y verifica en la URL de origen antes de utilizar una imagen con fines comerciales.

¿Pago por las imágenes?

No. Pexafy no vende imágenes. Cada resultado procede de una biblioteca de uso libre —Unsplash, Pexels, Pixabay, Kaboompics, Burst y otras— y enlaza a ella, bajo la licencia propia de esa biblioteca. Tu plan paga solo el servicio de búsqueda: solicitudes de API, límites de frecuencia, claves de API y soporte. Comprueba la licencia de cada imagen en su origen antes de usarla.

¿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. 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 9M+ 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