uapi-sdk-python 0.1.17__py3-none-any.whl → 0.1.18__py3-none-any.whl

uapi/client.py

@@ -135,6 +135,9 @@ class UapiClient:
         _daily = _DailyApi(self._http)
         self.daily = _daily
         setattr(self, "Daily", _daily)
+        _dictionary = _DictionaryApi(self._http)
+        self.dictionary = _dictionary
+        setattr(self, "Dictionary", _dictionary)
         _game = _GameApi(self._http)
         self.game = _game
         setattr(self, "Game", _game)
@@ -174,6 +177,9 @@ class UapiClient:
         _zhi_neng_sou_suo = _ZhiNengSouSuoApi(self._http)
         self.zhi_neng_sou_suo = _zhi_neng_sou_suo
         setattr(self, "智能搜索", _zhi_neng_sou_suo)
+        _shui_yin_yu_aigc_biao_shi = _ShuiYinYuAigcBiaoShiApi(self._http)
+        self.shui_yin_yu_aigc_biao_shi = _shui_yin_yu_aigc_biao_shi
+        setattr(self, "水印与 AIGC 标识", _shui_yin_yu_aigc_biao_shi)
 
     @property
     def last_response_meta(self) -> Optional[ResponseMeta]:
@@ -404,6 +410,147 @@ class _DailyApi:
             disable_cache=_coerce_optional_bool(disable_cache),
         )
     
+    def get_daily_word(self, **kwargs):
+        r"""每日单词
+        想给你的学习打卡、英语小组件或机器人推送加一个『每日单词』？这个接口每天给你一个稳定的单词，同一天多次请求结果一致。
+
+## 功能概述
+默认返回 1 个英文单词，支持按词库范围筛选，可选择是否附带例句和音标。也可以用 `count` 一次返回多个词，用于词汇复习列表。
+
+## 词库选项
+- `all`：全部英文词库，适合通用每日推荐。
+- `cet4`：大学英语四级词汇，适合基础复习。
+- `cet6`：大学英语六级词汇，适合进阶复习。
+- `ielts`：雅思词汇，适合留学考试准备。
+- `toefl`：托福词汇，适合北美考试准备。
+- `gre`：GRE 词汇，适合高阶词汇训练。
+
+## 使用须知
+> [!IMPORTANT]
+> `date` 与 `seed` 用于复现某一天或某个固定的取词结果，二者不能同时传入。
+        """
+        params = {}
+        body = {}
+        
+        if "query" == "query" and "lang" in kwargs:
+            params["lang"] = kwargs["lang"]
+        
+        if "query" == "query" and "category" in kwargs:
+            params["category"] = kwargs["category"]
+        
+        if "query" == "query" and "count" in kwargs:
+            params["count"] = kwargs["count"]
+        
+        if "query" == "query" and "date" in kwargs:
+            params["date"] = kwargs["date"]
+        
+        if "query" == "query" and "seed" in kwargs:
+            params["seed"] = kwargs["seed"]
+        
+        if "query" == "query" and "example" in kwargs:
+            params["example"] = kwargs["example"]
+        
+        if "query" == "query" and "phonetic" in kwargs:
+            params["phonetic"] = kwargs["phonetic"]
+        
+        if "query" == "query" and "define" in kwargs:
+            params["define"] = kwargs["define"]
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/daily/word"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
+
+class _DictionaryApi:
+    def __init__(self, http: _HTTP):
+        self._http = http
+
+    
+    def get_dictionary_audio(self, **kwargs):
+        r"""单词发音
+        光看音标不知道怎么读？用这个接口为单词配上纯正的真人发音，并且支持英式与美式两种口音自由切换。
+
+## 功能概述
+只需传入单词文本和所需的口音类型，接口就会直接响应 `.mp3` 格式的二进制音频流。你可以直接把接口地址塞进前端的 `<audio>` 标签里播放，或者将其下载保存为本地音频文件。另外，“单词查询”接口中返回的 `audio` 字段，实际上也就是直接拼装好的本接口地址。
+
+## 使用须知
+> [!NOTE]
+> 本接口成功调用时返回的是 `audio/mpeg` 格式的二进制音频流，而不是常规的 JSON。如果在代码里使用 Fetch 或 Axios 调用并处理返回数据，请务必以 `blob` 或 `arraybuffer` 的形式接收响应内容。
+        """
+        params = {}
+        body = {}
+        
+        if "query" == "query" and "word" in kwargs:
+            params["word"] = kwargs["word"]
+        
+        if "query" == "query" and "accent" in kwargs:
+            params["accent"] = kwargs["accent"]
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/dictionary/audio"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
+    def get_dictionary_lookup(self, **kwargs):
+        r"""单词查询
+        想在自己的背单词应用、阅读插件或聊天机器人里加个查词功能？输入一个英文单词，就能立刻拿到一本详尽的“微型词典”。
+
+## 功能概述
+传入你要查询的英文单词，接口会返回一整份全方位的词条数据。数据结构是高度动态的——如果某个单词没有常见词组或近义词，对应的字段会自动省略，方便前端精简渲染。
+
+## 返回内容涵盖
+- **音标与发音** (`phonetics`)：包含英式（UK）与美式（US）音标，以及可直接在前端播放的发音音频链接。
+- **中文释义** (`definitions`)：按词性归类的中文翻译。
+- **英英释义** (`english_definitions`)：英文原汁原味的解释及附带的短例句。
+- **词形变化** (`word_forms`)：复数、过去式、比较级等形态转换。
+- **词组与近义词** (`phrases` / `synonyms`)：常见的搭配词组，以及按词性归类的近义词。
+- **双语例句** (`examples`)：真实语境下的中英双语例句。
+        """
+        params = {}
+        body = {}
+        
+        if "query" == "query" and "word" in kwargs:
+            params["word"] = kwargs["word"]
+        
+        if "query" == "query" and "lang" in kwargs:
+            params["lang"] = kwargs["lang"]
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/dictionary/lookup"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
 
 class _GameApi:
     def __init__(self, http: _HTTP):
