Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
使用 CometAPI CLI 或查询服务 API 获取账户余额、用量以及按 key 统计的配额详情。
query.cometapi.com 的 query service API。
如果您使用 Workspace，请参阅 使用 CometAPI Workspace 管理团队，了解共享组织额度和计费角色。
cometapi balance
--source token 可查看按 key 统计的详情：
cometapi balance --source token
GET https://query.cometapi.com/user/quota
返回账户级余额、累计用量、总请求次数以及每个 key 的配额详情。该端点使用位于 query.cometapi.com 的独立查询服务，并通过查询参数 key 进行身份验证，而不是使用 Bearer Token。
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | Yes | 你的 CometAPI API key |
start_date | string | No | 每日明细的开始日期（YYYY-MM-DD 格式） |
end_date | string | No | 每日明细的结束日期（YYYY-MM-DD 格式） |
start_date 和 end_date 时，响应会包含 daily_quota 字段，按天提供每个 key 的用量明细。
| Field | Type | Description |
|---|---|---|
username | string | 用户名 |
total_quota | number | 当前账户余额（USD） |
total_used_quota | number | 累计用量（USD） |
request_count | integer | 总请求次数 |
keys | array | 每个 key 的配额详情 |
keys[].name | string | API key 名称 |
keys[].remain_quota | number | key 剩余配额；-1 表示无限制 |
keys[].used_quota | number | key 已用配额；-1 表示无限制 |
daily_quota | object | 每日用量明细（仅当设置了 start_date 和 end_date 时返回） |
daily_quota[date] | array | 该日期下每个 key 的用量条目 |
daily_quota[date][].token_name | string | API key 名称 |
daily_quota[date][].quota_used | number | 该 key 在该日期的用量（USD） |
daily_quota[date][].request_count | integer | 该 key 在该日期的请求次数 |
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}`);
{
"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
}
]
}
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
}
]
}
}