redfox-python-sdk 0.2.0__tar.gz → 0.2.1__tar.gz

{redfox-python-sdk-0.2.0 → redfox-python-sdk-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: redfox-python-sdk
-Version: 0.2.0
+Version: 0.2.1
 Summary: RedFox 红狐数据平台 Python SDK
 Home-page: https://redfox.hk
 Author: RedFox

{redfox-python-sdk-0.2.0 → redfox-python-sdk-0.2.1}/redfox/__init__.py

@@ -3,5 +3,5 @@
 from .client import RedFoxClient
 from .exceptions import RedFoxAPIError, RedFoxAuthError, RedFoxRateLimitError
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 __all__ = ["RedFoxClient", "RedFoxAPIError", "RedFoxAuthError", "RedFoxRateLimitError"]

redfox-python-sdk-0.2.1/redfox/endpoints/bilibili.py

@@ -0,0 +1,123 @@
+"""哔哩哔哩平台 API 端点"""
+
+from typing import Optional, Dict, Any
+
+
+class BilibiliAPI:
+    """
+    哔哩哔哩平台 API 集合
+
+    包含 B 站账号查询、作品搜索、作品详情等接口。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    def get_account(self, mid: str) -> dict:
+        """
+        获取哔哩哔哩账号信息（优质库）
+
+        :param mid: 账号 MID（B 站用户唯一 ID，必填）
+        :return: 账号信息字典
+        """
+        return self._client.post(
+            "/story/api/bili/data/accountDetail", data={"mid": mid}
+        )
+
+    def get_work(
+        self,
+        bvid: str = None,
+        work_url: str = None,
+    ) -> dict:
+        """
+        获取哔哩哔哩作品内容详情（优质库）
+
+        bvid 和 work_url 至少传一个。
+
+        :param bvid: 作品 BV 号
+        :param work_url: 作品链接，支持 bilibili.com/video/BV1xxx 或 b23.tv 格式
+        :return: 作品详情字典
+        """
+        data: Dict[str, Any] = {}
+        if bvid:
+            data["bvId"] = bvid
+        if work_url:
+            data["workUrl"] = work_url
+        return self._client.post("/story/api/bili/data/workDetail", data=data)
+
+    def search_users(
+        self,
+        keyword: str,
+        page: int = 1,
+        page_size: int = None,
+        order: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取哔哩哔哩账号（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param page: 页码，从 1 开始（必填）
+        :param page_size: 每页条数，默认 10，最大 50
+        :param order: 排序：follower=粉丝数 / like=获赞数，默认相关性
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {"keyword": keyword, "page": str(page)}
+        if page_size is not None:
+            data["pageSize"] = page_size
+        if order is not None:
+            data["order"] = order
+        return self._client.post("/story/api/bili/data/accountSearch", data=data)
+
+    def search_articles(
+        self,
+        keyword: str,
+        page: int = 1,
+        page_size: int = None,
+        order: str = None,
+    ) -> dict:
+        """
+        搜索关键词获取哔哩哔哩作品（优质库）
+
+        :param keyword: 搜索关键词（必填）
+        :param page: 页码，从 1 开始（必填）
+        :param page_size: 每页条数，默认 10，最大 50
+        :param order: 排序：time=发布时间 / play=播放数 / like=点赞数 / comment=评论数 / favorite=收藏数，默认 time
+        :return: 搜索结果字典
+        """
+        data: Dict[str, Any] = {"keyword": keyword, "page": str(page)}
+        if page_size is not None:
+            data["pageSize"] = page_size
+        if order is not None:
+            data["order"] = order
+        return self._client.post("/story/api/bili/data/workSearch", data=data)
+
+    def get_user_works(
+        self,
+        mid: str = None,
+        account_url: str = None,
+        page: int = 1,
+        page_size: int = None,
+        order: str = None,
+    ) -> dict:
+        """
+        获取哔哩哔哩账号作品列表（优质库）
+
+        mid 和 account_url 至少传一个。
+
+        :param mid: 账号 MID
+        :param account_url: 主页链接，如 https://space.bilibili.com/946974
+        :param page: 页码，默认 1
+        :param page_size: 每页条数，默认 10，最大 50
+        :param order: 排序：time=发布时间 / play=播放数 / like=点赞数，默认 time
+        :return: 作品列表字典
+        """
+        data: Dict[str, Any] = {"page": str(page)}
+        if mid:
+            data["mid"] = mid
+        if account_url:
+            data["accountUrl"] = account_url
+        if page_size is not None:
+            data["pageSize"] = page_size
+        if order is not None:
+            data["order"] = order
+        return self._client.post("/story/api/bili/data/accountWorkList", data=data)

redfox-python-sdk-0.2.1/redfox/endpoints/doubao_video.py

@@ -0,0 +1,74 @@
+"""豆包视频生成 API 端点（Seedance 2.0）"""
+
+from typing import Optional, Dict, Any, List
+
+
+class DoubaoVideoAPI:
+    """
+    豆包视频生成 API 集合（Seedance 2.0）
+
+    包含视频生成任务提交与结果查询接口。
+    """
+
+    def __init__(self, client):
+        self._client = client
+
+    def submit(
+        self,
+        content: List[Dict[str, Any]],
+        model: str = None,
+        resolution: str = "720p",
+        ratio: str = "adaptive",
+        duration: int = 5,
+        seed: int = -1,
+        watermark: bool = False,
+        generate_audio: bool = True,
+        return_last_frame: bool = False,
+    ) -> dict:
+        """
+        提交视频生成任务（Seedance 2.0）
+
+        content 是一个列表，每个元素是一个字典，支持以下 type：
+        - text: {"type": "text", "text": "描述文字"}
+        - image_url: {"type": "image_url", "imageUrl": "图片URL", "imageRole": "first_frame/reference_image"}
+        - video_url: {"type": "video_url", "videoUrl": "视频URL", "videoRole": "reference_video"}
+        - audio_url: {"type": "audio_url", "audioUrl": "音频URL", "audioRole": "reference_audio"}
+
+        :param content: 输入内容列表（必填），每项包含 type 及对应字段
+        :param model: 模型名称，如 "doubao-seedance-2-0-260128"
+        :param resolution: 视频分辨率：480p/720p/1080p（Seedance 2.0 fast 不支持 1080p）
+        :param ratio: 宽高比：adaptive/16:9/4:3/1:1/3:4/9:16/21:9
+        :param duration: 视频时长（秒），[4,15] 或 -1（智能）
+        :param seed: 随机种子，-1 为随机，范围 [-1, 2^32-1]
+        :param watermark: 是否添加水印
+        :param generate_audio: 是否生成同步音频（仅 Seedance 2.0 系列）
+        :param return_last_frame: 是否返回尾帧图像（用于连续视频生成）
+        :return: 含 taskId 的字典
+        """
+        data: Dict[str, Any] = {
+            "content": content,
+            "resolution": resolution,
+            "ratio": ratio,
+            "duration": duration,
+            "seed": seed,
+            "watermark": watermark,
+            "generateAudio": generate_audio,
+            "returnLastFrame": return_last_frame,
+        }
+        if model is not None:
+            data["model"] = model
+        return self._client.post(
+            "/story/api/parseWork/videoGen/submit", data=data
+        )
+
+    def result(self, task_id: str) -> dict:
+        """
+        查询视频生成任务结果
+
+        :param task_id: 任务 ID（submit 接口返回）
+        :return: 视频生成结果字典
+        """
+        return self._client.post(
+            "/story/api/parseWork/videoGen/result",
+            data={"taskId": task_id},
+        )

{redfox-python-sdk-0.2.0 → redfox-python-sdk-0.2.1}/redfox/endpoints/gpt_image.py

@@ -24,6 +24,7 @@ class GPTImageAPI:
         output_compression: int = None,
         model_name: str = "gpt-image-2",
         operation: str = "generate",
+        input_fidelity: str = None,
         images: List[Dict[str, str]] = None,
     ) -> dict:
         """
@@ -38,23 +39,28 @@ class GPTImageAPI:
         :param output_compression: 输出压缩比，0~100
         :param model_name: 模型名称，默认 gpt-image-2
         :param operation: 操作类型，generate（文生图）/ edit（图生图）
+        :param input_fidelity: 输入图保真度，编辑模式（operation=edit）支持 high/low
         :param images: 图片编辑输入图列表，operation=edit 时必填
         :return: 包含 taskId 的字典
         """
+        parameters: Dict[str, Any] = {
+            "modelName": model_name,
+            "n": n,
+            "size": size,
+            "quality": quality,
+            "background": background,
+            "outputFormat": output_format,
+        }
+        if output_compression is not None:
+            parameters["outputCompression"] = output_compression
+        if input_fidelity is not None:
+            parameters["inputFidelity"] = input_fidelity
+
         data: Dict[str, Any] = {
             "prompt": prompt,
             "operation": operation,
-            "parameters": {
-                "modelName": model_name,
-                "n": n,
-                "size": size,
-                "quality": quality,
-                "background": background,
-                "outputFormat": output_format,
-            },
+            "parameters": parameters,
         }
-        if output_compression is not None:
-            data["parameters"]["outputCompression"] = output_compression
         if images is not None:
             data["images"] = images
         return self._client.post("/story/api/parseWork/imageGen/submitSkill", data=data)

{redfox-python-sdk-0.2.0 → redfox-python-sdk-0.2.1}/redfox/endpoints/wechat.py

@@ -51,26 +51,26 @@ class WechatAPI:
 
     # ─── 作品相关 ───────────────────────────────────────────
 
-    def get_work(self, uuid: str) -> dict:
+    def get_work(self, work_uuid: str) -> dict:
         """
         根据作品 UUID 获取公众号作品（优质库）
 
-        :param uuid: 作品 UUID
+        :param work_uuid: 作品 UUID（必填）
         :return: 作品详情字典
         """
         return self._client.post(
-            "/story/api/gzhData/queryWork", data={"uuid": uuid}
+            "/story/api/gzhData/queryWork", data={"workUuid": work_uuid}
         )
 
-    def get_article_detail(self, article_url: str) -> dict:
+    def get_article_detail(self, url: str) -> dict:
         """
         根据作品地址获取公众号文章（优质库）
 
-        :param article_url: 文章链接
+        :param url: 文章链接（必填）
         :return: 文章详情字典
         """
         return self._client.post(
-            "/story/api/gzhData/queryArticleDetail", data={"articleUrl": article_url}
+            "/story/api/gzhData/queryArticleDetail", data={"url": url}
         )
 
     def search_articles(
@@ -96,25 +96,35 @@ class WechatAPI:
 
     def get_user_works(
         self,
-        account: str = None,
+        account: str,
         account_name: str = None,
         offset: int = 0,
+        sort_type: str = None,
+        publish_time_start: str = None,
+        publish_time_end: str = None,
     ) -> dict:
         """
         获取公众号账号作品列表（优质库）
 
-        :param account: 公众号微信号
-        :param account_name: 公众号名称
-        :param offset: 偏移量，从 0 开始
+        :param account: 公众号微信号（必填）
+        :param account_name: 公众号名称（可选）
+        :param offset: 偏移量，从 0 开始，每页 +20
+        :param sort_type: 排序方式：_0=默认，_2=最新，_4=最热
+        :param publish_time_start: 发布时间起始，最早 2026-04-01，不传默认 2026-04-01
+        :param publish_time_end: 发布时间结束，不传默认当前时间
         :return: 作品列表字典
         """
-        data: Dict[str, Any] = {}
-        if account:
-            data["account"] = account
+        data: Dict[str, Any] = {"account": account}
         if account_name:
             data["accountName"] = account_name
         if offset is not None:
             data["offset"] = offset
+        if sort_type is not None:
+            data["sortType"] = sort_type
+        if publish_time_start is not None:
+            data["publishTimeStart"] = publish_time_start
+        if publish_time_end is not None:
+            data["publishTimeEnd"] = publish_time_end
         return self._client.post("/story/api/gzhData/queryWorkList", data=data)
 
     # ─── AI 作品 ────────────────────────────────────────────
@@ -131,10 +141,10 @@ class WechatAPI:
         搜索关键词获取公众号 AI 创作作品（优质库）
 
         :param keyword: 搜索关键词（必填）
-        :param page_num: 页码，默认 1
-        :param page_size: 每页条数，默认 20
-        :param start_time: 开始时间
-        :param end_time: 结束时间
+        :param page_num: 页码，默认 1（必填）
+        :param page_size: 每页条数，默认 20（必填）
+        :param start_time: 开始时间，格式 "2026-06-01 00:00:00"
+        :param end_time: 结束时间，格式 "2026-06-01 23:59:59"
         :return: 搜索结果字典
         """
         data: Dict[str, Any] = {

{redfox-python-sdk-0.2.0 → redfox-python-sdk-0.2.1}/redfox/endpoints/xiaohongshu.py

@@ -7,7 +7,7 @@ class XiaohongshuAPI:
     """
     小红书平台 API 集合
 
-    包含小红书账号查询、作品详情、关键词搜索等接口。
+    包含小红书账号查询、作品搜索、笔记详情等接口。
     """
 
     def __init__(self, client):
@@ -15,23 +15,6 @@ class XiaohongshuAPI:
 
     # ─── 账号相关 ───────────────────────────────────────────
 
-    def get_account(
-        self,
-        account_id: str,
-        user_id: str = None,
-    ) -> dict:
-        """
-        获取小红书账号信息（优质库）
-
-        :param account_id: 小红书号（必填）
-        :param user_id: 用户 ID，可从主页链接提取
-        :return: 账号信息字典
-        """
-        data: Dict[str, Any] = {"accountId": account_id}
-        if user_id is not None:
-            data["userId"] = user_id
-        return self._client.post("/story/api/xhsUser/queryAccountDetail", data=data)
-
     def search_users(
         self,
         keyword: str,
@@ -42,7 +25,7 @@ class XiaohongshuAPI:
         搜索关键词获取小红书账号（优质库）
 
         :param keyword: 搜索关键词（必填）
-        :param offset: 分页偏移量，从 0 开始
+        :param offset: 偏移量
         :param sort_type: 排序方式
         :return: 搜索结果字典
         """
@@ -51,22 +34,31 @@ class XiaohongshuAPI:
             data["offset"] = offset
         if sort_type is not None:
             data["sortType"] = sort_type
-        return self._client.post("/story/api/xhsUser/searchUser", data=data)
-
-    # ─── 作品相关 ───────────────────────────────────────────
+        return self._client.post(
+            "/story/api/redBookData/searchUser", data=data
+        )
 
-    def get_work(self, note_id: str) -> dict:
+    def get_account(
+        self,
+        account_id: str,
+        user_id: str = None,
+    ) -> dict:
         """
-        获取小红书作品内容详情（优质库）
+        获取小红书账号信息（优质库）
 
-        :param note_id: 笔记 ID
-        :return: 作品详情字典
+        :param account_id: 小红书号（必填）
+        :param user_id: 用户 ID（可选）
+        :return: 账号信息字典
         """
+        data: Dict[str, Any] = {"accountId": account_id}
+        if user_id is not None:
+            data["userId"] = user_id
         return self._client.post(
-            "/story/api/xhsUser/queryWorkDetail",
-            data={"noteId": note_id},
+            "/story/api/redBookData/queryUser", data=data
         )
 
+    # ─── 作品相关 ───────────────────────────────────────────
+
     def search_articles(
         self,
         keyword: str,
@@ -77,7 +69,7 @@ class XiaohongshuAPI:
         搜索关键词获取小红书作品（优质库）
 
         :param keyword: 搜索关键词（必填）
-        :param offset: 分页偏移量，从 0 开始
+        :param offset: 偏移量
         :param sort_type: 排序方式
         :return: 搜索结果字典
         """
@@ -86,7 +78,32 @@ class XiaohongshuAPI:
             data["offset"] = offset
         if sort_type is not None:
             data["sortType"] = sort_type
-        return self._client.post("/story/api/xhsUser/searchArticle", data=data)
+        return self._client.post(
+            "/story/api/redBookData/searchArticle", data=data
+        )
+
+    def get_work(
+        self,
+        work_id: str = None,
+        work_link: str = None,
+    ) -> dict:
+        """
+        获取小红书作品内容详情（优质库）
+
+        work_id 和 work_link 至少传一个。
+
+        :param work_id: 作品 ID
+        :param work_link: 作品链接，如 https://www.xiaohongshu.com/explore/xxx
+        :return: 作品详情字典
+        """
+        data: Dict[str, Any] = {}
+        if work_id:
+            data["workId"] = work_id
+        if work_link:
+            data["workLink"] = work_link
+        return self._client.post(
+            "/story/api/redBookData/queryWork", data=data
+        )
 
     # ─── AI 作品 ────────────────────────────────────────────
 
@@ -97,15 +114,17 @@ class XiaohongshuAPI:
         page_size: int = 20,
         start_time: str = None,
         end_time: str = None,
+        source: str = None,
     ) -> dict:
         """
-        搜索关键词获取小红书 AI 作品（优质库）
+        搜索关键词获取小红书 AI 创作作品（优质库）
 
         :param keyword: 搜索关键词（必填）
         :param page_num: 页码，默认 1
         :param page_size: 每页条数，默认 20
-        :param start_time: 开始时间
-        :param end_time: 结束时间
+        :param start_time: 起始时间，格式 "2026-06-01 00:00:00"
+        :param end_time: 结束时间，格式 "2026-06-02 00:00:00"
+        :param source: 来源平台（可选）
         :return: 搜索结果字典
         """
         data: Dict[str, Any] = {
@@ -117,4 +136,8 @@ class XiaohongshuAPI:
             data["startTime"] = start_time
         if end_time is not None:
             data["endTime"] = end_time
-        return self._client.post("/story/api/parseWork/queryXhsAiMsgs", data=data)
+        if source is not None:
+            data["source"] = source
+        return self._client.post(
+            "/story/api/parseWork/queryAiMsgs", data=data
+        )

{redfox-python-sdk-0.2.0 → redfox-python-sdk-0.2.1}/redfox_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: redfox-python-sdk
-Version: 0.2.0
+Version: 0.2.1
 Summary: RedFox 红狐数据平台 Python SDK
 Home-page: https://redfox.hk
 Author: RedFox

{redfox-python-sdk-0.2.0 → redfox-python-sdk-0.2.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="redfox-python-sdk",
-    version="0.2.0",
+    version="0.2.1",
     description="RedFox 红狐数据平台 Python SDK",
     long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",

redfox-python-sdk-0.2.0/redfox/endpoints/bilibili.py

@@ -1,95 +0,0 @@
-"""哔哩哔哩平台 API 端点"""
-
-from typing import Optional, Dict, Any
-
-
-class BilibiliAPI:
-    """
-    哔哩哔哩平台 API 集合
-
-    包含 B 站账号查询、作品搜索、作品详情等接口。
-    """
-
-    def __init__(self, client):
-        self._client = client
-
-    def get_account(self, mid: str) -> dict:
-        """
-        获取哔哩哔哩账号信息（优质库）
-
-        :param mid: 账号 MID（B 站用户唯一 ID，必填）
-        :return: 账号信息字典
-        """
-        return self._client.post(
-            "/story/api/bili/data/accountDetail", data={"mid": mid}
-        )
-
-    def get_work(self, bvid: str) -> dict:
-        """
-        获取哔哩哔哩作品内容详情（优质库）
-
-        :param bvid: 作品 BV ID
-        :return: 作品详情字典
-        """
-        return self._client.post(
-            "/story/api/bili/data/workDetail", data={"bvid": bvid}
-        )
-
-    def search_users(
-        self,
-        keyword: str,
-        page_num: int = 1,
-        order: str = None,
-    ) -> dict:
-        """
-        搜索关键词获取哔哩哔哩账号（优质库）
-
-        :param keyword: 搜索关键词（必填）
-        :param page_num: 页码，默认 1
-        :param order: 排序方式
-        :return: 搜索结果字典
-        """
-        data: Dict[str, Any] = {"keyword": keyword, "page": str(page_num)}
-        if order is not None:
-            data["order"] = order
-        return self._client.post("/story/api/bili/data/accountSearch", data=data)
-
-    def search_articles(
-        self,
-        keyword: str,
-        page_num: int = 1,
-        order: str = None,
-    ) -> dict:
-        """
-        搜索关键词获取哔哩哔哩作品（优质库）
-
-        :param keyword: 搜索关键词（必填）
-        :param page_num: 页码，默认 1
-        :param order: 排序方式
-        :return: 搜索结果字典
-        """
-        data: Dict[str, Any] = {"keyword": keyword, "page": str(page_num)}
-        if order is not None:
-            data["order"] = order
-        return self._client.post("/story/api/bili/data/workSearch", data=data)
-
-    def get_user_works(
-        self,
-        mid: str,
-        page_num: int = 1,
-        page_size: int = 30,
-    ) -> dict:
-        """
-        获取哔哩哔哩账号作品列表（优质库）
-
-        :param mid: 账号 MID（必填）
-        :param page_num: 页码，默认 1
-        :param page_size: 每页条数，默认 30
-        :return: 作品列表字典
-        """
-        data: Dict[str, Any] = {
-            "mid": mid,
-            "page": str(page_num),
-            "pageSize": str(page_size),
-        }
-        return self._client.post("/story/api/bili/data/accountWorkList", data=data)

redfox-python-sdk-0.2.0/redfox/endpoints/doubao_video.py

@@ -1,59 +0,0 @@
-"""豆包视频生成工具 API 端点"""
-
-from typing import Optional, Dict, Any
-
-
-class DoubaoVideoAPI:
-    """
-    豆包视频生成工具 API 集合
-
-    基于 Seedance 2.0 模型，支持文生视频。
-    """
-
-    def __init__(self, client):
-        self._client = client
-
-    def submit(
-        self,
-        prompt: str,
-        model: str = "doubao-seedance-2-0-250528",
-        resolution: str = "720p",
-        ratio: str = "16:9",
-        duration: int = 5,
-        seed: int = None,
-        generate_audio: bool = True,
-    ) -> dict:
-        """
-        提交 Seedance 2.0 视频生成任务
-
-        :param prompt: 视频生成提示词（必填）
-        :param model: 模型名称
-        :param resolution: 分辨率，如 720p
-        :param ratio: 宽高比，如 16:9
-        :param duration: 时长（秒），如 5
-        :param seed: 随机种子
-        :param generate_audio: 是否生成音频
-        :return: 包含 taskId 的字典
-        """
-        data: Dict[str, Any] = {
-            "prompt": prompt,
-            "model": model,
-            "resolution": resolution,
-            "ratio": ratio,
-            "duration": duration,
-            "generateAudio": generate_audio,
-        }
-        if seed is not None:
-            data["seed"] = seed
-        return self._client.post("/story/api/parseWork/videoGen/submit", data=data)
-
-    def result(self, task_id: str) -> dict:
-        """
-        查询 Seedance 2.0 视频生成任务结果
-
-        :param task_id: 任务 ID（由 submit 接口返回）
-        :return: 任务结果字典，包含 status/videoUrl/failReason 等
-        """
-        return self._client.post(
-            "/story/api/parseWork/videoGen/result", data={"taskId": task_id}
-        )