@@ -487,6 +634,50 @@ class _GameApi:
             disable_cache=_coerce_optional_bool(disable_cache),
         )
     
+    def get_game_minecraft_mods(self, **kwargs):
+        r"""搜索 MC Mod/插件
+        想给你的启动器、服务器面板或资源推荐页加上 Mod/插件搜索？这个接口一次帮你检索 Modrinth 与 SpigotMC 上的资源。
+
+## 功能概述
+传入关键词，即可拿到资源名称、简介、作者、下载量、评分、项目页和下载地址。可以用 `source` 指定只搜某个平台，用 `type` 过滤资源类型，用 `limit` 控制每个平台返回的数量。
+
+## 使用须知
+> [!NOTE]
+> 默认会补全作者名与下载直链。如果只想要更快的基础搜索结果，设置 `enrich=false` 即可降低延迟。
+        """
+        params = {}
+        body = {}
+        
+        if "query" == "query" and "query" in kwargs:
+            params["query"] = kwargs["query"]
+        
+        if "query" == "query" and "source" in kwargs:
+            params["source"] = kwargs["source"]
+        
+        if "query" == "query" and "type" in kwargs:
+            params["type"] = kwargs["type"]
+        
+        if "query" == "query" and "limit" in kwargs:
+            params["limit"] = kwargs["limit"]
+        
+        if "query" == "query" and "enrich" in kwargs:
+            params["enrich"] = kwargs["enrich"]
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/game/minecraft/mods"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
     def get_game_minecraft_serverstatus(self, **kwargs):
         r"""查询 MC 服务器
         想在加入服务器前看看有多少人在线？或者检查一下服务器开没开？用这个接口就对了！
@@ -545,6 +736,79 @@ class _GameApi:
             disable_cache=_coerce_optional_bool(disable_cache),
         )
     
+    def get_game_minecraft_version(self, **kwargs):
+        r"""Minecraft 最新版本
+        需要在启动器、服务器面板或机器人里实时显示 Minecraft 的最新版本？这个接口帮你一键拿到当前的正式版和快照版。
+
+## 功能概述
+无需任何参数，直接返回最新正式版（latest release）、最新快照版（latest snapshot）以及完整的版本列表。适合做版本提示、更新检测或服务端版本看板。
+
+## 使用须知
+> [!NOTE]
+> 数据会随新版本发布而更新，建议在客户端适当缓存，无需高频轮询。
+        """
+        params = {}
+        body = {}
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/game/minecraft/version"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
+    def get_game_steam_servers(self, **kwargs):
+        r"""查询 Steam 游戏服务器
+        想在自己的面板或社区里展示某款游戏的在线服务器？这个接口支持查询使用 A2S/Steam 服务器列表的多人游戏，例如 SCUM、ARK、Rust、CS2 等。
+
+## 功能概述
+传入游戏的 Steam AppID，即可获取当前在线的服务器列表，包含名称、IP、端口、当前/最大人数、地图等信息。你还可以用 `name` 做服务器名称模糊搜索，用 `limit` 控制返回数量。
+
+## 常见 AppID
+- SCUM：`513710`
+- ARK：`346110`
+- Rust：`252490`
+- Counter-Strike 2：`730`
+
+## 使用须知
+> [!NOTE]
+> 不确定游戏的 AppID？可以在 Steam 商店页地址中找到，或参考上面的常见 AppID 列表。
+        """
+        params = {}
+        body = {}
+        
+        if "query" == "query" and "appid" in kwargs:
+            params["appid"] = kwargs["appid"]
+        
+        if "query" == "query" and "name" in kwargs:
+            params["name"] = kwargs["name"]
+        
+        if "query" == "query" and "limit" in kwargs:
+            params["limit"] = kwargs["limit"]
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/game/steam/servers"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
     def get_game_steam_summary(self, **kwargs):
         r"""查询 Steam 用户
         想在你的网站或应用中展示用户的 Steam 个人资料？这个接口就是为你准备的。
