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 gratuites et premium provenant de plusieurs sources — Unsplash, Pexels, Pixabay, Wikimedia Commons, et bien d'autres — au sein d'une seule API. Au lieu d'intégrer des dizaines de services d'images, vous effectuez une seule requête vers Pexafy et obtenez les meilleurs résultats de toutes les sources, classés par pertinence sémantique grâce à l'IA.
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 1K requêtes API par mois.
Pexafy est-il gratuit ?
Oui ! Notre plan Gratuit vous offre 1K requêtes API par mois — sans carte bancaire. Vous pouvez effectuer des recherches textuelles et accéder à toutes les sources d'images gratuites. Besoin de plus de requêtes, d'images premium ou de la recherche image par image ? Consultez notre page Tarifs pour découvrir les plans Pro et Business.
Quelles sources d'images Pexafy explore-t-il ?
Pexafy agrège actuellement des images provenant de Unsplash, Pexels, Pixabay, Wikimedia Commons et Openverse. Nous ajoutons continuellement de nouvelles sources. Vous pouvez filtrer les résultats par source grâce au paramètre source dans 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, vous pouvez passer à un abonnement supérieur ou inférieur à tout moment depuis Tableau de bord → Facturation. Les mises à niveau prennent effet immédiatement avec une facturation au prorata. Les rétrogradations prennent effet à la fin de votre période de facturation en cours. Tout est géré automatiquement via Stripe.
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.
Quels moyens de paiement acceptez-vous ?
Nous acceptons toutes les principales cartes de crédit et de débit (Visa, Mastercard, American Express), ainsi qu'Apple Pay et Google Pay — le tout traité en toute sécurité via Stripe. Nous ne stockons aucune information de paiement sur nos serveurs.
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 environ 17 % : Pro est à $290/an ($24/mois) au lieu de $29/mois. Business est à $2990/an ($249/mois) au lieu de $299/mois. Passez à l'annuel depuis Tableau de bord → Facturation.
Proposez-vous des offres entreprise personnalisées ?
Oui ! Si vos besoins dépassent l'abonnement Business — 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. Stripe, notre prestataire de paiement, convertit automatiquement dans votre devise locale lors du paiement. Votre banque peut appliquer de légers frais de change selon le type de carte et votre pays.
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 des licences d'utilisation commerciale gratuite pour la plupart de leurs images. Wikimedia Commons et Openverse utilisent diverses licences Creative Commons — certaines autorisent l'usage commercial, d'autres non. Vérifiez toujours le champ de licence dans la réponse API et confirmez à l'URL source avant d'utiliser une image à des fins commerciales.
En quoi les images premium sont-elles différentes ?
Les images premium apparaissent dans les résultats de recherche, mais peuvent nécessiter un abonnement ou un achat auprès de la source pour être téléchargées en pleine résolution. L'API renvoie des aperçus/miniatures pour toutes les images. Avec les formules Free et Pro, l'URL source dans la réponse vous indique où accéder à l'image complète.
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. Pour les images libres de droits (Unsplash, Pexels, Pixabay), 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 plus de 5 millions d'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.
Aucune question ne correspond à votre recherche. Essayez un autre terme.
Posez-nous votre question directementVous 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