Commencer

Authentification

Chaque requête à l'API Pedra s'authentifie avec une clé API passée dans le corps JSON.

Obtenir une clé API

  1. Inscrivez-vous sur app.pedra.ai.
  2. Ouvrez Paramètres → API.
  3. Copiez votre clé. Elle a une longue durée de vie et est liée à votre compte.

Pour des quotas plus élevés, une capacité dédiée ou des tarifs enterprise, écrivez à felix@pedra.ai.

Utiliser la clé

Passez la clé sous apiKey dans le corps JSON de chaque requête. Il n'y a pas d'authentification par en-tête, de flux OAuth ni de refresh de token — les clés ont une longue durée de vie et sont liées à votre compte.

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"
  }'

Garder votre clé en sécurité

  • Ne déployez jamais de clés dans le code côté client. Les appels doivent provenir de votre backend. Une clé intégrée à un bundle navigateur ou une app mobile est effectivement publique.
  • Stockez les clés comme variables d'environnement. Pas dans le contrôle de version.
  • Faites tourner la clé immédiatement en cas de fuite. Écrivez-nous — nous révoquerons l'ancienne et en émettrons une nouvelle.

Erreurs

Les clés manquantes ou invalides renvoient HTTP 404 avec {"error": "User not found"} — Pedra recherche la clé comme un enregistrement utilisateur, donc une clé inconnue apparaît comme un utilisateur inexistant. Voir Erreurs et limites pour la liste complète des modes d'échec.