Foire aux questions

Tout ce que vous devez savoir sur Pexafy. Vous ne trouvez pas votre réponse ? Contactez-nous.

Premiers pas

Qu'est-ce que Pexafy ?

Pexafy est un moteur de recherche d'images propulsé par l'IA qui agrège des millions d'images libres d'utilisation provenant de 9 sources — Unsplash, Pexels, Pixabay, Kaboompics, Burst et bien d'autres — au sein d'une seule API. Une requête Pexafy = une recherche sémantique sur l'ensemble des 9 sources. Avec les API natives des fournisseurs, la même recherche nécessite 3 à 5 appels, auxquels s'ajoutent la logique de fusion et la normalisation JSON : du code que vous écrivez, maintenez et payez.

Comment obtenir une clé API ?

Créez un compte gratuit sur pexafy.com/auth/register/, puis accédez à Tableau de bord → Clés API → Créer une clé. Votre première clé est générée instantanément, sans carte bancaire requise. Le plan gratuit inclut 5K requêtes API par mois.

Mon application doit-elle être approuvée ?

Non. Votre clé fonctionne dès le premier appel : aucune revue de candidature, aucune période d'attente et aucun appel de suivi de téléchargement obligatoire à effectuer à chaque téléchargement. Unsplash limite les applications non approuvées à 50 requêtes/heure jusqu'à l'examen de votre application ; Pexels autorise 200/heure.

Pexafy est-il gratuit ?

Oui ! Notre plan Free vous donne 5K requêtes API par mois — sans carte bancaire — et cherche dans toutes les sources que Pexafy indexe, comme tous les autres plans. Besoin de plus de requêtes ? Les plans payants, de Starter à Enterprise, relèvent les limites : consultez notre page Tarifs.

Quelles sources d'images Pexafy explore-t-il ?

Pexafy agrège actuellement 9 sources, les plus importantes étant Unsplash, Pexels, Pixabay, Kaboompics, Burst. Nous en ajoutons continuellement de nouvelles. Vous pouvez filtrer les résultats par source grâce au paramètre source de l'API.

En quoi Pexafy est-il différent de Google Images ?

Pexafy est une API pensée avant tout pour les développeurs, et non un moteur de recherche grand public. Nous n'agrégeons que des sources libres d'utilisation et sous licence Creative Commons, ce qui garantit que chaque résultat peut être utilisé en toute sécurité dans votre produit. Notre modèle d'IA comprend le sens sémantique — recherchez « ambiance cosy d'automne » et obtenez des images pertinentes, pas seulement des correspondances de mots-clés. De plus, vous bénéficiez de réponses JSON structurées, de la pagination, de filtres et d'analyses d'utilisation — le tout via une unique API REST.

Proposez-vous des SDK ou des bibliothèques clientes ?

Nous proposons actuellement une API REST avec une documentation complète. Des SDK officiels pour Python, JavaScript/TypeScript et PHP sont prévus dans notre feuille de route. En attendant, l'API est simple à intégrer — il suffit d'une seule requête HTTPS avec un en-tête de clé API. Consultez notre documentation pour des exemples de code dans plusieurs langages.

API et aspects techniques

Quelle est la limite de débit de l'API ?

Les limites de débit dépendent de votre plan : Gratuit — 20 requêtes/minute, Pro — 60 requêtes/minute, Business — 300 requêtes/minute. Si vous dépassez la limite, vous recevrez une réponse 429 Too Many Requests avec un en-tête Retry-After indiquant à quel moment vous pouvez réessayer.

Quels formats sont renvoyés par l'API ?

Toutes les réponses sont en JSON avec une enveloppe standard : {success, data, meta, pagination, error}. Chaque objet photo comprend : id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors et relevance score.

Comment gérer la pagination ?

Pexafy utilise une pagination basée sur des curseurs. Chaque réponse inclut une valeur pagination.next_cursor. Transmettez-la en tant que paramètre cursor dans votre prochaine requête pour obtenir la page suivante. Lorsque next_cursor est null, vous avez atteint la fin des résultats.

Puis-je filtrer les résultats de recherche ?