@@ -664,6 +928,9 @@ class _ImageApi:
         if "query" == "query" and "date" in kwargs:
             params["date"] = kwargs["date"]
         
+        if "query" == "query" and "random" in kwargs:
+            params["random"] = kwargs["random"]
+        
         if "query" == "query" and "resolution" in kwargs:
             params["resolution"] = kwargs["resolution"]
         
@@ -1412,10 +1679,10 @@ class _MiscApi:
 只传 `type` 参数，返回该平台当前的实时热榜。
 
 ### 时光机模式
-传 `type` + `time` 参数，返回最接近指定时间的热榜快照。如果不可用或无数据，会返回空。
+传 `type` + `time` 参数，返回指定时间附近最近可展示的历史热榜快照。
 
 ### 搜索模式
-传 `type` + `keyword` + `time_start` + `time_end` 参数，在指定时间范围内搜索包含关键词的热榜条目。可选传 `limit` 限制返回数量。
+传 `type` + `keyword` + `time_start` + `time_end` 参数，在指定历史时间范围内搜索包含关键词的热榜条目。可选传 `limit` 限制返回数量。
         """
         params = {}
         body = {}
@@ -1489,6 +1756,71 @@ class _MiscApi:
             disable_cache=_coerce_optional_bool(disable_cache),
         )
     
+    def get_misc_movie_box_office(self, **kwargs):
+        r"""查询电影票房
+        正在做影视类应用，想直观展示今天哪部电影最卖座？大盘总票房突破了多少？这个接口能帮你实时获取院线大盘和影片票房排名。
+
+## 功能概述
+调用此接口，无需任何参数，即可获取当前实时的电影市场大盘数据（包含总票房、总场次、总人次），以及每一部上映影片的具体表现（包括票房明细、排片占比、上座率、场均人次和累计票房等）。
+        """
+        params = {}
+        body = {}
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/misc/movie-box-office"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
+    def get_misc_movie_rating_rank(self, **kwargs):
+        r"""电影收视排行查询
+        想做影视榜单页或选题分析？这个接口提供影视的收视、热度和评分排行，既能查实时榜，也能按日、周、月回看历史快照。
+
+## 功能概述
+用 `channel` 切换全网、卫视、网络平台或院线榜单，用 `period` + `date` 查询历史日榜、周榜和月榜。适合影视资讯页、数据看板、自媒体选题和内容运营分析。
+        """
+        params = {}
+        body = {}
+        
+        if "query" == "query" and "channel" in kwargs:
+            params["channel"] = kwargs["channel"]
+        
+        if "query" == "query" and "platform" in kwargs:
+            params["platform"] = kwargs["platform"]
+        
+        if "query" == "query" and "limit" in kwargs:
+            params["limit"] = kwargs["limit"]
+        
+        if "query" == "query" and "period" in kwargs:
+            params["period"] = kwargs["period"]
+        
+        if "query" == "query" and "date" in kwargs:
+            params["date"] = kwargs["date"]
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/misc/movie-rating-rank"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
     def get_misc_phoneinfo(self, **kwargs):
         r"""查询手机归属地
         想知道一个手机号码来自哪里？是移动、联通还是电信？这个接口可以告诉你答案。
