Consultar saldo y uso

CometAPI ofrece dos formas de comprobar el saldo y el uso de la cuenta: la CLI de CometAPI y la API del servicio de consulta en query.cometapi.com. Si usas un Workspace, consulta Administrar un equipo con CometAPI Workspace para comprender los Organization Credits compartidos y los roles de facturación.

CometAPI CLI

Consulta tu saldo desde la terminal con un solo comando. Consulta la descripción general de la CLI de CometAPI 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 consulta

GET https://query.cometapi.com/user/quota Devuelve el saldo a nivel de cuenta, el uso acumulado, el conteo total de solicitudes y los detalles de cuota por clave. Este endpoint usa un servicio de consulta independiente en query.cometapi.com y se autentica mediante el parámetro de consulta key en lugar de un Bearer Token.

Usa una API key dedicada para las consultas de saldo. Si quieres limitar la exposición, desactiva Unlimited Quota y establece el límite de crédito positivo más pequeño permitido por el panel.

Parámetros de la solicitud

Parameter	Type	Required	Description
`key`	string	Yes	Tu API key de CometAPI
`start_date`	string	No	Fecha de inicio para el desglose diario (formato `YYYY-MM-DD`)
`end_date`	string	No	Fecha 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

Field	Type	Description
`username`	string	Nombre de usuario
`total_quota`	number	Saldo actual de la cuenta (USD)
`total_used_quota`	number	Uso acumulado (USD)
`request_count`	integer	Conteo total de solicitudes
`keys`	array	Detalles de cuota por clave
`keys[].name`	string	Nombre de la API key
`keys[].remain_quota`	number	Cuota restante de la clave; `-1` significa ilimitada
`keys[].used_quota`	number	Cuota usada de la clave; `-1` significa ilimitada
`daily_quota`	object	Desglose de uso diario (solo cuando `start_date` y `end_date` están establecidos)
`daily_quota[date]`	array	Entradas de uso por clave para esa fecha
`daily_quota[date][].token_name`	string	Nombre de la API key
`daily_quota[date][].quota_used`	number	Uso de esa clave en esa fecha (USD)
`daily_quota[date][].request_count`	integer	Conteo 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=$COMETAPI_KEY"

import os
import requests

resp = requests.get(
    "https://query.cometapi.com/user/quota",
    params={"key": os.environ["COMETAPI_KEY"]}
)
data = resp.json()
print(f"Balance: ${data['total_quota']:.2f}")
print(f"Used: ${data['total_used_quota']:.2f}")
print(f"Requests: {data['request_count']}")

const resp = await fetch(
  `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`
);
const data = await resp.json();
console.log(`Balance: $${data.total_quota.toFixed(2)}`);
console.log(`Used: $${data.total_used_quota.toFixed(2)}`);
console.log(`Requests: ${data.request_count}`);

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 más 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
      }
    ]
  }
}

Empieza aquí

Guías rápidas de la API de modelos

Guías principales de la API

Bibliotecas

Errores

Precios y facturación

Soporte

CometAPI CLI

API del servicio de consulta

Parámetros de la solicitud

Campos de la respuesta

Ejemplos de código

Ejemplo de respuesta

Ejemplo de desglose diario

​CometAPI CLI

​API del servicio de consulta

​Parámetros de la solicitud

​Campos de la respuesta

​Ejemplos de código

​Ejemplo de respuesta

​Ejemplo de desglose diario

CometAPI CLI

API del servicio de consulta

Parámetros de la solicitud

Campos de la respuesta

Ejemplos de código

Ejemplo de respuesta

Ejemplo de desglose diario