uapi-sdk-python 0.1.13__tar.gz → 0.1.14__tar.gz

{uapi_sdk_python-0.1.13 → uapi_sdk_python-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uapi-sdk-python
-Version: 0.1.13
+Version: 0.1.14
 Summary: Idiomatic UAPI SDK for Python
 Author-email: UAPI <dev@uapis.cn>
 Requires-Python: >=3.9
@@ -32,11 +32,13 @@ pip install uapi-sdk-python
 ```python
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1")
-result = client.social.get_social_qq_userinfo(qq="10001")
+client = UapiClient("https://uapis.cn", "YOUR_API_KEY")
+result = client.misc.get_misc_hotboard(type="weibo")
 print(result)
 ```
 
+这个接口默认只要传 `type` 就可以拿当前热榜。`time`、`keyword`、`time_start`、`time_end`、`limit`、`sources` 都是按场景再传的可选参数。
+
 > [!TIP]
 > 请使用与运行脚本相同的 Python 解释器安装依赖，例如执行 `python -m pip install uapi-sdk-python` 后再运行 `python main.py`。在 VS Code / Pyright 中若提示 “Import uapi could not be resolved”，将解释器切换到当前虚拟环境即可恢复补全。
 
@@ -54,6 +56,60 @@ print(result)
 
 如果你需要查看字段细节或内部逻辑，仓库中的 `./internal` 目录同步保留了由 `openapi-generator` 生成的完整结构体，随时可供参考。
 
+## 响应元信息
+
+每次请求完成后，SDK 会自动把响应 Header 解析成结构化的 `ResponseMeta`，你不用自己拆原始字符串。
+
+成功时可以通过 `client.last_response_meta` 读取，失败时可以通过 `err.meta` 读取，两条路径拿到的是同一套字段。
+
+```python
+from uapi import UapiClient, UapiError
+
+client = UapiClient("https://uapis.cn", "YOUR_API_KEY")
+
+# 成功路径
+client.social.get_social_qq_userinfo(qq="10001")
+meta = client.last_response_meta
+if meta:
+    print("这次请求原价:", meta.credits_requested or 0, "积分")
+    print("这次实际扣费:", meta.credits_charged or 0, "积分")
+    print("特殊计价:", meta.credits_pricing or "原价")
+    print("余额剩余:", meta.balance_remaining_cents or 0, "分")
+    print("资源包剩余:", meta.quota_remaining_credits or 0, "积分")
+    print("当前有效额度桶:", meta.active_quota_buckets or 0)
+    print("额度用空即停:", meta.stop_on_empty)
+    print("Key QPS:", meta.billing_key_rate_remaining or 0, "/", meta.billing_key_rate_limit or 0, meta.billing_key_rate_unit or "req")
+    print("Request ID:", meta.request_id)
+
+# 失败路径
+try:
+    client.social.get_social_qq_userinfo(qq="10001")
+except UapiError as err:
+    if err.meta:
+        print("Retry-After 秒数:", err.meta.retry_after_seconds)
+        print("Retry-After 原始值:", err.meta.retry_after_raw)
+        print("访客 QPS:", err.meta.visitor_rate_remaining or 0, "/", err.meta.visitor_rate_limit or 0)
+        print("Request ID:", err.meta.request_id)
+```
+
+常用字段一览：
+
+| 字段 | 说明 |
+|------|------|
+| `credits_requested` | 这次请求原本要扣多少积分，也就是请求价 |
+| `credits_charged` | 这次请求实际扣了多少积分 |
+| `credits_pricing` | 特殊计价原因，例如缓存半价 `cache-hit-half-price` |
+| `balance_remaining_cents` | 账户余额剩余（分） |
+| `quota_remaining_credits` | 资源包剩余积分 |
+| `active_quota_buckets` | 当前还有多少个有效额度桶参与计费 |
+| `stop_on_empty` | 额度耗尽后是否直接停止服务 |
+| `retry_after_seconds` / `retry_after_raw` | 限流后的等待时长；当服务端返回 HTTP 时间字符串时看 `retry_after_raw` |
+| `request_id` | 请求唯一 ID，排障时使用 |
+| `billing_key_rate_limit` / `billing_key_rate_remaining` | Billing Key 当前 QPS 规则的上限与剩余 |
+| `billing_ip_rate_limit` / `billing_ip_rate_remaining` | Billing Key 单 IP 当前 QPS 规则的上限与剩余 |
+| `visitor_rate_limit` / `visitor_rate_remaining` | 访客当前 QPS 规则的上限与剩余 |
+| `rate_limit_policies` / `rate_limits` | 完整结构化限流策略数据 |
+
 ## 进阶实践
 
 ### 缓存与幂等
@@ -62,7 +118,7 @@ print(result)
 from functools import lru_cache
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1", token="<TOKEN>")
+client = UapiClient("https://uapis.cn", token="YOUR_API_KEY")
 
 @lru_cache(maxsize=128)
 def cached_lookup(qq: str):
@@ -73,34 +129,19 @@ user = cached_lookup("10001")
 
 也可以在 FastAPI / Django 项目里配合 Redis，将 SDK 的响应序列化后写入缓存，命中即直接返回。
 
-### 注入自定义 httpx.Client
+### 调整超时与环境
 
 ```python
-import httpx
-from httpx import Auth
 from uapi import UapiClient
 
-class StaticToken(Auth):
-    def __init__(self, token: str):
-        self.token = token
-    def auth_flow(self, request):
-        request.headers["Authorization"] = f"Bearer {self.token}"
-        yield request
-
-http_client = httpx.Client(
-    timeout=5,
-    transport=httpx.HTTPTransport(retries=3),
-    event_hooks={"request": [lambda request: print("->", request.url)]},
-)
-
 client = UapiClient(
-    "https://uapis.cn/api/v1",
-    client=http_client,
-    auth=StaticToken("<TOKEN>"),
+    "https://uapis.cn",
+    token="YOUR_API_KEY",
+    timeout=5.0,
 )
 ```
 
-通过自定义 `client` / `transport` / `auth`，可以无缝植入代理、重试策略或 APM 埋点。
+如果你需要切换到别的环境，直接改 `base_url` 就可以；如果你只想缩短等待时间，传 `timeout` 就够了。
 
 ## 错误模型概览
 

{uapi_sdk_python-0.1.13 → uapi_sdk_python-0.1.14}/README.md

@@ -18,11 +18,13 @@ pip install uapi-sdk-python
 ```python
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1")
-result = client.social.get_social_qq_userinfo(qq="10001")
+client = UapiClient("https://uapis.cn", "YOUR_API_KEY")
+result = client.misc.get_misc_hotboard(type="weibo")
 print(result)
 ```
 
+这个接口默认只要传 `type` 就可以拿当前热榜。`time`、`keyword`、`time_start`、`time_end`、`limit`、`sources` 都是按场景再传的可选参数。
+
 > [!TIP]
 > 请使用与运行脚本相同的 Python 解释器安装依赖，例如执行 `python -m pip install uapi-sdk-python` 后再运行 `python main.py`。在 VS Code / Pyright 中若提示 “Import uapi could not be resolved”，将解释器切换到当前虚拟环境即可恢复补全。
 
@@ -40,6 +42,60 @@ print(result)
 
 如果你需要查看字段细节或内部逻辑，仓库中的 `./internal` 目录同步保留了由 `openapi-generator` 生成的完整结构体，随时可供参考。
 
+## 响应元信息
+
+每次请求完成后，SDK 会自动把响应 Header 解析成结构化的 `ResponseMeta`，你不用自己拆原始字符串。
+
+成功时可以通过 `client.last_response_meta` 读取，失败时可以通过 `err.meta` 读取，两条路径拿到的是同一套字段。
+
+```python
+from uapi import UapiClient, UapiError
+
+client = UapiClient("https://uapis.cn", "YOUR_API_KEY")
+
+# 成功路径
+client.social.get_social_qq_userinfo(qq="10001")
+meta = client.last_response_meta
+if meta:
+    print("这次请求原价:", meta.credits_requested or 0, "积分")
+    print("这次实际扣费:", meta.credits_charged or 0, "积分")
+    print("特殊计价:", meta.credits_pricing or "原价")
+    print("余额剩余:", meta.balance_remaining_cents or 0, "分")
+    print("资源包剩余:", meta.quota_remaining_credits or 0, "积分")
+    print("当前有效额度桶:", meta.active_quota_buckets or 0)
+    print("额度用空即停:", meta.stop_on_empty)
+    print("Key QPS:", meta.billing_key_rate_remaining or 0, "/", meta.billing_key_rate_limit or 0, meta.billing_key_rate_unit or "req")
+    print("Request ID:", meta.request_id)
+
+# 失败路径
+try:
+    client.social.get_social_qq_userinfo(qq="10001")
+except UapiError as err:
+    if err.meta:
+        print("Retry-After 秒数:", err.meta.retry_after_seconds)
+        print("Retry-After 原始值:", err.meta.retry_after_raw)
+        print("访客 QPS:", err.meta.visitor_rate_remaining or 0, "/", err.meta.visitor_rate_limit or 0)
+        print("Request ID:", err.meta.request_id)
+```
+
+常用字段一览：
+
+| 字段 | 说明 |
+|------|------|
+| `credits_requested` | 这次请求原本要扣多少积分，也就是请求价 |
+| `credits_charged` | 这次请求实际扣了多少积分 |
+| `credits_pricing` | 特殊计价原因，例如缓存半价 `cache-hit-half-price` |
+| `balance_remaining_cents` | 账户余额剩余（分） |
+| `quota_remaining_credits` | 资源包剩余积分 |
+| `active_quota_buckets` | 当前还有多少个有效额度桶参与计费 |
+| `stop_on_empty` | 额度耗尽后是否直接停止服务 |
+| `retry_after_seconds` / `retry_after_raw` | 限流后的等待时长；当服务端返回 HTTP 时间字符串时看 `retry_after_raw` |
+| `request_id` | 请求唯一 ID，排障时使用 |
+| `billing_key_rate_limit` / `billing_key_rate_remaining` | Billing Key 当前 QPS 规则的上限与剩余 |
+| `billing_ip_rate_limit` / `billing_ip_rate_remaining` | Billing Key 单 IP 当前 QPS 规则的上限与剩余 |
+| `visitor_rate_limit` / `visitor_rate_remaining` | 访客当前 QPS 规则的上限与剩余 |
+| `rate_limit_policies` / `rate_limits` | 完整结构化限流策略数据 |
+
 ## 进阶实践
 
 ### 缓存与幂等
@@ -48,7 +104,7 @@ print(result)
 from functools import lru_cache
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1", token="<TOKEN>")
+client = UapiClient("https://uapis.cn", token="YOUR_API_KEY")
 
 @lru_cache(maxsize=128)
 def cached_lookup(qq: str):
@@ -59,34 +115,19 @@ user = cached_lookup("10001")
 
 也可以在 FastAPI / Django 项目里配合 Redis，将 SDK 的响应序列化后写入缓存，命中即直接返回。
 
-### 注入自定义 httpx.Client
+### 调整超时与环境
 
 ```python
-import httpx
-from httpx import Auth
 from uapi import UapiClient
 
-class StaticToken(Auth):
-    def __init__(self, token: str):
-        self.token = token
-    def auth_flow(self, request):
-        request.headers["Authorization"] = f"Bearer {self.token}"
-        yield request
-
-http_client = httpx.Client(
-    timeout=5,
-    transport=httpx.HTTPTransport(retries=3),
-    event_hooks={"request": [lambda request: print("->", request.url)]},
-)
-
 client = UapiClient(
-    "https://uapis.cn/api/v1",
-    client=http_client,
-    auth=StaticToken("<TOKEN>"),
+    "https://uapis.cn",
+    token="YOUR_API_KEY",
+    timeout=5.0,
 )
 ```
 
-通过自定义 `client` / `transport` / `auth`，可以无缝植入代理、重试策略或 APM 埋点。
+如果你需要切换到别的环境，直接改 `base_url` 就可以；如果你只想缩短等待时间，传 `timeout` 就够了。
 
 ## 错误模型概览
 

{uapi_sdk_python-0.1.13 → uapi_sdk_python-0.1.14}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "uapi-sdk-python"
-version = "0.1.13"
+version = "0.1.14"
 description = "Idiomatic UAPI SDK for Python"
 readme = "README.md"
 requires-python = ">=3.9"

{uapi_sdk_python-0.1.13 → uapi_sdk_python-0.1.14}/uapi/client.py

@@ -12,6 +12,13 @@ class _Config:
     token: Optional[str] = None
     timeout: float = 15.0
 
+
+def _normalize_base_url(base_url: str) -> str:
+    normalized = base_url.rstrip("/")
+    if normalized.endswith("/api/v1"):
+        normalized = normalized[: -len("/api/v1")]
+    return normalized
+
 class _HTTP:
     def __init__(self, cfg: _Config):
         self._cfg = cfg
@@ -43,7 +50,7 @@ class UapiClient:
     """
 
     def __init__(self, base_url: str, token: str | None = None, timeout: float = 15.0):
-        self._http = _HTTP(_Config(base_url, token, timeout))
+        self._http = _HTTP(_Config(_normalize_base_url(base_url), token, timeout))
         # 动态挂载每个 Tag 的 API 门面
         _clipzy_zai_xian_jian_tie_ban = _ClipzyZaiXianJianTieBanApi(self._http)
         self.clipzy_zai_xian_jian_tie_ban = _clipzy_zai_xian_jian_tie_ban
@@ -2608,4 +2615,3 @@ UAPI Pro Search 是一个智能搜索引擎，采用机器学习算法对搜索
         
         return self._http.request("POST", path, params=params, json=body if body else None)
     
-

{uapi_sdk_python-0.1.13 → uapi_sdk_python-0.1.14}/uapi/errors.py

@@ -20,6 +20,7 @@ class RateLimitStateEntry:
 @dataclass
 class ResponseMeta:
     request_id: Optional[str] = None
+    retry_after_raw: Optional[str] = None
     retry_after_seconds: Optional[int] = None
     debit_status: Optional[str] = None
     credits_requested: Optional[int] = None
@@ -37,6 +38,21 @@ class ResponseMeta:
     quota_remaining_credits: Optional[int] = None
     visitor_quota_limit_credits: Optional[int] = None
     visitor_quota_remaining_credits: Optional[int] = None
+    billing_key_rate_limit: Optional[int] = None
+    billing_key_rate_remaining: Optional[int] = None
+    billing_key_rate_unit: Optional[str] = None
+    billing_key_rate_window_seconds: Optional[int] = None
+    billing_key_rate_reset_after_seconds: Optional[int] = None
+    billing_ip_rate_limit: Optional[int] = None
+    billing_ip_rate_remaining: Optional[int] = None
+    billing_ip_rate_unit: Optional[str] = None
+    billing_ip_rate_window_seconds: Optional[int] = None
+    billing_ip_rate_reset_after_seconds: Optional[int] = None
+    visitor_rate_limit: Optional[int] = None
+    visitor_rate_remaining: Optional[int] = None
+    visitor_rate_unit: Optional[str] = None
+    visitor_rate_window_seconds: Optional[int] = None
+    visitor_rate_reset_after_seconds: Optional[int] = None
     raw_headers: Dict[str, str] = field(default_factory=dict)
 
 class UapiError(Exception):
@@ -230,8 +246,16 @@ def extract_meta(headers: Mapping[str, str]) -> ResponseMeta:
             reset_after_seconds=_parse_int(params.get("t")),
         )
 
+    billing_key_rate_policy = rate_limit_policies.get("billing-key-rate")
+    billing_key_rate_state = rate_limits.get("billing-key-rate")
+    billing_ip_rate_policy = rate_limit_policies.get("billing-ip-rate")
+    billing_ip_rate_state = rate_limits.get("billing-ip-rate")
+    visitor_rate_policy = rate_limit_policies.get("visitor-rate")
+    visitor_rate_state = rate_limits.get("visitor-rate")
+
     return ResponseMeta(
         request_id=raw_headers.get("x-request-id"),
+        retry_after_raw=raw_headers.get("retry-after"),
         retry_after_seconds=_parse_int(raw_headers.get("retry-after")),
         debit_status=raw_headers.get("uapi-debit-status"),
         credits_requested=_parse_int(raw_headers.get("uapi-credits-requested")),
@@ -249,6 +273,21 @@ def extract_meta(headers: Mapping[str, str]) -> ResponseMeta:
         quota_remaining_credits=rate_limits.get("billing-quota").remaining if "billing-quota" in rate_limits else None,
         visitor_quota_limit_credits=rate_limit_policies.get("visitor-quota").quota if "visitor-quota" in rate_limit_policies else None,
         visitor_quota_remaining_credits=rate_limits.get("visitor-quota").remaining if "visitor-quota" in rate_limits else None,
+        billing_key_rate_limit=billing_key_rate_policy.quota if billing_key_rate_policy else None,
+        billing_key_rate_remaining=billing_key_rate_state.remaining if billing_key_rate_state else None,
+        billing_key_rate_unit=billing_key_rate_policy.unit if billing_key_rate_policy and billing_key_rate_policy.unit is not None else (billing_key_rate_state.unit if billing_key_rate_state else None),
+        billing_key_rate_window_seconds=billing_key_rate_policy.window_seconds if billing_key_rate_policy else None,
+        billing_key_rate_reset_after_seconds=billing_key_rate_state.reset_after_seconds if billing_key_rate_state else None,
+        billing_ip_rate_limit=billing_ip_rate_policy.quota if billing_ip_rate_policy else None,
+        billing_ip_rate_remaining=billing_ip_rate_state.remaining if billing_ip_rate_state else None,
+        billing_ip_rate_unit=billing_ip_rate_policy.unit if billing_ip_rate_policy and billing_ip_rate_policy.unit is not None else (billing_ip_rate_state.unit if billing_ip_rate_state else None),
+        billing_ip_rate_window_seconds=billing_ip_rate_policy.window_seconds if billing_ip_rate_policy else None,
+        billing_ip_rate_reset_after_seconds=billing_ip_rate_state.reset_after_seconds if billing_ip_rate_state else None,
+        visitor_rate_limit=visitor_rate_policy.quota if visitor_rate_policy else None,
+        visitor_rate_remaining=visitor_rate_state.remaining if visitor_rate_state else None,
+        visitor_rate_unit=visitor_rate_policy.unit if visitor_rate_policy and visitor_rate_policy.unit is not None else (visitor_rate_state.unit if visitor_rate_state else None),
+        visitor_rate_window_seconds=visitor_rate_policy.window_seconds if visitor_rate_policy else None,
+        visitor_rate_reset_after_seconds=visitor_rate_state.reset_after_seconds if visitor_rate_state else None,
         raw_headers=raw_headers,
     )
 

{uapi_sdk_python-0.1.13 → uapi_sdk_python-0.1.14}/uapi_sdk_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uapi-sdk-python
-Version: 0.1.13
+Version: 0.1.14
 Summary: Idiomatic UAPI SDK for Python
 Author-email: UAPI <dev@uapis.cn>
 Requires-Python: >=3.9
@@ -32,11 +32,13 @@ pip install uapi-sdk-python
 ```python
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1")
-result = client.social.get_social_qq_userinfo(qq="10001")
+client = UapiClient("https://uapis.cn", "YOUR_API_KEY")
+result = client.misc.get_misc_hotboard(type="weibo")
 print(result)
 ```
 
+这个接口默认只要传 `type` 就可以拿当前热榜。`time`、`keyword`、`time_start`、`time_end`、`limit`、`sources` 都是按场景再传的可选参数。
+
 > [!TIP]
 > 请使用与运行脚本相同的 Python 解释器安装依赖，例如执行 `python -m pip install uapi-sdk-python` 后再运行 `python main.py`。在 VS Code / Pyright 中若提示 “Import uapi could not be resolved”，将解释器切换到当前虚拟环境即可恢复补全。
 
@@ -54,6 +56,60 @@ print(result)
 
 如果你需要查看字段细节或内部逻辑，仓库中的 `./internal` 目录同步保留了由 `openapi-generator` 生成的完整结构体，随时可供参考。
 
+## 响应元信息
+
+每次请求完成后，SDK 会自动把响应 Header 解析成结构化的 `ResponseMeta`，你不用自己拆原始字符串。
+
+成功时可以通过 `client.last_response_meta` 读取，失败时可以通过 `err.meta` 读取，两条路径拿到的是同一套字段。
+
+```python
+from uapi import UapiClient, UapiError
+
+client = UapiClient("https://uapis.cn", "YOUR_API_KEY")
+
+# 成功路径
+client.social.get_social_qq_userinfo(qq="10001")
+meta = client.last_response_meta
+if meta:
+    print("这次请求原价:", meta.credits_requested or 0, "积分")
+    print("这次实际扣费:", meta.credits_charged or 0, "积分")
+    print("特殊计价:", meta.credits_pricing or "原价")
+    print("余额剩余:", meta.balance_remaining_cents or 0, "分")
+    print("资源包剩余:", meta.quota_remaining_credits or 0, "积分")
+    print("当前有效额度桶:", meta.active_quota_buckets or 0)
+    print("额度用空即停:", meta.stop_on_empty)
+    print("Key QPS:", meta.billing_key_rate_remaining or 0, "/", meta.billing_key_rate_limit or 0, meta.billing_key_rate_unit or "req")
+    print("Request ID:", meta.request_id)
+
+# 失败路径
+try:
+    client.social.get_social_qq_userinfo(qq="10001")
+except UapiError as err:
+    if err.meta:
+        print("Retry-After 秒数:", err.meta.retry_after_seconds)
+        print("Retry-After 原始值:", err.meta.retry_after_raw)
+        print("访客 QPS:", err.meta.visitor_rate_remaining or 0, "/", err.meta.visitor_rate_limit or 0)
+        print("Request ID:", err.meta.request_id)
+```
+
+常用字段一览：
+
+| 字段 | 说明 |
+|------|------|
+| `credits_requested` | 这次请求原本要扣多少积分，也就是请求价 |
+| `credits_charged` | 这次请求实际扣了多少积分 |
+| `credits_pricing` | 特殊计价原因，例如缓存半价 `cache-hit-half-price` |
+| `balance_remaining_cents` | 账户余额剩余（分） |
+| `quota_remaining_credits` | 资源包剩余积分 |
+| `active_quota_buckets` | 当前还有多少个有效额度桶参与计费 |
+| `stop_on_empty` | 额度耗尽后是否直接停止服务 |
+| `retry_after_seconds` / `retry_after_raw` | 限流后的等待时长；当服务端返回 HTTP 时间字符串时看 `retry_after_raw` |
+| `request_id` | 请求唯一 ID，排障时使用 |
+| `billing_key_rate_limit` / `billing_key_rate_remaining` | Billing Key 当前 QPS 规则的上限与剩余 |
+| `billing_ip_rate_limit` / `billing_ip_rate_remaining` | Billing Key 单 IP 当前 QPS 规则的上限与剩余 |
+| `visitor_rate_limit` / `visitor_rate_remaining` | 访客当前 QPS 规则的上限与剩余 |
+| `rate_limit_policies` / `rate_limits` | 完整结构化限流策略数据 |
+
 ## 进阶实践
 
 ### 缓存与幂等
@@ -62,7 +118,7 @@ print(result)
 from functools import lru_cache
 from uapi import UapiClient
 
-client = UapiClient("https://uapis.cn/api/v1", token="<TOKEN>")
+client = UapiClient("https://uapis.cn", token="YOUR_API_KEY")
 
 @lru_cache(maxsize=128)
 def cached_lookup(qq: str):
@@ -73,34 +129,19 @@ user = cached_lookup("10001")
 
 也可以在 FastAPI / Django 项目里配合 Redis，将 SDK 的响应序列化后写入缓存，命中即直接返回。
 
-### 注入自定义 httpx.Client
+### 调整超时与环境
 
 ```python
-import httpx
-from httpx import Auth
 from uapi import UapiClient
 
-class StaticToken(Auth):
-    def __init__(self, token: str):
-        self.token = token
-    def auth_flow(self, request):
-        request.headers["Authorization"] = f"Bearer {self.token}"
-        yield request
-
-http_client = httpx.Client(
-    timeout=5,
-    transport=httpx.HTTPTransport(retries=3),
-    event_hooks={"request": [lambda request: print("->", request.url)]},
-)
-
 client = UapiClient(
-    "https://uapis.cn/api/v1",
-    client=http_client,
-    auth=StaticToken("<TOKEN>"),
+    "https://uapis.cn",
+    token="YOUR_API_KEY",
+    timeout=5.0,
 )
 ```
 
-通过自定义 `client` / `transport` / `auth`，可以无缝植入代理、重试策略或 APM 埋点。
+如果你需要切换到别的环境，直接改 `base_url` 就可以；如果你只想缩短等待时间，传 `timeout` 就够了。
 
 ## 错误模型概览