@@ -1524,21 +1856,6 @@ class _MiscApi:
 ## 功能概述
 这是一个强大的随机数生成器。你可以指定生成的范围（最大/最小值）、数量、是否允许重复、以及是否生成小数（并指定小数位数）。
 
-## 流程图
-```mermaid
-graph TD
-    A[开始] --> B{参数校验};
-    B --> |通过| C{是否允许小数?};
-    C --> |是| D[生成随机小数];
-    C --> |否| E[生成随机整数];
-    D --> F{是否允许重复?};
-    E --> F;
-    F --> |是| G[直接生成指定数量];
-    F --> |否| H[生成不重复的数字];
-    G --> I[返回结果];
-    H --> I;
-    B --> |失败| J[返回 400 错误];
-```
 ## 使用须知
 > [!WARNING]
 > **不重复生成的逻辑限制**
@@ -1701,9 +2018,6 @@ graph TD
         if "query" == "query" and "phone" in kwargs:
             params["phone"] = kwargs["phone"]
         
-        if "query" == "query" and "full" in kwargs:
-            params["full"] = kwargs["full"]
-        
         if "_t" in kwargs:
             params["_t"] = kwargs["_t"]
         disable_cache = kwargs.get("disable_cache")
@@ -1787,6 +2101,53 @@ graph TD
             disable_cache=_coerce_optional_bool(disable_cache),
         )
     
+    def get_misc_weather_history(self, **kwargs):
+        r"""查询历史天气
+        想知道某个城市过去一段时间有没有下雨、降雨量是多少？这个接口用于查询过去最多 366 天的城市每日历史天气。
+
+## 功能概述
+支持按 `city`、`adcode` 或客户端 IP 自动定位查询。你可以传 `start_date` + `end_date` 指定日期范围，也可以只传 `days` 回看最近若干天。返回结果重点包含 `rained` 与 `rain`，适合做出行复盘、农业记录、气象看板和数据分析。
+
+## 使用须知
+> [!NOTE]
+> 定位优先级：`adcode` > `city` > IP 自动定位。同时传 `start_date` 和 `days` 时，以 `start_date` + `end_date` 区间为准。
+        """
+        params = {}
+        body = {}
+        
+        if "query" == "query" and "city" in kwargs:
+            params["city"] = kwargs["city"]
+        
+        if "query" == "query" and "adcode" in kwargs:
+            params["adcode"] = kwargs["adcode"]
+        
+        if "query" == "query" and "start_date" in kwargs:
+            params["start_date"] = kwargs["start_date"]
+        
+        if "query" == "query" and "end_date" in kwargs:
+            params["end_date"] = kwargs["end_date"]
+        
+        if "query" == "query" and "days" in kwargs:
+            params["days"] = kwargs["days"]
+        
+        if "query" == "query" and "lang" in kwargs:
+            params["lang"] = kwargs["lang"]
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/misc/weather/history"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
     def get_misc_worldtime(self, **kwargs):
         r"""查询世界时间
         需要和国外的朋友开会，想知道他那边现在几点？用这个接口一查便知。
@@ -2200,6 +2561,64 @@ class _PoemApi:
             disable_cache=_coerce_optional_bool(disable_cache),
         )
     
+    def get_saying_random(self, **kwargs):
+        r"""一言（随机/每日/场景/此刻）
+        一言接口，返回一条随机语录。通过 `mode` 参数切换四种返回方式，并支持按来源、分类、标签过滤。
+
+## 四种模式（`mode`）
+- **`random`（默认）**：每次调用随机返回一条语录。
+- **`daily`**：同一天内返回固定的同一条，适合每日打卡、签到等场景。
+- **`recommend`**：配合 `scene` 参数，返回指定场景（如 `night`、`morning`）的语录。
+- **`moment`**：根据请求时所处时段，自动返回应景语录。
+
+## 语言控制
+语料分中英文两类，可通过 `source` 或 `category` 控制：
+- 需要中文：`source` 选「综合句子语料库 / 曹星宇句子集」，或 `category` 选中文分类（如 影视、文学、诗词）。
+- 需要英文：`source` 选「Quotable / 英文历史名言」。
+
+## 使用须知
+> [!NOTE]
+> - `source`、`category`、`tag` 支持多值，用英文逗号 `,` 或分号 `;` 分隔。
+> - `scene` 仅在 `mode=recommend` 时生效且必填，其他模式下会被忽略。
+> - 请求示例：
+>   - 随机：`GET /api/v1/saying/random`
+>   - 每日：`GET /api/v1/saying/random?mode=daily`
+>   - 场景：`GET /api/v1/saying/random?mode=recommend&scene=night`
+>   - 此刻：`GET /api/v1/saying/random?mode=moment`
+        """
+        params = {}
+        body = {}
+        
+        if "query" == "query" and "mode" in kwargs:
+            params["mode"] = kwargs["mode"]
+        
+        if "query" == "query" and "scene" in kwargs:
+            params["scene"] = kwargs["scene"]
+        
+        if "query" == "query" and "source" in kwargs:
+            params["source"] = kwargs["source"]
+        
+        if "query" == "query" and "category" in kwargs:
+            params["category"] = kwargs["category"]
+        
+        if "query" == "query" and "tag" in kwargs:
+            params["tag"] = kwargs["tag"]
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/saying/random"
+        
+        return self._http.request(
+            "GET",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
 
 class _RandomApi:
     def __init__(self, http: _HTTP):
@@ -2212,15 +2631,6 @@ class _RandomApi:
 
 ## 功能概述
 通过向答案之书提问，你将获得一个充满智慧（或许）的随机答案。这个API支持通过查询参数或POST请求体两种方式提问。
-
-## 使用须知
-
-> [!TIP]
-> **提问技巧**
-> - 提出明确的问题会获得更好的体验
-> - 问题不能为空
-> - 支持中文问题
-> - 答案具有随机性，仅供娱乐参考
         """
         params = {}
         body = {}
