账户与余额

每一次调用都会从账户余额中扣费。以下两个接口用于查询余额，以及确认当前正在使用哪一把 API Key。

查询余额

GET /v1/balance

curl -X GET "https://api.zelnum.com/api/v1/balance" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "balance": "5.230000"
}

字段	类型	说明
`balance`	string	可用余额，单位为 USD，固定 6 位小数。

查看当前 API Key

GET /v1/api-key

curl -X GET "https://api.zelnum.com/api/v1/api-key" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "api_key_id": 12,
  "masked_key": "ck_xxxxxxxxx…****",
  "last_used": "2026-09-12T09:14:03.000000Z",
  "created_at": "2026-08-30T11:02:44.000000Z"
}

字段	类型	说明
`api_key_id`	integer	密钥编号，联系客服时提供该值。
`masked_key`	string	脱敏后的前缀，完整密钥不会在此返回。
`last_used`	string \| null	该密钥最近被使用的时间；该字段最多每五分钟写入一次 —— 见安全。
`created_at`	string	密钥创建时间。

该接口报的是账号上最近签发的启用密钥，不是一份清单。一个账号可以同时持有多把启用密钥；控制台会列出全部 —— 轮换方式见安全。

若账号下没有可用密钥：

{
  "api_key": null,
  "message": "No API key found. Please regenerate."
}

错误

状态码	`code`	原因
`401`	`unauthorized`	密钥缺失、无效或已停用。
`403`	`account_banned`	账号已被封禁。
`429`	—	触发限流，详见限流规则。

两个接口共用通用限流桶：每个 API Key 60 次 / 分钟。