下面的 Python 示例使用请求记录接口。运行前请先在控制台签发带有 usage:read 权限的密钥。示例需要 requests,并从环境变量 XIU_OPEN_API_KEY 读取密钥。它固定查询窗口、逐页读取,对限频和临时故障进行有限重试,并使用 Decimal 计算费用。
python -m pip install requestsimport os
import time
from decimal import Decimal
import requests
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['XIU_OPEN_API_KEY']}"
base_url = "https://api.xiu.ai"
def get_json(path, params):
for attempt in range(5):
try:
response = session.get(
base_url + path, params=params, timeout=(5, 15)
)
except (requests.Timeout, requests.ConnectionError):
if attempt == 4:
raise
time.sleep(2 ** attempt)
continue
if response.status_code == 200:
return response.json()
if response.status_code == 429:
delay = response.json()["retryAfterSeconds"]
elif 500 <= response.status_code < 600:
delay = 2 ** attempt
else:
response.raise_for_status()
raise RuntimeError(f"Unexpected HTTP {response.status_code}")
if attempt == 4:
response.raise_for_status()
time.sleep(delay)
def iter_requests(start_time, end_time):
params = {"startTime": start_time, "endTime": end_time, "limit": 100}
while True:
page = get_json("/open/v1/requests", params)
yield from page["items"]
if page["nextCursor"] is None:
return
params["cursor"] = page["nextCursor"]
end_time = int(time.time())
start_time = end_time - 86400
total = Decimal("0")
seen = set()
for item in iter_requests(start_time, end_time):
if item["id"] in seen:
continue
seen.add(item["id"])
total += Decimal(item["cost"])
print(f"{total:.6f} USD")定期任务应把记录和同步进度持久化,避免进程重启后丢失去重信息。收到 400、401 或 403 时先修复参数、密钥或权限,不要持续重试。