Saltar para o conteúdo 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.

A CometAPI oferece duas formas de verificar o saldo e o uso da conta: a CometAPI CLI e a API do serviço de consulta em query.cometapi.com.

​
CometAPI CLI

A forma mais rápida de verificar seu saldo pelo terminal. Consulte a visão geral da CometAPI CLI para instalação. 
cometapi balance
Adicione --source token para detalhes por chave: 
cometapi balance --source token
Consulte a referência de comandos para todas as opções disponíveis.

​
API do serviço de consulta

GET https://query.cometapi.com/user/quota Retorna o saldo no nível da conta, uso cumulativo, contagem total de solicitações e detalhes de cota por chave. Este endpoint usa um serviço de consulta separado em query.cometapi.com e autentica via o parâmetro de consulta key, em vez de um Bearer Token.
Gere uma chave de API dedicada para consultas de saldo e defina sua cota como 0 (permissão somente para consulta). Mesmo que a chave vaze, ela não poderá ser usada para solicitações de modelo.

​
Parâmetros da solicitação

ParameterTypeRequiredDescription
keystringYesSua chave de API da CometAPI
start_datestringNoData de início para o detalhamento diário (formato YYYY-MM-DD)
end_datestringNoData de término para o detalhamento diário (formato YYYY-MM-DD)
Quando start_date e end_date são fornecidos, a resposta inclui um campo daily_quota com o uso por chave detalhado por dia.

​
Campos da resposta

FieldTypeDescription
usernamestringNome de usuário
total_quotanumberSaldo atual da conta (USD)
total_used_quotanumberUso cumulativo (USD)
request_countintegerContagem total de solicitações
keysarrayDetalhes de cota por chave
keys[].namestringNome da chave de API
keys[].remain_quotanumberCota restante da chave; -1 significa ilimitada
keys[].used_quotanumberCota usada da chave; -1 significa ilimitada
daily_quotaobjectDetalhamento de uso diário (somente quando start_date e end_date são definidos)
daily_quota[date]arrayEntradas de uso por chave para essa data
daily_quota[date][].token_namestringNome da chave de API
daily_quota[date][].quota_usednumberUso dessa chave nessa data (USD)
daily_quota[date][].request_countintegerContagem de solicitações dessa chave nessa data

​
Exemplos de código

Consultar o saldo da conta: 
curl `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`

​
Exemplo de resposta

{
  "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
    }
  ]
}

​
Exemplo de detalhamento diário

Consultar o uso diário para um intervalo de datas: 
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
A resposta inclui os mesmos campos de nível superior, além 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
      }
    ]
  }
}