Oui ! Vous pouvez filtrer par : color_name (red, blue, green…), color_hex (ex. #FF5733 avec color_tolerance optionnel), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…), et score_threshold (pertinence minimale de 0.0 à 1.0). Combinez les filtres pour des résultats précis.

Comment authentifier les requêtes API ?

Ajoutez votre clé API en tant qu'en-tête de requête : X-Api-Key: pxfy_your_key_here. Vous pouvez également utiliser l'authentification par jeton Bearer : Authorization: Bearer <jwt_token>. Ne partagez jamais votre clé API dans du code côté client.

Quel est le nombre maximum de résultats par requête ?

Vous pouvez demander jusqu'à 80 résultats par page via le paramètre per_page (valeur par défaut : 20). Pour les grands ensembles de résultats, utilisez la pagination par curseur pour récupérer les pages suivantes. Il n'y a aucune limite sur le nombre total de pages que vous pouvez parcourir.

Pexafy prend-il en charge les requêtes de recherche multilingues ?

Oui ! Notre modèle a été entraîné sur des données multilingues, vous pouvez donc effectuer des recherches en anglais, français, espagnol, allemand, portugais et dans de nombreuses autres langues. La compréhension sémantique fonctionne mieux en anglais, mais la plupart des requêtes courantes dans d'autres langues produisent des résultats précis. Nous recommandons l'anglais pour une précision maximale.

Facturation & Abonnements

Puis-je changer mon abonnement ?

Oui, changez de plan à tout moment depuis Tableau de bord → Facturation. Le changement prend effet immédiatement et Creem, notre revendeur, le calcule au prorata : passer à un plan supérieur facture la différence de prix pour le reste de la période en cours, passer à un plan inférieur la rembourse.

Que se passe-t-il si je dépasse mon quota ?

Les requêtes API sont bloquées dès que vous atteignez votre limite mensuelle — vous recevrez une réponse 429 accompagnée d'un message d'erreur explicite. Pour continuer à utiliser l'API, passez à un abonnement supérieur depuis Tableau de bord → Facturation.

Proposez-vous des remboursements ?

Nous offrons une garantie satisfait ou remboursé de 14 jours sur tous les abonnements payants. Si vous n'êtes pas satisfait dans les 14 premiers jours suivant votre souscription, contactez-nous à [email protected] et nous vous rembourserons intégralement, sans question. Creem, notre revendeur, le reverse sur votre moyen de paiement d'origine. Les détails figurent dans notre politique de remboursement : pexafy.com/legal/refund/

Quels moyens de paiement acceptez-vous ?

Les paiements sont traités par Creem, notre revendeur et marchand officiel (Merchant of Record). Vous pouvez payer par carte de crédit ou de débit, ou avec les autres moyens de paiement que Creem propose au paiement dans votre pays. Nous ne voyons ni ne conservons jamais les données de votre carte.

Y a-t-il un engagement à long terme ?

Aucun contrat, aucun engagement. Tous les abonnements sont mensuels (ou annuels avec réduction si vous le souhaitez). Annulez à tout moment depuis Tableau de bord → Facturation en un seul clic. Votre accès se poursuit jusqu'à la fin de la période de facturation en cours.

Y a-t-il une réduction pour un abonnement annuel ?

Oui ! Payer annuellement permet d'économiser jusqu'à 18 % : Pro est à $199/an ($17/mois) au lieu de $19/mois. Business est à $2599/an ($217/mois) au lieu de $249/mois. Passez à l'annuel depuis Tableau de bord → Facturation.

Proposez-vous des offres entreprise personnalisées ?

Oui ! Si vos besoins dépassent l'abonnement Enterprise — limites de requêtes plus élevées, infrastructure dédiée, SLA personnalisé ou déploiement sur site — contactez-nous à [email protected] en décrivant vos besoins. Nous élaborerons un plan sur mesure pour votre organisation.

Quelles devises acceptez-vous pour le paiement ?

Tous les prix sont affichés en USD, et Creem, notre revendeur, les facture en USD. Des taxes comme la TVA peuvent s'ajouter au paiement selon votre pays. Si votre carte est dans une autre devise, votre banque convertit le montant et peut appliquer de légers frais de change.

Images & Licences

Pexafy est-il propriétaire des images ?

Non. Pexafy est un moteur de recherche — nous indexons et recherchons des images hébergées sur des plateformes tierces (Unsplash, Pexels, Pixabay, etc.). Nous ne stockons, n'hébergeons ni ne redistribuons les fichiers image. Toutes les images restent la propriété de leurs photographes et plateformes respectifs.

Puis-je utiliser les images à des fins commerciales ?

Cela dépend de la licence de la source. Unsplash, Pexels et Pixabay proposent tous des licences d'utilisation commerciale gratuite pour la plupart de leurs images, et les sources plus petites que nous indexons suivent le même modèle. Vérifiez toujours le champ de licence dans la réponse de l'API et confirmez à l'URL source avant d'utiliser une image à des fins commerciales.

Est-ce que je paie les images ?

Non. Pexafy ne vend pas d'images. Chaque résultat provient d'une bibliothèque d'images libres d'utilisation — Unsplash, Pexels, Pixabay, Kaboompics, Burst et d'autres — et renvoie vers elle, sous la licence propre à cette bibliothèque. Votre plan paie uniquement le service de recherche : requêtes API, limites de débit, clés API et assistance. Vérifiez la licence de chaque image à sa source avant de l'utiliser.

Puis-je télécharger des images via l'API ?

Pexafy renvoie des URL vers des images hébergées sur leurs plateformes d'origine — nous ne servons pas les fichiers image directement via l'API. Vous pouvez télécharger l'image en pleine résolution à partir de l'URL source fournie dans la réponse. Respectez toujours les conditions d'utilisation de la plateforme source.

À quelle fréquence l'index d'images est-il mis à jour ?

Notre pipeline d'indexation s'exécute quotidiennement pour toutes les sources principales. Les nouvelles images téléversées sur Unsplash, Pexels, Pixabay et d'autres plateformes sont généralement consultables via Pexafy dans un délai de 24 à 48 heures. Notre index contient actuellement 9M+ images et s'enrichit chaque jour.

Compte & Sécurité

Comment supprimer mon compte ?

Accédez à Tableau de bord → Paramètres → Zone dangereuse → Supprimer le compte. La suppression du compte est définitive et efface toutes vos clés API, votre historique d'utilisation et vos données personnelles. Vous pouvez également nous envoyer un e-mail à [email protected] pour demander la suppression en vertu du RGPD/droit à l'effacement.

Mes données sont-elles sécurisées ?

Oui. Nous utilisons HTTPS partout, bcrypt pour le hachage des mots de passe, et stockons les sessions dans Redis avec des jetons JWT à durée de vie courte. Nous ne vendons ni ne partageons vos données avec des tiers. Les clés API sont hachées avant stockage. Consultez notre Politique de confidentialité pour tous les détails sur nos pratiques en matière de données.

Puis-je avoir plusieurs clés API ?

Oui, selon votre formule : Free (1 clé), Pro (5 clés), Business (∞ clés). Plusieurs clés vous permettent de segmenter l'utilisation par application, environnement (dev/staging/prod) ou membre de l'équipe, et de révoquer des clés individuelles sans affecter les autres.

Que faire si ma clé API est compromise ?

Révoquez immédiatement la clé compromise depuis Tableau de bord → Clés API et créez-en une nouvelle. La révocation prend effet instantanément — toute requête utilisant l'ancienne clé sera rejetée avec une erreur 401. Ne commitez jamais de clés API dans un système de contrôle de version ; utilisez des variables d'environnement à la place.

Quelle est votre garantie de disponibilité ?

Nous visons une disponibilité de l'API de 99,9 %. Les clients du plan Business bénéficient d'un SLA avec des engagements de disponibilité. Vous pouvez surveiller l'état du service en temps réel et son historique sur notre page Statut, accessible depuis le pied de page de ce site.

Pexafy est-il conforme au RGPD ?

Oui. Nous collectons uniquement les données minimales nécessaires au fonctionnement du service (e-mail, mot de passe haché, journaux d'utilisation). Nous ne vendons pas de données à des tiers. Vous pouvez demander un export complet de vos données ou leur suppression à tout moment depuis Tableau de bord → Paramètres ou en envoyant un e-mail à [email protected]. Consultez notre Politique de confidentialité pour tous les détails.

Vous avez encore des questions ?

Vous ne trouvez pas ce que vous cherchez ? Notre équipe se fera un plaisir de vous aider.

Contacter l'assistance Lire la documentation de l'API

À propos de Pexafy Blog