Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

CometAPI ofrece dos formas de consultar el saldo y el uso de la cuenta: la CLI de CometAPI y la API del servicio de consultas en query.cometapi.com.

​
CometAPI CLI

La forma más rápida de consultar tu saldo desde la terminal. Consulta la descripción general de CometAPI CLI para la instalación. 
cometapi balance
Agrega --source token para ver detalles por clave: 
cometapi balance --source token
Consulta la referencia de comandos para ver todas las opciones disponibles.

​
API del servicio de consultas

GET https://query.cometapi.com/user/quota Devuelve el saldo a nivel de cuenta, el uso acumulado, el número total de solicitudes y los detalles de cuota por clave. Este endpoint usa un servicio de consultas independiente en query.cometapi.com y se autentica mediante el parámetro de consulta key en lugar de un Bearer Token.
Genera una API key dedicada para las consultas de saldo y establece su cuota en 0 (permiso solo de consulta). Incluso si la clave se filtra, no se puede usar para solicitudes de modelos.

​
Parámetros de la solicitud

ParameterTypeRequiredDescription
keystringYesTu API key de CometAPI
start_datestringNoFecha de inicio para el desglose diario (formato YYYY-MM-DD)
end_datestringNoFecha de fin para el desglose diario (formato YYYY-MM-DD)
Cuando se proporcionan start_date y end_date, la respuesta incluye un campo daily_quota con el uso por clave desglosado por día.

​
Campos de la respuesta

FieldTypeDescription
usernamestringNombre de usuario
total_quotanumberSaldo actual de la cuenta (USD)
total_used_quotanumberUso acumulado (USD)
request_countintegerNúmero total de solicitudes
keysarrayDetalles de cuota por clave
keys[].namestringNombre de la API key
keys[].remain_quotanumberCuota restante de la clave; -1 significa ilimitada
keys[].used_quotanumberCuota usada de la clave; -1 significa ilimitada
daily_quotaobjectDesglose de uso diario (solo cuando se establecen start_date y end_date)
daily_quota[date]arrayEntradas de uso por clave para esa fecha
daily_quota[date][].token_namestringNombre de la API key
daily_quota[date][].quota_usednumberUso de esa clave en esa fecha (USD)
daily_quota[date][].request_countintegerNúmero de solicitudes de esa clave en esa fecha

​
Ejemplos de código

Consultar el saldo de la cuenta: 
curl `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`

​
Ejemplo de respuesta

{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "keys": [
    {
      "name": "my-key",
      "remain_quota": 8.94,
      "used_quota": 2.10
    }
  ]
}

​
Ejemplo de desglose diario

Consultar el uso diario para un rango de fechas: 
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
La respuesta incluye los mismos campos de nivel superior además de daily_quota: 
{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "daily_quota": {
    "2026-04-13T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 4.27,
        "request_count": 59
      }
    ],
    "2026-04-14T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 0.57,
        "request_count": 36
      }
    ]
  }
}