Erste Schritte

Authentifizierung

Jede Anfrage an die Pedra-API authentifiziert sich mit einem API-Schlüssel im JSON-Body.

API-Schlüssel erhalten

  1. Registrieren Sie sich auf app.pedra.ai.
  2. Öffnen Sie Einstellungen → API.
  3. Kopieren Sie Ihren Schlüssel. Er ist langlebig und an Ihr Konto gebunden.

Für höhere Quoten, dedizierte Kapazität oder Enterprise-Preise senden Sie eine E-Mail an felix@pedra.ai.

Schlüssel verwenden

Übergeben Sie den Schlüssel als apiKey im JSON-Request-Body für jeden Endpunkt. Es gibt keine Header-basierte Authentifizierung, keinen OAuth-Flow und kein Token-Refresh — Schlüssel sind langlebig und an Ihr Konto gebunden.

curl -X POST https://app.pedra.ai/api/enhance \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "imageUrl": "https://example.com/photo.jpg"
  }'

Schlüssel sicher aufbewahren

  • Verteilen Sie Schlüssel niemals im Client-Code. Aufrufe müssen von Ihrem Backend ausgehen. Ein in einen Browser-Bundle oder eine Mobile-App eingebetteter Schlüssel ist faktisch öffentlich.
  • Speichern Sie Schlüssel als Umgebungsvariablen. Nicht im Versionskontrollsystem.
  • Rotieren Sie sofort bei Leak. Schreiben Sie uns — wir widerrufen den alten Schlüssel und stellen einen neuen aus.

Fehler

Fehlende oder ungültige Schlüssel geben HTTP 404 mit {"error": "User not found"} zurück — Pedra sucht den Schlüssel als Benutzer-Datensatz, daher erscheint ein unbekannter Schlüssel als fehlender Benutzer. Siehe Fehler und Limits für die vollständige Liste der Fehlermodi.