> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Información del usuario actual

> Obtener la información del usuario actual y el saldo de la cuenta

Este endpoint se utiliza para consultar la información básica y el saldo del usuario que tiene la sesión iniciada actualmente.

## Parámetros de la solicitud

### Cabeceras de la solicitud (headers)

<ResponseField type="string" required>
  Autenticación de la solicitud. Esta API utiliza la Manage Key de AIHubMix para autenticarse.
</ResponseField>

<ResponseField type="string">
  Tipo de contenido de la solicitud. Este parámetro debe establecerse como application/json.
</ResponseField>

## Parámetros de la respuesta

<ResponseField name="data" type="object">
  Objeto con la información del usuario, incluye el perfil básico, el saldo y la configuración de alertas.

  <ResponseField name="username" type="string">
    Nombre de usuario.
  </ResponseField>

  <ResponseField name="display_name" type="string">
    Nombre para mostrar del usuario.
  </ResponseField>

  <ResponseField name="role" type="integer">
    Identificador de rol del usuario (un valor mayor implica más privilegios, p. ej. administrador).
  </ResponseField>

  <ResponseField name="status" type="integer">
    Estado de la cuenta (1 significa normal).
  </ResponseField>

  <ResponseField name="email" type="string">
    Correo electrónico.
  </ResponseField>

  <ResponseField name="quota" type="integer">
    Saldo de la cuenta; el importe real (USD) es: quota / 500000.
  </ResponseField>

  <ResponseField name="used_quota" type="integer">
    Saldo utilizado; el importe real (USD) es: used\_quota / 500000.
  </ResponseField>

  <ResponseField name="request_count" type="integer">
    Número total de solicitudes.
  </ResponseField>

  <ResponseField name="group" type="string">
    Grupo de la cuenta.
  </ResponseField>

  <ResponseField name="aff_code" type="string">
    Código de invitación.
  </ResponseField>

  <ResponseField name="notify" type="boolean">
    Si se reciben alertas de saldo bajo.
  </ResponseField>

  <ResponseField name="quota_remind_threshold" type="integer">
    Recibir alertas por correo cuando el saldo baje de quota\_remind\_threshold / 500000.
  </ResponseField>

  <ResponseField name="notify_email" type="string">
    Dirección de correo que recibe las alertas.
  </ResponseField>

  <ResponseField name="ext" type="string">
    Campo de extensión (reservado, normalmente una cadena vacía).
  </ResponseField>
</ResponseField>

<ResponseField name="message" type="string">
  Información detallada sobre el fallo de la solicitud. Este parámetro no se devuelve si la solicitud se completa correctamente.
</ResponseField>

<ResponseField name="success" type="boolean">
  Indica si la operación se realizó con éxito.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "username": "your_name",
      "display_name": "your_name",
      "role": 1,
      "status": 1,
      "email": "you@example.com",
      "quota": 29071257,
      "used_quota": 286403484,
      "request_count": 614422,
      "group": "default",
      "aff_code": "XXXX",
      "notify": true,
      "quota_remind_threshold": 10000000,
      "notify_email": "you@example.com",
      "ext": ""
    },
    "message": "",
    "success": true
  }
  ```
</ResponseExample>

***

Última actualización: 2026-06-26