Empezar

Autenticación

Cada petición a la API de Pedra se autentica con una clave API enviada en el cuerpo JSON.

Conseguir una clave API

  1. Regístrate en app.pedra.ai.
  2. Abre Ajustes → API.
  3. Copia tu clave. Es de larga duración y está vinculada a tu cuenta.

Para mayores cuotas, capacidad dedicada o precios enterprise, escribe a felix@pedra.ai.

Usar la clave

Pasa la clave como apiKey en el cuerpo JSON de cada petición. No hay autenticación por cabecera, flujo OAuth ni refresh de token — las claves son de larga duración y están vinculadas a tu cuenta.

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

Mantener tu clave segura

  • Nunca incluyas claves en código de cliente. Las llamadas deben originarse desde tu backend. Una clave incrustada en un bundle del navegador o una app móvil es prácticamente pública.
  • Guarda las claves como variables de entorno. No en el control de versiones.
  • Rota la clave inmediatamente si se filtra. Escríbenos — revocaremos la antigua y emitiremos una nueva.

Errores

Las claves faltantes o inválidas devuelven HTTP 404 con {"error": "User not found"} — Pedra busca la clave como un registro de usuario, así que una clave desconocida aparece como un usuario inexistente. Consulta Errores y límites para la lista completa de modos de fallo.