GET /me | ZUI GEN API Docs

GET/api/v1/me

Obtiene informacion del usuario autenticado, incluyendo creditos disponibles, suscripcion activa y estadisticas de uso de la API Key.

Ejemplo de Request

curl https://gen.zui.es/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200 OKjson

{
  "user": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "usuario@ejemplo.com",
    "name": "Juan Garcia"
  },
  "credits": {
    "balance": 500,
    "used_this_key": 150
  },
  "subscription": {
    "status": "active",
    "plan": "Pro",
    "credits_per_month": 1000,
    "billing_interval": "month",
    "current_period_end": "2025-02-01T00:00:00Z",
    "cancel_at_period_end": false
  },
  "api_key": {
    "id": "key_abc123",
    "name": "Production Key",
    "requests_count": 542
  }
}

Campos de Respuesta

Objeto User

Campo	Tipo	Descripcion
`id`	string	UUID del usuario
`email`	string	Email del usuario
`name`	string \| null	Nombre completo del usuario

Objeto Credits

Campo	Tipo	Descripcion
`balance`	number	Creditos disponibles actualmente
`used_this_key`	number	Creditos consumidos con esta API Key

Objeto Subscription

Campo	Tipo	Descripcion
`status`	string	"active", "canceled", "past_due"
`plan`	string	Nombre del plan (Starter, Pro, Enterprise)
`credits_per_month`	number	Creditos incluidos en el plan mensualmente
`billing_interval`	string	"month" o "year"
`current_period_end`	string	Fecha de fin del periodo actual (ISO 8601)
`cancel_at_period_end`	boolean	Si esta programada la cancelacion

Objeto API Key

Campo	Tipo	Descripcion
`id`	string	ID de la API Key usada
`name`	string	Nombre asignado a la API Key
`requests_count`	number	Total de peticiones realizadas con esta key

Casos de Uso

Verificar que tu API Key es valida
Mostrar el saldo de creditos al usuario
Comprobar el estado de la suscripcion
Monitorizar el uso de la API Key

Nota

Si el usuario no tiene una suscripcion activa, el campo subscription sera null. En este caso, no podra realizar generaciones hasta activar un plan.