Créditos

Consulta el saldo de créditos restante de tu cuenta. Una llamada de solo lectura que nunca descuenta créditos.

Devuelve el saldo de créditos de la cuenta asociada a tu clave API. Es una consulta de solo lectura — nunca descuenta créditos. Úsala para mostrar la cuota restante en tu panel o para controlar las llamadas antes de gastar créditos.

Endpoint

Pasa tu apiKey en el cuerpo JSON como en cualquier otro endpoint o — al ser una consulta de solo lectura — como parámetro de query en una petición GET: GET /api/credits?apiKey=YOUR_API_KEY.

curl -X POST https://app.pedra.ai/api/credits \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY"
  }'

# Or, since it's read-only, a simple GET:
curl "https://app.pedra.ai/api/credits?apiKey=YOUR_API_KEY"

Respuesta

Devuelve 200 con el saldo actual:

{
  "plan": "pro",
  "creditsRemaining": 87
}

Campos de la respuesta

• plan — el plan de tu cuenta: free o pro.
• creditsRemaining — créditos aún disponibles para generaciones. Coincide con el saldo mostrado en el editor de Pedra.

Cómo se gastan los créditos

Cada operación descuenta un número fijo de créditos — las llamadas de imagen cuestan 1–2 y los frames de vídeo animados 5 cada uno (los frames estáticos son gratis). Consulta Precios para el desglose completo y Errores y límites para saber qué ocurre cuando se agotan.