--- title: "用 Python 同步账户请求记录" description: "使用服务端 Python 脚本分页同步 XiuAI 请求记录,对临时故障有限重试并精确计算费用。" image: "https://docs.xiu.ai/og.png" --- > XiuAI 文档索引 > 完整文档索引:https://docs.xiu.ai/llms.txt > 阅读前先通过索引确认当前可用页面。 # 用 Python 同步账户请求记录 下面的 Python 示例使用[请求记录接口](/open-api/requests/)。运行前请先在控制台[签发](/open-api/#获取密钥)带有 `usage:read` 权限的密钥。示例需要 `requests`,并从环境变量 `XIU_OPEN_API_KEY` 读取密钥。它固定查询窗口、逐页读取,对限频和临时故障进行有限重试,并使用 `Decimal` 计算费用。 ```bash python -m pip install requests ``` ```python import 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` 时先修复参数、密钥或权限,不要持续重试。 源文件:https://docs.xiu.ai/open-api/examples/index.mdx