Endpoints

Estado de la cuenta

Devuelve el saldo de créditos y la suscripción de la cuenta ligada a tu clave API. Solo lectura: no se cobra nada.

GET/api/v1/accountGratis

Es el endpoint que conviene llamar antes de una tanda de generaciones, o al despertar un flujo programado: en una sola ida y vuelta sabes cuánto te queda y si tu suscripción sigue en pie. Sin parámetros y sin cuerpo de petición — solo tu clave decide lo que se devuelve.

El único endpoint disponible con 0 créditos

Las tres rutas de producción responden 402 en cuanto el saldo llega a cero. Esta sigue abierta: el endpoint que anuncia «no te quedan créditos» no serviría de nada si fuera el primero en cerrarse.

Cabeceras

Cabeceras de la petición

Parámetro	Tipo	Obligatorio	Descripción
`Authorization`	`string`	Obligatorio	Tu clave API, precedida de `Bearer`. Una clave ausente, desconocida o revocada devuelve un `401`.

Ejemplo

cURL

curl -s https://subreply.io/api/v1/account \
  -H "Authorization: Bearer sr_live_TU_CLAVE_API"

Respuesta 200

{
  "credits": {
    "monthly_remaining": 320,
    "purchased_remaining": 150,
    "total_remaining": 470
  },
  "subscription": {
    "status": "active",
    "plan": "starter"
  }
}

Cuenta sin suscripción

{
  "credits": {
    "monthly_remaining": 0,
    "purchased_remaining": 0,
    "total_remaining": 0
  },
  "subscription": {
    "status": "none",
    "plan": null
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
`credits.monthly_remaining`	number	Créditos del mes en curso todavía disponibles. Se renuevan en cada periodo de suscripción y no se acumulan.
`credits.purchased_remaining`	number	Créditos comprados por unidad todavía disponibles. No caducan.
`credits.total_remaining`	number	La suma de ambos. Es el total que las rutas de producción comparan con el coste de una llamada.
`subscription.status`	string	Estado de la suscripción (ver la tabla siguiente).
`subscription.plan`	string \| null	Nombre del plan, o null si la cuenta nunca se suscribió. Hoy solo existe un plan.

La respuesta no lleva correo electrónico, ni identificador de Stripe, ni identificador de cuenta: una clave API dice lo que puede hacer, no quién la tiene.

Estados de suscripción

Estado	Qué significa
`active`	Suscripción de pago en curso.
`past_due`	Un pago ha fallado. La suscripción aún no está cancelada, pero hay que actualizar el medio de pago.
`canceled`	Suscripción cancelada. Los créditos comprados siguen siendo utilizables, los mensuales ya no se renuevan.
`none`	Esta cuenta nunca se ha suscrito.

Errores

Solo dos casos: 401 si la clave falta o no es válida, y 503 si el saldo no se ha podido leer. Un 503 no significa «cuenta vacía» sino «saldo no disponible»: reinténtalo en vez de sacar conclusiones. El detalle está en la página códigos de error.