Começar

Autenticação

Cada pedido à API Pedra autentica-se com uma chave API passada no corpo JSON.

Obter uma chave API

  1. Regista-te em app.pedra.ai.
  2. Abre Definições → API.
  3. Copia a tua chave. Tem longa duração e está associada à tua conta.

Para quotas mais altas, capacidade dedicada ou preços enterprise, envia email para felix@pedra.ai.

Usar a chave

Passa a chave como apiKey no corpo JSON de cada pedido. Não há autenticação por cabeçalho, fluxo OAuth ou refresh de token — as chaves têm longa duração e estão associadas à tua conta.

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

Manter a tua chave segura

  • Nunca incluas chaves no código do cliente. As chamadas devem partir do teu backend. Uma chave embebida num bundle do navegador ou app móvel é praticamente pública.
  • Guarda as chaves como variáveis de ambiente. Não no controlo de versões.
  • Roda imediatamente se for divulgada. Envia-nos email — revogamos a antiga e emitimos uma nova.

Erros

Chaves em falta ou inválidas devolvem HTTP 404 com {"error": "User not found"} — a Pedra procura a chave como registo de utilizador, por isso uma chave desconhecida aparece como utilizador em falta. Ver Erros e limites para a lista completa de modos de falha.