A CometAPI oferece duas formas de verificar o saldo e o uso da conta: o CometAPI CLI e a API do serviço de consulta em query.cometapi.com.
A forma mais rápida de verificar seu saldo pelo terminal. Veja a visão geral do CometAPI CLI para instalação.
Adicione --source token para detalhes por chave:
cometapi balance --source token
API do serviço de consulta
GET https://query.cometapi.com/user/quota
Retorna o saldo em nível de conta, uso acumulado, contagem total de requisições e detalhes de cota por chave. Este endpoint usa um serviço de consulta separado em query.cometapi.com e autentica por meio do 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 seja vazada, ela não poderá ser usada para requisições de modelo.
Parâmetros da requisição
| Parameter | Type | Required | Description |
|---|
key | string | Yes | Sua chave de API da CometAPI |
start_date | string | No | Data inicial para o detalhamento diário (formato YYYY-MM-DD) |
end_date | string | No | Data final para o detalhamento diário (formato YYYY-MM-DD) |
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
| Field | Type | Description |
|---|
username | string | Nome de usuário |
total_quota | number | Saldo atual da conta (USD) |
total_used_quota | number | Uso acumulado (USD) |
request_count | integer | Contagem total de requisições |
keys | array | Detalhes de cota por chave |
keys[].name | string | Nome da chave de API |
keys[].remain_quota | number | Cota restante da chave; -1 significa ilimitada |
keys[].used_quota | number | Cota usada da chave; -1 significa ilimitada |
daily_quota | object | Detalhamento de uso diário (somente quando start_date e end_date estão definidos) |
daily_quota[date] | array | Entradas de uso por chave para essa data |
daily_quota[date][].token_name | string | Nome da chave de API |
daily_quota[date][].quota_used | number | Uso dessa chave nessa data (USD) |
daily_quota[date][].request_count | integer | Contagem de requisições dessa chave nessa data |
Exemplos de código
Consultar saldo da conta:
curl "https://query.cometapi.com/user/quota?key=$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 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"
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
}
]
}
}
