Per iniziare

Autenticazione

Ogni richiesta all'API Pedra si autentica con una chiave API passata nel corpo JSON.

Ottenere una chiave API

  1. Registrati su app.pedra.ai.
  2. Apri Impostazioni → API.
  3. Copia la tua chiave. Ha una lunga durata ed è legata al tuo account.

Per quote più alte, capacità dedicata o prezzi enterprise, scrivi a felix@pedra.ai.

Usare la chiave

Passa la chiave come apiKey nel corpo JSON di ogni richiesta. Non c'è autenticazione tramite header, flusso OAuth o refresh del token — le chiavi sono di lunga durata e legate al tuo account.

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

Mantenere la chiave al sicuro

  • Non distribuire mai chiavi nel codice client. Le chiamate devono partire dal tuo backend. Una chiave incorporata in un bundle browser o in un'app mobile è di fatto pubblica.
  • Memorizza le chiavi come variabili d'ambiente. Non nel controllo versione.
  • Ruota immediatamente se viene divulgata. Scrivici — revocheremo la vecchia e ne emetteremo una nuova.

Errori

Le chiavi mancanti o non valide restituiscono HTTP 404 con {"error": "User not found"} — Pedra cerca la chiave come record utente, quindi una chiave sconosciuta appare come utente mancante. Vedi Errori e limiti per l'elenco completo dei modi di errore.