API 规范
查询余额
查询当前鉴权账户剩余的 API credits。
查询当前账户剩余的 API credits。
Authorization
bearer AuthorizationBearer <token>
In: header
Query Parameters
usage_page?integer
One-based usage history page. When provided, the response includes up to 20 usage records.
Response Body
application/json
curl -X GET "https://example.com/api/v2/check_balance"{ "balance": 10, "usage": [ { "time": "2026-08-05T08:30:00.000Z", "item": "api_generation_rodin", "amount": 5, "task_uuid": "123e4567-e89b-12d3-a456-426614174000" } ]}用量记录
未传入 usage_page 时，响应中不包含 usage。
示例
curl --fail-with-body 'https://api.hyper3d.com/api/v2/check_balance?usage_page=1' \
--header "Authorization: Bearer ${RODIN_API_KEY}"
import os
import requests
response = requests.get(
"https://api.hyper3d.com/api/v2/check_balance",
headers={"Authorization": f"Bearer {os.environ['RODIN_API_KEY']}"},
params={"usage_page": 1},
timeout=30,
)
response.raise_for_status()
print(response.json())
响应
{
"balance": 10,
"usage": [
{
"time": "2026-08-05T08:30:00.000Z",
"item": "api_generation_rodin",
"amount": 5,
"task_uuid": "123e4567-e89b-12d3-a456-426614174000"
}
]
}