@@ -2448,6 +2858,15 @@ class _SocialApi:
         if "query" == "query" and "org" in kwargs:
             params["org"] = kwargs["org"]
         
+        if "query" == "query" and "pinned" in kwargs:
+            params["pinned"] = kwargs["pinned"]
+        
+        if "query" == "query" and "repos" in kwargs:
+            params["repos"] = kwargs["repos"]
+        
+        if "query" == "query" and "repos_limit" in kwargs:
+            params["repos_limit"] = kwargs["repos_limit"]
+        
         if "_t" in kwargs:
             params["_t"] = kwargs["_t"]
         disable_cache = kwargs.get("disable_cache")
@@ -3936,3 +4355,253 @@ UAPI Pro Search 可以根据查询内容返回更相关的搜索结果。你可
         )
     
 
+class _ShuiYinYuAigcBiaoShiApi:
+    def __init__(self, http: _HTTP):
+        self._http = http
+
+    
+    def post_watermark_decode(self, **kwargs):
+        r"""提取图片隐水印
+        遇到一张疑似被盗用或 AI 生成的图片，想查查它有没有被打过“思想钢印”？直接把图片扔给这个接口，它能把藏在里面的标识完完整整地提取出来。
+
+## 功能概述
+此接口用于检测图片中是否包含隐形水印，若存在则还原出写入的原始标识内容。即使图片经历过压缩、截取或多次网络转发，也具备较高的成功提取率。接口具备防误判机制，若图片确实未经过处理，会明确返回未检测到结果，而不会强制拼接无效内容。
+
+## 使用须知
+如果您在嵌入水印时修改过进阶参数（如 `ecc` 或 `model_type`），在提取时必须传入相同的参数值。若嵌入时使用的是默认配置，此处直接留空即可。
+        """
+        params = {}
+        data = {}
+        files = {}
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        
+        if "ecc" in kwargs:
+            data["ecc"] = _stringify_form_value(kwargs["ecc"])
+        
+        if "file" in kwargs:
+            files["file"] = _prepare_file_value(kwargs["file"])
+        
+        if "image_base64" in kwargs:
+            data["image_base64"] = _stringify_form_value(kwargs["image_base64"])
+        
+        if "model_type" in kwargs:
+            data["model_type"] = _stringify_form_value(kwargs["model_type"])
+        
+        if "url" in kwargs:
+            data["url"] = _stringify_form_value(kwargs["url"])
+        
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/watermark/decode"
+        
+        return self._http.request(
+            "POST",
+            path,
+            params=params,
+            data=data or None,
+            files=files or None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
+    def post_watermark_embed(self, **kwargs):
+        r"""添加图片隐水印
+        想给自己的原创图片打上专属烙印，又不想破坏画面美感？或者是为了 AIGC 生成的图片做后续溯源追踪？这个接口能帮您把自定义标识悄悄藏进图片里。
+
+## 功能概述
+您可以上传图片并指定一段标识文本，接口会利用算法将这段文本隐形嵌入到图片的像素之中。嵌入后的图片在肉眼看来毫无变化，但能够有效抵抗常见的缩放、裁剪、社交平台压缩与二次转发。适合用于标记图片来源、追踪分发渠道或进行隐蔽的版权确权。
+
+## 使用须知
+**容量限制**：受限于隐形水印的算法特性，图片能嵌入的字符长度有限（通常为短码）。建议只放入简短的溯源 ID 或特征码，将完整的映射信息存储在您自己的数据库中。
+
+**参数说明**：提供图片的方式（`file` / `url` / `image_base64`）三选一即可；其他进阶参数如无特殊需求，建议保持留空使用默认最佳配置。
+        """
+        params = {}
+        data = {}
+        files = {}
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        
+        if "ecc" in kwargs:
+            data["ecc"] = _stringify_form_value(kwargs["ecc"])
+        
+        if "file" in kwargs:
+            files["file"] = _prepare_file_value(kwargs["file"])
+        
+        if "image_base64" in kwargs:
+            data["image_base64"] = _stringify_form_value(kwargs["image_base64"])
+        
+        if "jpeg_quality" in kwargs:
+            data["jpeg_quality"] = _stringify_form_value(kwargs["jpeg_quality"])
+        
+        if "model_type" in kwargs:
+            data["model_type"] = _stringify_form_value(kwargs["model_type"])
+        
+        if "out_format" in kwargs:
+            data["out_format"] = _stringify_form_value(kwargs["out_format"])
+        
+        if "payload" in kwargs:
+            data["payload"] = _stringify_form_value(kwargs["payload"])
+        
+        if "strength" in kwargs:
+            data["strength"] = _stringify_form_value(kwargs["strength"])
+        
+        if "url" in kwargs:
+            data["url"] = _stringify_form_value(kwargs["url"])
+        
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/watermark/embed"
+        
+        return self._http.request(
+            "POST",
+            path,
+            params=params,
+            data=data or None,
+            files=files or None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
+    def post_watermark_label(self, **kwargs):
+        r"""添加 AI 生成内容标识
+        AI 生成的图片上线前需要满足国标合规要求？别头疼，调用一次这个接口，就能自动给图片打上符合《GB 45438-2025》标准的三层标识。
+
+## 三层标识说明
+此接口一次性支持注入以下三种符合国标规范的标识：
+- **元数据隐式标识**（默认开启）：在图片文件的 EXIF/XMP 元数据中记录此内容的“AI 生成”属性及服务提供者信息，不影响视觉呈现。
+- **可见角标标识**（可选）：在图片指定角落叠加醒目的“AI 生成”文字，字号会自动计算以符合国标关于“字符高度不小于画面短边 5%”的规定。
+- **隐形水印标识**（可选）：在图像像素深层嵌入抗压缩溯源信息。
+
+## 使用须知
+**必填说明**：根据规范，`content_producer`（服务提供者编码）为必填项。推荐使用本平台配套的 `/watermark/producer-code` 接口快速生成规范的 27 位服务提供者编码。
+
+**标识组合**：若您需要关闭默认的元数据标识（`skip_metadata=true`），则必须至少开启可见角标或隐形水印中的一项，以保证图片拥有合规标识。
+        """
+        params = {}
+        data = {}
+        files = {}
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        
+        if "content_producer" in kwargs:
+            data["content_producer"] = _stringify_form_value(kwargs["content_producer"])
+        
+        if "content_propagator" in kwargs:
+            data["content_propagator"] = _stringify_form_value(kwargs["content_propagator"])
+        
+        if "embed_watermark" in kwargs:
+            data["embed_watermark"] = _stringify_form_value(kwargs["embed_watermark"])
+        
+        if "explicit_height_ratio" in kwargs:
+            data["explicit_height_ratio"] = _stringify_form_value(kwargs["explicit_height_ratio"])
+        
+        if "explicit_label" in kwargs:
+            data["explicit_label"] = _stringify_form_value(kwargs["explicit_label"])
+        
+        if "explicit_position" in kwargs:
+            data["explicit_position"] = _stringify_form_value(kwargs["explicit_position"])
+        
+        if "explicit_text" in kwargs:
+            data["explicit_text"] = _stringify_form_value(kwargs["explicit_text"])
+        
+        if "file" in kwargs:
+            files["file"] = _prepare_file_value(kwargs["file"])
+        
+        if "image_base64" in kwargs:
+            data["image_base64"] = _stringify_form_value(kwargs["image_base64"])
+        
+        if "jpeg_quality" in kwargs:
+            data["jpeg_quality"] = _stringify_form_value(kwargs["jpeg_quality"])
+        
+        if "label" in kwargs:
+            data["label"] = _stringify_form_value(kwargs["label"])
+        
+        if "out_format" in kwargs:
+            data["out_format"] = _stringify_form_value(kwargs["out_format"])
+        
+        if "produce_id" in kwargs:
+            data["produce_id"] = _stringify_form_value(kwargs["produce_id"])
+        
+        if "propagate_id" in kwargs:
+            data["propagate_id"] = _stringify_form_value(kwargs["propagate_id"])
+        
+        if "skip_metadata" in kwargs:
+            data["skip_metadata"] = _stringify_form_value(kwargs["skip_metadata"])
+        
+        if "url" in kwargs:
+            data["url"] = _stringify_form_value(kwargs["url"])
+        
+        if "watermark_payload" in kwargs:
+            data["watermark_payload"] = _stringify_form_value(kwargs["watermark_payload"])
+        
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/watermark/label"
+        
+        return self._http.request(
+            "POST",
+            path,
+            params=params,
+            data=data or None,
+            files=files or None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
+    def post_watermark_producer_code(self, **kwargs):
+        r"""生成 AIGC 服务提供者编码
+        还在发愁怎么拼出符合《GB 45438-2025》要求的 27 位 AIGC 服务提供者编码？无论是想一键生成自己的专属合规编码，还是想校验已有编码对不对，这个接口都能帮您轻松搞定。
+
+## 功能概述
+此接口具备“生成”与“校验”双重能力：
+- **生成模式**：填入组织或个人的主体身份信息与证件号，接口会自动处理复杂的拼位规则，输出标准的 27 位编码。
+- **校验模式**：仅需填入现成的 `code`，接口将逐段拆解、验证其合法性，并解析出各个组成部分的实际含义。
+
+## 使用须知
+**模式互斥**：当您在请求体中填入了 `code` 参数时，接口会自动进入“校验模式”，其余的生成参数将被忽略；反之则进入“生成模式”。
+
+**独立生成**：该编码不依赖向外部机构注册申请，而是基于您的法定身份标识（如企业统一社会信用代码、个人身份证等）根据标准算法独立生成即可。
+        """
+        params = {}
+        body = {}
+        
+        if "_t" in kwargs:
+            params["_t"] = kwargs["_t"]
+        
+        if "binding" in kwargs:
+            body["binding"] = kwargs["binding"]
+        
+        if "code" in kwargs:
+            body["code"] = kwargs["code"]
+        
+        if "identifier" in kwargs:
+            body["identifier"] = kwargs["identifier"]
+        
+        if "model_code" in kwargs:
+            body["model_code"] = kwargs["model_code"]
+        
+        if "service_type" in kwargs:
+            body["service_type"] = kwargs["service_type"]
+        
+        if "subject_type" in kwargs:
+            body["subject_type"] = kwargs["subject_type"]
+        
+        disable_cache = kwargs.get("disable_cache")
+        if disable_cache is None and "disableCache" in kwargs:
+            disable_cache = kwargs["disableCache"]
+        path = "/api/v1/watermark/producer-code"
+        
+        return self._http.request(
+            "POST",
+            path,
+            params=params,
+            json=body if body else None,
+            disable_cache=_coerce_optional_bool(disable_cache),
+        )
+    
+

uapi/errors.py

@@ -67,7 +67,7 @@ class UapiError(Exception):
 
 class ApiErrorError(UapiError):
     """上游/内部错误 (API_ERROR)"""
-    DEFAULT_STATUS = 504
+    DEFAULT_STATUS = 503
 
 class AvatarNotFoundError(UapiError):
     """头像未找到 (AVATAR_NOT_FOUND)"""

{uapi_sdk_python-0.1.17.dist-info → uapi_sdk_python-0.1.18.dist-info}/METADATA

@@ -1,16 +1,37 @@
 Metadata-Version: 2.4
 Name: uapi-sdk-python
-Version: 0.1.17
-Summary: Idiomatic UAPI SDK for Python
+Version: 0.1.18
+Summary: Official Python SDK for UAPI / uapis.cn — strongly-typed wrapper around 100+ free public-API endpoints (network, text, image, social, translation, search). Generated from the live OpenAPI 3.1 spec.
 Author-email: UAPI <dev@uapis.cn>
+License: MIT
+Project-URL: Homepage, https://uapis.cn/docs/sdk/python
+Project-URL: Documentation, https://uapis.cn/docs
+Project-URL: Repository, https://github.com/AxT-Team/uapi-sdk-python
+Project-URL: Issues, https://github.com/AxT-Team/uapi-sdk-python/issues
+Project-URL: OpenAPI Spec, https://uapis.cn/openapi.json
+Keywords: uapi,uapis,uapis.cn,sdk,python,rest,rest-api,openapi,httpx,public-api,free-api,agent,ai,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: httpx>=0.24.1
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Requires-Dist: isort; extra == "dev"
+Dynamic: license-file
 
 # uapi-sdk-python
 

uapi_sdk_python-0.1.18.dist-info/RECORD

@@ -0,0 +1,8 @@
+uapi/__init__.py,sha256=3dluUZfyWYYGTWzDBFip0d5YZej6waZiq2ayvJ0RI9o,86
+uapi/client.py,sha256=VE3z6i3739zsxiN2DDA1MRIUW74YBseLSSnz7T7U2kU,181373
+uapi/errors.py,sha256=eF1TI7qxHhFsTGZuSd_4CTsNj3_abWoWYIJMoTjf2CM,11067
+uapi_sdk_python-0.1.18.dist-info/licenses/LICENSE,sha256=F1YYNj0coHKqNi_aOqukCoDKSdNhKEJDP6ylsgMz3pw,1072
+uapi_sdk_python-0.1.18.dist-info/METADATA,sha256=NwkE2wSlOMzZqZQz02pktD47DiwwIKSZZgJLrQnyZCA,7060
+uapi_sdk_python-0.1.18.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+uapi_sdk_python-0.1.18.dist-info/top_level.txt,sha256=0TrPOLLMqin88fxqxR9T5piS4dSoyju9HFiPu1oPEUU,5
+uapi_sdk_python-0.1.18.dist-info/RECORD,,

uapi_sdk_python-0.1.18.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AxT-Team / UAPI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

uapi_sdk_python-0.1.17.dist-info/RECORD

@@ -1,7 +0,0 @@
-uapi/__init__.py,sha256=3dluUZfyWYYGTWzDBFip0d5YZej6waZiq2ayvJ0RI9o,86
-uapi/client.py,sha256=2MijKxsm656POod6_GZTS1fyD_7ZJdGWyjBXDanx6JY,152431
-uapi/errors.py,sha256=ZmB8xwqED689r4R5x4zSF7rMqZ9vUU8bwV5j_rxyHN4,11067
-uapi_sdk_python-0.1.17.dist-info/METADATA,sha256=pYu7jYBrvFPt6A5yVXiFyHUrP1JlLUh33ehb1Fray1Y,5848
-uapi_sdk_python-0.1.17.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-uapi_sdk_python-0.1.17.dist-info/top_level.txt,sha256=0TrPOLLMqin88fxqxR9T5piS4dSoyju9HFiPu1oPEUU,5
-uapi_sdk_python-0.1.17.dist-info/RECORD,,