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 kostenlos nutzbare Bilder aus 9 Quellen – Unsplash, Pexels, Pixabay, Kaboompics, Burst und mehr – in einer einzigen API bündelt. Eine Pexafy-Anfrage = eine semantische Suche über alle 9 Quellen gleichzeitig. Mit den eigenen APIs der Anbieter erfordert dieselbe Suche 3 bis 5 Aufrufe, dazu die Zusammenführungslogik und die JSON-Normalisierung: Code, den Sie schreiben, pflegen und bezahlen.

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 5K API-Anfragen pro Monat.

Muss meine Anwendung genehmigt werden?

Nein. Ihr Schlüssel funktioniert beim allerersten Aufruf: keine Antragsüberprüfung, keine Wartezeit und kein obligatorischer Download-Tracking-Aufruf bei jedem Download. Unsplash begrenzt nicht genehmigte Anwendungen auf 50 Anfragen/Stunde, bis die App überprüft wird; Pexels erlaubt 200/Stunde.

Ist Pexafy kostenlos nutzbar?

Ja! Unser Free-Plan bietet Ihnen 5K API-Anfragen pro Monat – ohne Kreditkarte – und durchsucht wie jeder andere Plan alle Quellen, die Pexafy indexiert. Sie brauchen mehr Anfragen? Die kostenpflichtigen Pläne von Starter bis Enterprise erhöhen die Limits: siehe unsere Preisseite.

Welche Bildquellen durchsucht Pexafy?

Pexafy bündelt derzeit 9 Quellen, die größten davon sind Unsplash, Pexels, Pixabay, Kaboompics, Burst. Wir fügen kontinuierlich weitere 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, wechseln Sie Ihren Plan jederzeit unter Dashboard → Abrechnung. Die Änderung gilt sofort, und Creem, unser Wiederverkäufer, rechnet sie anteilig ab: Beim Wechsel zu einem höheren Plan wird der Preisunterschied für den Rest Ihres aktuellen Zeitraums berechnet, beim Wechsel zu einem niedrigeren Plan wird er erstattet.

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. Creem, unser Wiederverkäufer, erstattet den Betrag auf Ihr ursprüngliches Zahlungsmittel. Details in unserer Rückerstattungsrichtlinie: pexafy.com/legal/refund/

Welche Zahlungsmethoden akzeptieren Sie?

Zahlungen werden von Creem abgewickelt, unserem Wiederverkäufer und Merchant of Record. Sie können per Kredit- oder Debitkarte bezahlen oder mit den anderen Zahlungsarten, die Creem beim Bezahlvorgang in Ihrem Land anbietet. Wir sehen und speichern Ihre Kartendaten nie.

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 bis zu 18 %: Pro kostet $199/Jahr ($17/Monat) statt $19/Monat. Business kostet $2599/Jahr ($217/Monat) statt $249/Monat. Wechseln Sie über Dashboard → Abrechnung zur Jahreszahlung.

Bieten Sie individuelle Enterprise-Pläne an?

Ja! Wenn Ihre Anforderungen den Enterprise-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, und Creem, unser Wiederverkäufer, berechnet sie in USD. Je nach Land können beim Bezahlen Steuern wie die Mehrwertsteuer hinzukommen. Lautet Ihre Karte auf eine andere Währung, rechnet Ihre Bank den Betrag um und erhebt möglicherweise eine kleine Fremdwährungsgebühr.

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 jeweiligen Quelllizenz ab. Unsplash, Pexels und Pixabay bieten für die meisten ihrer Bilder kostenlose kommerzielle Nutzungslizenzen an, und die kleineren Quellen, die wir indexieren, folgen demselben Modell. Prüfen Sie stets das Lizenzfeld in der API-Antwort und verifizieren Sie die Quell-URL, bevor Sie ein Bild kommerziell verwenden.

Bezahle ich für die Bilder?

Nein. Pexafy verkauft keine Bilder. Jedes Ergebnis stammt aus einer frei nutzbaren Bibliothek – Unsplash, Pexels, Pixabay, Kaboompics, Burst und weitere – und verweist auf sie zurück, unter der eigenen Lizenz dieser Bibliothek. Ihr Plan bezahlt nur den Suchdienst: API-Anfragen, Ratenlimits, API-Schlüssel und Support. Prüfen Sie die Lizenz jedes Bildes an der Quelle, bevor Sie es verwenden.

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. Sie können 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 9M+ 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.

Haben Sie noch Fragen?

Nicht gefunden, wonach Sie suchen? Unser Team hilft Ihnen gerne.

Support kontaktieren API-Doku lesen

Über Pexafy Blog