Saldo de Créditos

Name: SRTGen
Rating: 4.9 (10000 reviews)

Consulte su saldo de créditos disponible actualmente para gestionar el uso y evitar fallos en los trabajos.

GET/api/v1/balance

Implementación Rápida

curl -X GET https://api.srtgen.com/api/v1/balance \
  -H "x-api-key: <YOUR_API_KEY>"

GEThttps://api.srtgen.com/api/v1/balance

Este endpoint devuelve el saldo total utilizable, que incluye tanto los créditos mensuales de su suscripción como cualquier crédito adicional que haya comprado.

Estructura de la Respuesta

Parámetro	Tipo	Requerido
Identidad y Contexto
`user`	Objeto	Información básica sobre el usuario autenticado.
`user.name`	Tipo	El nombre de visualización del usuario.
`user.email`	Tipo	La dirección de correo electrónico registrada.
Desglose del Saldo
`credits`	Objeto	Desglose detallado del saldo de créditos.
`credits.totalBalance`	Number	Suma de todos los créditos utilizables (Mensuales + Extra).
`credits.extraCredits`	Number	Créditos adicionales permanentes.
`credits.plans`	Array	Lista de planes de suscripción activos.
`plans[].name`	Tipo	Nombre del plan (ej. 'Plan Pro').
`plans[].status`	Tipo	Estado de la suscripción (active, past_due).
`plans[].balance`	Number	Créditos restantes en este ciclo específico.
Uso de Almacenamiento en la Nube
`storage`	Objeto	Estadísticas de uso de almacenamiento en la nube.
`storage.usage`	Number	Uso actual de almacenamiento en bytes.
`storage.limit`	Number	Límite máximo de almacenamiento en bytes según su plan.
`storage.formattedUsage`	Tipo	Uso en formato legible (ej. '200 MB').
`storage.formattedLimit`	Tipo	Límite en formato legible (ej. '10 GB').

Respuesta de Ejemplo: 200 OK

{
  "success": true,
  "user": {
    "name": "Alex Rivera",
    "email": "[email protected]"
  },
  "credits": {
    "totalBalance": 1250,
    "totalMonthlyCredits": 1000,
    "extraCredits": 250,
    "plans": [
      {
        "id": "starter",
        "name": "Starter Plan",
        "status": "active",
        "balance": 1000,
        "total": 1000,
        "resetTime": "2026-04-29T17:48:46.000Z"
      }
    ]
  },
  "storage": {
    "usage": 209715200,
    "limit": 10737418240,
    "formattedUsage": "200 MB",
    "formattedLimit": "10 GB"
  },
  "updatedAt": "2026-03-29T17:48:46.000Z"
}

Errores

Estado	Código de Error	Descripción
401	unauthorized	La clave de API falta o es inválida.
500	server_error	Ocurrió un error interno inesperado.

¿Fue útil esta página?