Häufig gestellte Fragen
Alles, was Sie über Pexafy wissen müssen. Keine Antwort gefunden? Kontaktieren Sie uns.
Erste Schritte
Was ist Pexafy?
Pexafy ist eine KI-gestützte Bildsuchmaschine, die Millionen von kostenlosen und Premium-Bildern aus verschiedenen Quellen – Unsplash, Pexels, Pixabay, Wikimedia Commons und mehr – in einer einzigen API bündelt. Anstatt Dutzende von Bilddiensten zu integrieren, stellen Sie eine Anfrage an Pexafy und erhalten die besten Ergebnisse aus allen Quellen, sortiert nach semantischer KI-Relevanz.
Wie erhalte ich einen API-Schlüssel?
Registrieren Sie sich für ein kostenloses Konto unter pexafy.com/auth/register/ und gehen Sie dann zu Dashboard → API-Schlüssel → Schlüssel erstellen. Ihr erster Schlüssel wird sofort erstellt, ohne dass eine Kreditkarte erforderlich ist. Der kostenlose Plan umfasst 1K API-Anfragen pro Monat.
Ist Pexafy kostenlos nutzbar?
Ja! Unser kostenloser Plan bietet Ihnen 1K API-Anfragen pro Monat – ohne Kreditkarte. Sie können textbasierte Suchanfragen stellen und auf alle kostenlosen Bildquellen zugreifen. Benötigen Sie mehr Anfragen, Premium-Bilder oder Bild-zu-Bild-Suche? Besuchen Sie unsere Preisseite für Pro- und Business-Pläne.
Welche Bildquellen durchsucht Pexafy?
Pexafy aggregiert derzeit Bilder von Unsplash, Pexels, Pixabay, Wikimedia Commons und Openverse. Wir fügen kontinuierlich weitere Quellen hinzu. Sie können die Ergebnisse mithilfe des Parameters source in der API nach Quelle filtern.
Worin unterscheidet sich Pexafy von Google Bilder?
Pexafy ist eine entwicklerzentrierte API, keine Verbrauchersuchmaschine. Wir aggregieren ausschließlich frei nutzbare und Creative-Commons-Quellen, sodass jedes Ergebnis sicher in Ihrem Produkt verwendet werden kann. Unser KI-Modell versteht semantische Bedeutungen – suchen Sie nach 'gemütliche Herbststimmung' und erhalten Sie relevante Bilder, nicht nur Keyword-Treffer. Zudem erhalten Sie strukturierte JSON-Antworten, Paginierung, Filter und Nutzungsanalysen – alles über eine einzige REST-API.
Bieten Sie SDKs oder Client-Bibliotheken an?
Wir stellen derzeit eine REST-API mit umfassender Dokumentation bereit. Offizielle SDKs für Python, JavaScript/TypeScript und PHP sind in unserer Roadmap enthalten. In der Zwischenzeit ist die API einfach zu integrieren – lediglich eine HTTPS-Anfrage mit einem API-Schlüssel-Header. Sehen Sie sich unsere Dokumentation für Codebeispiele in verschiedenen Sprachen an.
API & Technisches
Welche API-Ratenbegrenzung gilt?
Die Ratenbegrenzungen hängen von Ihrem Plan ab: Free – 20 Anfragen/Minute, Pro – 60 Anfragen/Minute, Business – 300 Anfragen/Minute. Wenn Sie das Limit überschreiten, erhalten Sie eine 429 Too Many Requests-Antwort mit einem Retry-After-Header, der angibt, wann Sie es erneut versuchen können.
Welche Formate gibt die API zurück?
Alle Antworten sind JSON mit einem Standardrahmen: {success, data, meta, pagination, error}. Jedes Fotoobjekt enthält: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors und relevance score.
Wie funktioniert die Paginierung?
Pexafy verwendet cursorbasierte Paginierung. Jede Antwort enthält einen pagination.next_cursor-Wert. Übergeben Sie diesen als cursor-Parameter in Ihrer nächsten Anfrage, um die folgende Seite abzurufen. Wenn next_cursor null ist, haben Sie das Ende erreicht.
Kann ich Suchergebnisse filtern?
Ja! Sie können filtern nach: color_name (red, blue, green …), color_hex (z. B. #FF5733 mit optionalem color_tolerance), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay …) und score_threshold (Mindest-Relevanz 0,0–1,0). Kombinieren Sie Filter für präzise Ergebnisse.
Wie authentifiziere ich API-Anfragen?
Fügen Sie Ihren API-Schlüssel als Anfrage-Header hinzu: X-Api-Key: pxfy_your_key_here. Alternativ können Sie Bearer-Token-Authentifizierung verwenden: Authorization: Bearer <jwt_token>. Geben Sie Ihren API-Schlüssel niemals in clientseitigem Code weiter.
Was ist die maximale Anzahl an Ergebnissen pro Anfrage?
Sie können bis zu 80 Ergebnisse pro Seite über den Parameter per_page abrufen (Standardwert ist 20). Verwenden Sie bei großen Ergebnismengen die cursorbasierte Paginierung, um weitere Seiten abzurufen. Es gibt keine Begrenzung der Gesamtanzahl von Seiten, durch die Sie blättern können.
Unterstützt Pexafy mehrsprachige Suchanfragen?
Ja! Unser Modell wurde mit mehrsprachigen Daten trainiert, sodass Sie auf Englisch, Französisch, Spanisch, Deutsch, Portugiesisch und vielen weiteren Sprachen suchen können. Das semantische Verständnis funktioniert am besten auf Englisch, aber die meisten gängigen Suchanfragen in anderen Sprachen liefern genaue Ergebnisse. Für maximale Präzision empfehlen wir Englisch.
Abrechnung & Pläne
Kann ich meinen Plan wechseln?
Ja, Sie können jederzeit über Dashboard → Abrechnung upgraden oder downgraden. Upgrades werden sofort mit anteiliger Abrechnung wirksam. Downgrades werden zum Ende des aktuellen Abrechnungszeitraums wirksam. Alles wird automatisch über Stripe abgewickelt.
Was passiert, wenn ich mein Kontingent überschreite?
API-Anfragen werden blockiert, sobald Sie Ihr monatliches Limit erreichen — Sie erhalten eine 429-Antwort mit einer informativen Fehlermeldung. Um die API weiterhin zu nutzen, upgraden Sie über Dashboard → Abrechnung auf einen höheren Plan.
Bieten Sie Rückerstattungen an?
Wir bieten eine 14-tägige Geld-zurück-Garantie für alle kostenpflichtigen Pläne. Wenn Sie innerhalb der ersten 14 Tage nach Ihrem Abonnement nicht zufrieden sind, kontaktieren Sie uns unter [email protected], und wir erstatten Ihnen den vollen Betrag – ohne Wenn und Aber.
Welche Zahlungsmethoden akzeptieren Sie?
Wir akzeptieren alle gängigen Kredit- und Debitkarten (Visa, Mastercard, American Express) sowie Apple Pay und Google Pay – alles sicher über Stripe verarbeitet. Wir speichern keinerlei Zahlungsinformationen auf unseren Servern.
Gibt es einen langfristigen Vertrag?
Keine Verträge, keine Verpflichtungen. Alle Pläne laufen monatlich (oder vergünstigt jährlich, wenn Sie es bevorzugen). Kündigen Sie jederzeit mit einem einzigen Klick über Dashboard → Abrechnung. Ihr Zugang bleibt bis zum Ende des aktuellen Abrechnungszeitraums bestehen.
Gibt es einen Jahresrabatt?
Ja! Bei jährlicher Zahlung sparen Sie ca. 17 %: Pro kostet $290/Jahr ($24/Monat) statt $29/Monat. Business kostet $2990/Jahr ($249/Monat) statt $299/Monat. Wechseln Sie über Dashboard → Abrechnung zur Jahreszahlung.
Bieten Sie individuelle Enterprise-Pläne an?
Ja! Wenn Ihre Anforderungen den Business-Plan übersteigen – höhere Ratenlimits, dedizierte Infrastruktur, individuelles SLA oder On-Premise-Deployment – kontaktieren Sie uns unter [email protected] mit Ihren Anforderungen. Wir stellen einen maßgeschneiderten Plan für Ihre Organisation zusammen.
Welche Währungen werden für Zahlungen unterstützt?
Alle Preise sind in USD angegeben. Stripe, unser Zahlungsdienstleister, konvertiert beim Bezahlvorgang automatisch in Ihre lokale Währung. Ihre Bank kann je nach Kartentyp und Land eine geringe Fremdwährungsgebühr erheben.
Bilder & Lizenzen
Besitzt Pexafy die Bilder?
Nein. Pexafy ist eine Suchmaschine – wir indizieren und durchsuchen Bilder, die auf Drittanbieter-Plattformen gehostet werden (Unsplash, Pexels, Pixabay usw.). Wir speichern, hosten oder verteilen die eigentlichen Bilddateien nicht. Alle Bilder bleiben das Eigentum der jeweiligen Fotografen und Plattformen.
Kann ich Bilder für kommerzielle Zwecke verwenden?
Das hängt von der Quelllizenz ab. Unsplash, Pexels und Pixabay bieten für die meisten ihrer Bilder kostenlose kommerzielle Lizenzen an. Wikimedia Commons und Openverse verwenden verschiedene Creative-Commons-Lizenzen – manche erlauben die kommerzielle Nutzung, andere nicht. Prüfen Sie stets das Lizenzfeld in der API-Antwort und verifizieren Sie die Nutzungsbedingungen unter der Quell-URL, bevor Sie ein Bild kommerziell verwenden.
Was unterscheidet Premium-Bilder von anderen?
Premium-Bilder erscheinen in den Suchergebnissen, erfordern jedoch möglicherweise ein Abonnement oder einen Kauf bei der Quelle, um sie in voller Auflösung herunterzuladen. Die API gibt für alle Bilder Vorschaubilder/Thumbnails zurück. Bei den Free- und Pro-Tarifen gibt die Quell-URL in der Antwort an, wo Sie auf das vollständige Bild zugreifen können.
Kann ich Bilder über die API herunterladen?
Pexafy gibt URLs zu Bildern zurück, die auf ihren Originalplattformen gehostet werden – wir stellen keine Bilddateien direkt über die API bereit. Bei freien Bildern (Unsplash, Pexels, Pixabay) können Sie das Bild in voller Auflösung von der in der Antwort angegebenen Quell-URL herunterladen. Beachten Sie stets die Nutzungsbedingungen der jeweiligen Quellplattform.
Wie oft wird der Bildindex aktualisiert?
Unsere Indexierungs-Pipeline wird täglich für alle wichtigen Quellen ausgeführt. Neue Bilder, die auf Unsplash, Pexels, Pixabay und anderen Plattformen hochgeladen werden, sind in der Regel innerhalb von 24–48 Stunden über Pexafy auffindbar. Unser Index enthält derzeit über 5 Millionen Bilder und wächst täglich.
Konto & Sicherheit
Wie lösche ich mein Konto?
Gehen Sie zu Dashboard → Einstellungen → Gefahrenzone → Konto löschen. Die Kontolöschung ist dauerhaft und entfernt alle Ihre API-Schlüssel, den Nutzungsverlauf und Ihre persönlichen Daten. Sie können uns auch eine E-Mail an [email protected] senden, um die Löschung gemäß DSGVO/Recht auf Vergessenwerden zu beantragen.
Sind meine Daten sicher?
Ja. Wir verwenden überall HTTPS, bcrypt für das Passwort-Hashing und speichern Sitzungen in Redis mit kurzlebigen JWT-Tokens. Wir verkaufen oder teilen Ihre Daten nicht mit Dritten. API-Schlüssel werden vor der Speicherung gehasht. Ausführliche Informationen zu unseren Datenpraktiken finden Sie in unserer Datenschutzrichtlinie.
Kann ich mehrere API-Schlüssel haben?
Ja, abhängig von Ihrem Tarif: Free (1 Schlüssel), Pro (5 Schlüssel), Business (∞ Schlüssel). Mehrere Schlüssel ermöglichen es Ihnen, die Nutzung nach Anwendung, Umgebung (dev/staging/prod) oder Teammitglied zu trennen und einzelne Schlüssel zu widerrufen, ohne andere zu beeinflussen.
Was passiert, wenn mein API-Schlüssel kompromittiert wird?
Widerrufen Sie den kompromittierten Schlüssel sofort unter Dashboard → API-Schlüssel und erstellen Sie einen neuen. Der Widerruf tritt sofort in Kraft – alle Anfragen mit dem alten Schlüssel werden mit einem 401-Fehler abgelehnt. Speichern Sie API-Schlüssel niemals in der Versionsverwaltung; verwenden Sie stattdessen Umgebungsvariablen.
Welche Verfügbarkeitsgarantie bieten Sie?
Wir streben eine API-Verfügbarkeit von 99,9 Prozent an. Business-Plan-Kunden erhalten ein SLA mit Verfügbarkeitszusagen. Den Echtzeit- und historischen Dienststatus können Sie auf unserer Statusseite einsehen, die über die Fußzeile dieser Website erreichbar ist.
Ist Pexafy DSGVO-konform?
Ja. Wir erheben nur die Mindestdaten, die für den Betrieb des Dienstes erforderlich sind (E-Mail-Adresse, gehashtes Passwort, Nutzungsprotokolle). Wir verkaufen keine Daten an Dritte. Sie können jederzeit einen vollständigen Datenexport oder die Löschung Ihrer Daten über Dashboard → Einstellungen oder per E-Mail an [email protected] beantragen. Weitere Einzelheiten finden Sie in unserer Datenschutzrichtlinie.
Keine Fragen passen zu Ihrer Suche. Versuchen Sie einen anderen Begriff.
Fragen Sie uns direktHaben Sie noch Fragen?
Nicht gefunden, wonach Sie suchen? Unser Team hilft Ihnen gerne.
Support kontaktieren API-Doku lesen