ixspy-ai-api 1.0.1__tar.gz

ixspy_ai_api-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IXSPY Team
+
+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.

ixspy_ai_api-1.0.1/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: ixspy-ai-api
+Version: 1.0.1
+Summary: A client of IXSPY AI  Api
+Home-page: https://github.com/ixspyinc/ixspy-ai-api-python
+Author: IXSPY Team
+Author-email: tech@ixspy.com
+License: MIT
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+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: Programming Language :: Python :: 3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
+# IXSPY AI API
+
+IXSPY AI API V1.0 official python version
+
+## README.md
+
+## Installation
+
+1. pypi install
+```BASH
+pip install ixspy-ai-api
+```
+
+2. Source code install
+```BASH
+git clone https://github.com/ixspyinc/ixspy-ai-api-python.git
+cd ixspy-ai-api-python
+python setup.py install
+```
+
+## Usage
+
+Basic usage
+```python
+import os
+import sys
+from ixspy_ai_api import ImageClient
+
+# 分步骤调用, 任务方法和参数都已约定好
+
+API_KEY = 'YOUR_KEY'
+FOLDER_PATH = os.path.dirname(os.path.abspath(sys.argv[0])) + os.sep
+original_image_path = FOLDER_PATH + 'images/speaker.jpg'
+
+client = ImageClient(api_key=API_KEY)
+
+task_id = client.create_custom_composition(
+    original_image=original_image_path,
+    prompt="移除产品背景，只保留白色背景产品图",
+)
+print(f"任务ID: {task_id}")
+
+# 轮询等待完成
+result = client.wait_for_completion(task_id, poll_interval=3, timeout=180)
+
+# 可和预生成的图片 examples/images/demo_result_create_custom_composition.png 对比
+print("标清图URL:", result['sd_image_url'])
+
+# 高清圖需要額外時間,這裏選擇多等待半分鐘
+print('等待半分钟后获取高清图')
+time.sleep(30)
+
+# 获取高清图
+hd_url = client.get_hd_image(task_id)
+print("高清图URL:", hd_url)
+
+```
+
+Advance use
+
+For detailed usage, please refer to the files in the /examples directory.
+
+
+
+## API document
+https://img.ixspy.com/api-doc.html

ixspy_ai_api-1.0.1/README.md

@@ -0,0 +1,66 @@
+# IXSPY AI API
+
+IXSPY AI API V1.0 official python version
+
+## README.md
+
+## Installation
+
+1. pypi install
+```BASH
+pip install ixspy-ai-api
+```
+
+2. Source code install
+```BASH
+git clone https://github.com/ixspyinc/ixspy-ai-api-python.git
+cd ixspy-ai-api-python
+python setup.py install
+```
+
+## Usage
+
+Basic usage
+```python
+import os
+import sys
+from ixspy_ai_api import ImageClient
+
+# 分步骤调用, 任务方法和参数都已约定好
+
+API_KEY = 'YOUR_KEY'
+FOLDER_PATH = os.path.dirname(os.path.abspath(sys.argv[0])) + os.sep
+original_image_path = FOLDER_PATH + 'images/speaker.jpg'
+
+client = ImageClient(api_key=API_KEY)
+
+task_id = client.create_custom_composition(
+    original_image=original_image_path,
+    prompt="移除产品背景，只保留白色背景产品图",
+)
+print(f"任务ID: {task_id}")
+
+# 轮询等待完成
+result = client.wait_for_completion(task_id, poll_interval=3, timeout=180)
+
+# 可和预生成的图片 examples/images/demo_result_create_custom_composition.png 对比
+print("标清图URL:", result['sd_image_url'])
+
+# 高清圖需要額外時間,這裏選擇多等待半分鐘
+print('等待半分钟后获取高清图')
+time.sleep(30)
+
+# 获取高清图
+hd_url = client.get_hd_image(task_id)
+print("高清图URL:", hd_url)
+
+```
+
+Advance use
+
+For detailed usage, please refer to the files in the /examples directory.
+
+
+
+## API document
+https://img.ixspy.com/api-doc.html

ixspy_ai_api-1.0.1/ixspy_ai_api/__init__.py

@@ -0,0 +1,3 @@
+from .ai_client import AIClient, APIError
+from .image_client import ImageClient
+from .video_client import VideoClient

ixspy_ai_api-1.0.1/ixspy_ai_api/ai_client.py

@@ -0,0 +1,150 @@
+"""
+AI 图像/视频生成 Python SDK
+- 基类: AIClient (通用请求、认证、图片上传)
+- 图片客户端: ImageClient (9种作图、状态轮询、高清图、任务列表)
+- 视频客户端: VideoClient (视频生成、状态轮询、任务列表)
+"""
+
+import os
+import time
+from typing import Dict, Any, List, Optional, Union
+from pathlib import Path
+
+import requests
+
+
+class APIError(Exception):
+    """API 调用异常"""
+    def __init__(self, code: int, message: str, time: int):
+        self.code = code
+        self.message = message
+        self.time = time
+        super().__init__(f"API Error {code}: {message}")
+
+
+class AIClient:
+    """AI 服务基础客户端，封装通用 HTTP 请求和图片上传"""
+
+    BASE_URL = "https://ixspy.com/ai-tool/api"
+
+    def __init__(self, api_key: str, base_url: Optional[str] = None):
+        """
+        初始化基础客户端
+
+        Args:
+            api_key: API 密钥，从控制台获取
+            base_url: 可选的自定义基础地址
+        """
+        self.api_key = api_key
+        self.base_url = (base_url or self.BASE_URL).rstrip('/')
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {self.api_key}"
+        })
+
+    def _request(self, method: str, endpoint: str, **kwargs) -> Dict[str, Any]:
+        """
+        发送 HTTP 请求并解析统一响应格式
+
+        Returns:
+            响应中的 data 字段
+
+        Raises:
+            APIError: 当 error.code != 0 时抛出
+        """
+        url = f"{self.base_url}{endpoint}"
+        # 根据请求类型自动设置 Content-Type
+        if 'files' in kwargs:
+            # multipart/form-data，让 requests 自动处理
+            pass
+        elif 'json' in kwargs:
+            kwargs.setdefault('headers', {})['Content-Type'] = 'application/json'
+        elif 'data' in kwargs and not kwargs.get('files'):
+            # application/x-www-form-urlencoded
+            kwargs.setdefault('headers', {})['Content-Type'] = 'application/x-www-form-urlencoded'
+
+        response = self.session.request(method, url, **kwargs)
+        try:
+            resp_json = response.json()
+        except ValueError:
+            raise APIError(-1, f"Invalid JSON response: {response.text[:200]}", 0)
+
+        error = resp_json.get('error', {})
+        code = error.get('code', -1)
+        if code != 0:
+            raise APIError(
+                code=code,
+                message=error.get('message', 'Unknown error'),
+                time=error.get('time', 0)
+            )
+        return resp_json.get('data', {})
+
+    # ---------- 图片上传（公用） ----------
+    def upload_image_file(self, file_path: Union[str, Path]) -> str:
+        """
+        上传本地图片文件（文件模式）
+
+        Args:
+            file_path: 本地图片路径
+
+        Returns:
+            CDN 图片 URL
+        """
+        file_path = str(file_path)
+        with open(file_path, 'rb') as f:
+            files = {'image': (os.path.basename(file_path), f)}
+            data = self._request('POST', '/v1/images/upload', files=files)
+        return data['url']
+
+    def upload_image_base64(self, base64_str: str) -> str:
+        """
+        上传 Base64 编码的图片（Base64 模式）
+
+        Args:
+            base64_str: Base64 字符串，可带 data:image/... 前缀
+
+        Returns:
+            CDN 图片 URL
+        """
+        payload = {"image_base64": base64_str}
+        data = self._request('POST', '/v1/images/upload', json=payload)
+        return data['url']
+
+    def _prepare_single_image(self, image_input: Union[str, Path]) -> str:
+        """
+        将单个图片输入标准化为 CDN URL（自动上传本地文件或 Base64）
+
+        Args:
+            image_input: 本地路径、Base64 字符串或已有 URL
+
+        Returns:
+            CDN URL
+        """
+        input_str = str(image_input)
+        # 已经是 URL
+        if input_str.startswith(('http://', 'https://')):
+            return input_str
+        # 可能是 Base64
+        if input_str.startswith('data:image') or (len(input_str) > 100 and '/' not in input_str[:50]):
+            return self.upload_image_base64(input_str)
+        # 本地文件路径
+        if os.path.exists(input_str):
+            return self.upload_image_file(input_str)
+        # 未知格式，直接返回原值（让服务端判断）
+        return input_str
+
+    def _prepare_images(self, images: Union[str, Path, List[Union[str, Path]]]) -> Union[str, List[str]]:
+        """
+        批量标准化图片输入
+
+        Args:
+            images: 单个图片或图片列表
+
+        Returns:
+            单个 URL 字符串或 URL 列表
+        """
+        if isinstance(images, (str, Path)):
+            return self._prepare_single_image(images)
+        if isinstance(images, list):
+            return [self._prepare_single_image(img) for img in images]
+        raise ValueError("images 必须是字符串、Path对象或列表")

ixspy_ai_api-1.0.1/ixspy_ai_api/image_client.py

@@ -0,0 +1,309 @@
+"""
+AI 图像/视频生成 Python SDK
+- 基类: AIClient (通用请求、认证、图片上传)
+- 图片客户端: ImageClient (9种作图、状态轮询、高清图、任务列表)
+- 视频客户端: VideoClient (视频生成、状态轮询、任务列表)
+"""
+
+import os
+import time
+from typing import Dict, Any, List, Optional, Union
+from pathlib import Path
+from ixspy_ai_api import AIClient, APIError
+
+class ImageClient(AIClient):
+    """AI 图像生成客户端"""
+
+    # 自由构图-多图
+    TYPE_CUSTOM_COMPOSITION_MULTI = 'custom_composition_multi'
+
+    # 自由构图
+    TYPE_CUSTOM_COMPOSITION = 'custom_composition'
+
+    # 场景替换
+    TYPE_SCENE_REPLACEMENT = 'scene_replacement'
+
+    # 商品替换
+    TYPE_PRODUCT_REPLACEMENT = 'product_replacement'
+
+    # 商品换色
+    TYPE_PRODUCT_RECOLORING = 'product_recoloring'
+
+    # 局部重绘
+    TYPE_PARTIAL_REDRAW = 'partial_redraw'
+
+    # 智能延展
+    TYPE_SMART_EXPAND = 'smart_expand'
+
+    # 图片翻译
+    TYPE_TRANSLATION = 'translation'
+
+    # AI超清-2K
+    TYPE_AI_UPSCALE_2K = 'ai_upscale_2k'
+
+    # ---------- 发起作图任务（通用 + 便捷方法） ----------
+    def create_task(self, task_type: str, **kwargs) -> int:
+        """
+        通用作图方法
+
+        Args:
+            task_type: 作图类型，可选值见文档
+            **kwargs: 特定参数，需包含 original_image 及其他类型所需参数
+
+        Returns:
+            task_id
+        """
+        # 预处理 original_image
+        if 'original_image' in kwargs:
+            kwargs['original_image'] = self._prepare_images(kwargs['original_image'])
+        # 预处理 reference_image（某些类型需要）
+        if 'reference_image' in kwargs:
+            kwargs['reference_image'] = self._prepare_single_image(kwargs['reference_image'])
+
+        endpoint = f"/v1/images/generations/{task_type}"
+        data = self._request('POST', endpoint, json=kwargs)
+        return int(data['task_id'])
+
+    # ----- 自由构图-多图 -----
+    def create_custom_composition_multi(self,
+                                        original_images: List[Union[str, Path]],
+                                        prompt: str,
+                                        ratios: str = "auto") -> int:
+        """
+        自由构图-多图（支持最多5张图片）
+
+        :param original_images: 原图列表（文件路径、URL或Base64），最多5张
+        :param prompt: 画面描述
+        :param ratios: 图片比例，默认 "auto"
+        :return: 任务ID
+        """
+        return self.create_task(
+            ImageClient.TYPE_CUSTOM_COMPOSITION_MULTI,
+            original_image=original_images,
+            prompt=prompt,
+            ratios=ratios
+        )
+
+    # ----- 自由构图 -----
+    def create_custom_composition(self,
+                                  original_image: Union[str, Path],
+                                  prompt: str,
+                                  ratios: str = "auto") -> int:
+        """
+        自由构图
+
+        :param original_image: 原图（文件路径、URL或Base64）
+        :param prompt: 画面描述
+        :param ratios: 图片比例，默认 "auto"
+        :return: 任务ID
+        """
+        return self.create_task(
+            ImageClient.TYPE_CUSTOM_COMPOSITION,
+            original_image=original_image,
+            prompt=prompt,
+            ratios=ratios
+        )
+
+    # ----- 场景替换 -----
+    def create_scene_replacement(self,
+                                 original_image: Union[str, Path],
+                                 ratios: str = "auto",
+                                 prompt: Optional[str] = None,
+                                 reference_image: Optional[Union[str, Path]] = None) -> int:
+        """
+        场景替换（prompt 和 reference_image 至少需要有一個有值）
+
+        :param original_image: 原图（文件路径、URL或Base64）
+        :param prompt: 场景描述文本
+        :param reference_image: 场景参考图（文件路径、URL或Base64）
+        :param ratios: 图片比例，默认 "auto"
+        :return: 任务ID
+        """
+        if (prompt is None)  and (reference_image is None):
+            raise ValueError("prompt 和 reference_image 不能同時爲空")
+        
+        payload = {"original_image": original_image, "ratios": ratios}
+        if prompt:
+            payload["prompt"] = prompt
+        if reference_image:
+            payload["reference_image"] = reference_image
+        return self.create_task(ImageClient.TYPE_SCENE_REPLACEMENT, **payload)
+
+    # ----- 商品替换 -----
+    def create_product_replacement(self,
+                                   original_image: Union[str, Path],
+                                   reference_image: Union[str, Path],
+                                   prompt: Optional[str] = None) -> int:
+        """
+        商品替换
+
+        :param original_image: 原图（文件路径、URL或Base64）
+        :param reference_image: 参考图，以此为背景（文件路径、URL或Base64）
+        :param prompt: 商品描述（可选）
+        :return: 任务ID
+        """
+        payload = {"original_image": original_image, "reference_image": reference_image}
+        if prompt:
+            payload["prompt"] = prompt
+        return self.create_task(ImageClient.TYPE_PRODUCT_REPLACEMENT, **payload)
+
+    # ----- 商品换色 -----
+    def create_product_recoloring(self,
+                                  original_image: Union[str, Path],
+                                  color: str) -> int:
+        """
+        商品换色
+
+        :param original_image: 原图（文件路径、URL或Base64）
+        :param color: 目标颜色，十六进制格式（含透明度），如 "#ff4500ff"
+        :return: 任务ID
+        """
+        return self.create_task(
+            "product_recoloring",
+            original_image=original_image,
+            color=color
+        )
+
+    # ----- 局部重绘 -----
+    def create_partial_redraw(self,
+                              original_image: Union[str, Path],
+                              prompt: str,
+                              reference_image: Optional[Union[str, Path]] = None) -> int:
+        """
+        局部重绘
+
+        :param original_image: 原图（文件路径、URL或Base64）
+        :param prompt: 描述如何重绘
+        :param reference_image: 参考图（可选，文件路径、URL或Base64）
+        :return: 任务ID
+        """
+        payload = {"original_image": original_image, "prompt": prompt}
+        if reference_image:
+            payload["reference_image"] = reference_image
+        return self.create_task(ImageClient.TYPE_PRODUCT_RECOLORING, **payload)
+
+    # ----- 智能延展 -----
+    def create_smart_expand(self,
+                            original_image: Union[str, Path],
+                            direction: str,
+                            ratios: str) -> int:
+        """
+        智能延展
+
+        :param original_image: 原图（文件路径、URL或Base64）
+        :param direction: 延展方向，如 "top_left", "auto" 等
+        :param ratios: 目标比例，如 "1:1", "16:9"
+        :return: 任务ID
+        """
+        return self.create_task(
+            ImageClient.TYPE_SMART_EXPAND,
+            original_image=original_image,
+            direction=direction,
+            ratios=ratios
+        )
+
+    # ----- 图片翻译 -----
+    def create_translation(self,
+                           original_image: Union[str, Path],
+                           source_language: str,
+                           target_language: str) -> int:
+        """
+        图片翻译
+
+        :param original_image: 原图（文件路径、URL或Base64）
+        :param source_language: 原语言，如 "auto", "Chinese"
+        :param target_language: 目标语言，如 "English"
+        :return: 任务ID
+        """
+        return self.create_task(
+            ImageClient.TYPE_TRANSLATION,
+            original_image=original_image,
+            source_language=source_language,
+            target_language=target_language
+        )
+
+    # ----- AI 超清-2K -----
+    def create_ai_upscale_2k(self, original_image: Union[str, Path]) -> int:
+        """
+        AI超清-2K（仅需原图）
+
+        :param original_image: 原图（文件路径、URL或Base64）
+        :return: 任务ID
+        """
+        return self.create_task(ImageClient.TYPE_AI_UPSCALE_2K, original_image=original_image)
+
+    # ---------- 查询作图结果 ----------
+    def get_task_status(self, task_id: int) -> Dict[str, Any]:
+        """查询单个作图任务状态"""
+        endpoint = f"/v1/images/generations/tasks/{task_id}"
+        return self._request('GET', endpoint)
+
+    # ---------- 获取高清图片 ----------
+    def get_hd_image(self, task_id: int) -> str:
+        """获取作图任务的高清图片 URL（任务需已完成）"""
+        endpoint = f"/v1/images/upscale/{task_id}"
+        data = self._request('GET', endpoint)
+        return data['hd_image_url']
+
+    # ---------- 获取作图任务列表 ----------
+    def list_tasks(self,
+                   page: int = 1,
+                   page_size: int = 20,
+                   status: Optional[str] = None,
+                   task_type: Optional[str] = None) -> Dict[str, Any]:
+        """获取作图任务列表，支持分页、状态和类型过滤"""
+        params = {"page": page, "page_size": page_size}
+        if status and status != 'all':
+            params["status"] = status
+        if task_type:
+            params["type"] = task_type
+        return self._request('GET', '/v1/images/tasks-list', params=params)
+
+    # ---------- 高级封装 ----------
+
+    # ---------- 轮询等待作图任务完成 ----------
+    def wait_for_completion(self, task_id: int, poll_interval: int = 3, timeout: int = 180) -> Dict[str, Any]:
+        start_time = time.time()
+        while True:
+            data = self.get_task_status(task_id)
+            status = data.get('status')
+            if status == 'completed':
+                return data
+            elif status == 'error':
+                raise APIError(1000, f"Task {task_id} failed")
+            elif status in ('queued', 'processing'):
+                if timeout and (time.time() - start_time) > timeout:
+                    raise APIError(1001, f"Task {task_id} timeout after {timeout}s")
+                time.sleep(poll_interval)
+            else:
+                raise APIError(1002, f"Unknown status: {status}")
+        '''
+        # 暫時註釋掉
+        start_time = time.time()
+        while True:
+            if time.time() - start_time > timeout:
+                raise APIError(-1, f"任务 {task_id} 轮询超时", 0)
+
+            data = self.get_task_status(task_id)
+            status = data.get('status')
+            if status == 'completed':
+                return data
+            if status == 'error':
+                raise APIError(-1, f"任务 {task_id} 执行失败", 0)
+            time.sleep(poll_interval)
+        '''
+
+    # ---------- 发起任务并等待完成 ----------
+    def generate(self, task_type: str, wait: bool = True,
+                 poll_interval: int = 3, timeout: Optional[int] = None,
+                 **params) -> Union[str, Dict[str, Any]]:
+        """
+        一键生成：发起任务并等待完成
+        注意：推荐使用专用方法 + wait_for_completion，此方法为通用便捷接口
+        """
+        task_id = self.create_task(task_type, **params)
+        if not wait:
+            return task_id
+        result = self.wait_for_completion(task_id, poll_interval, timeout)
+        result['task_id'] = task_id
+        return result

ixspy_ai_api-1.0.1/ixspy_ai_api/version.py

@@ -0,0 +1,4 @@
+import os
+
+__version__ = os.getenv("TAG", "0.0.0")
+VERSION = tuple(map(int, __version__.split('.')))

ixspy_ai_api-1.0.1/ixspy_ai_api/video_client.py

@@ -0,0 +1,69 @@
+"""
+AI 图像/视频生成 Python SDK
+- 基类: AIClient (通用请求、认证、图片上传)
+- 图片客户端: ImageClient (9种作图、状态轮询、高清图、任务列表)
+- 视频客户端: VideoClient (视频生成、状态轮询、任务列表)
+"""
+
+import os
+import time
+from typing import Dict, Any, List, Optional, Union
+from pathlib import Path
+from ixspy_ai_api import AIClient, APIError
+
+class VideoClient(AIClient):
+    """AI 视频生成客户端"""
+
+    # ---------- 发起视频任务 ----------
+    def create_video(self,
+                     original_images: List[Union[str, Path]],
+                     prompt: str) -> int:
+        """
+        发起视频生成任务（最多5张图）
+
+        Args:
+            original_images: 原始图片列表（本地路径/URL/Base64）
+            prompt: 视频画面描述
+
+        Returns:
+            task_id
+        """
+        prepared_images = self._prepare_images(original_images)
+        payload = {
+            "original_image": prepared_images,
+            "prompt": prompt
+        }
+        data = self._request('POST', '/v1/video/generations', json=payload)
+        return int(data['task_id'])
+
+    # ---------- 查询视频结果 ----------
+    def get_video_status(self, task_id: int) -> Dict[str, Any]:
+        """查询单个视频任务状态"""
+        endpoint = f"/v1/video/generations/tasks/{task_id}"
+        return self._request('GET', endpoint)
+
+    def wait_for_video_completion(self, task_id: int, poll_interval: int = 15, timeout: int = 600) -> Dict[str, Any]:
+        """轮询等待视频任务完成（建议间隔15-20秒）"""
+        start_time = time.time()
+        while True:
+            if time.time() - start_time > timeout:
+                raise APIError(-1, f"视频任务 {task_id} 轮询超时", 0)
+
+            data = self.get_video_status(task_id)
+            status = data.get('status')
+            if status == 'completed':
+                return data
+            if status == 'error':
+                raise APIError(-1, f"视频任务 {task_id} 执行失败", 0)
+            time.sleep(poll_interval)
+
+    # ---------- 获取视频任务列表 ----------
+    def list_video_tasks(self,
+                         page: int = 1,
+                         page_size: int = 20,
+                         status: Optional[str] = None) -> Dict[str, Any]:
+        """获取视频任务列表，支持分页和状态过滤"""
+        params = {"page": page, "page_size": page_size}
+        if status and status != 'all':
+            params["status"] = status
+        return self._request('GET', '/v1/video/tasks-list', params=params)

ixspy_ai_api-1.0.1/ixspy_ai_api.egg-info/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: ixspy-ai-api
+Version: 1.0.1
+Summary: A client of IXSPY AI  Api
+Home-page: https://github.com/ixspyinc/ixspy-ai-api-python
+Author: IXSPY Team
+Author-email: tech@ixspy.com
+License: MIT
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+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: Programming Language :: Python :: 3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary
+
+# IXSPY AI API
+
+IXSPY AI API V1.0 official python version
+
+## README.md
+
+## Installation
+
+1. pypi install
+```BASH
+pip install ixspy-ai-api
+```
+
+2. Source code install
+```BASH
+git clone https://github.com/ixspyinc/ixspy-ai-api-python.git
+cd ixspy-ai-api-python
+python setup.py install
+```
+
+## Usage
+
+Basic usage
+```python
+import os
+import sys
+from ixspy_ai_api import ImageClient
+
+# 分步骤调用, 任务方法和参数都已约定好
+
+API_KEY = 'YOUR_KEY'
+FOLDER_PATH = os.path.dirname(os.path.abspath(sys.argv[0])) + os.sep
+original_image_path = FOLDER_PATH + 'images/speaker.jpg'
+
+client = ImageClient(api_key=API_KEY)
+
+task_id = client.create_custom_composition(
+    original_image=original_image_path,
+    prompt="移除产品背景，只保留白色背景产品图",
+)
+print(f"任务ID: {task_id}")
+
+# 轮询等待完成
+result = client.wait_for_completion(task_id, poll_interval=3, timeout=180)
+
+# 可和预生成的图片 examples/images/demo_result_create_custom_composition.png 对比
+print("标清图URL:", result['sd_image_url'])
+
+# 高清圖需要額外時間,這裏選擇多等待半分鐘
+print('等待半分钟后获取高清图')
+time.sleep(30)
+
+# 获取高清图
+hd_url = client.get_hd_image(task_id)
+print("高清图URL:", hd_url)
+
+```
+
+Advance use
+
+For detailed usage, please refer to the files in the /examples directory.
+
+
+
+## API document
+https://img.ixspy.com/api-doc.html

ixspy_ai_api-1.0.1/ixspy_ai_api.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+setup.py
+ixspy_ai_api/__init__.py
+ixspy_ai_api/ai_client.py
+ixspy_ai_api/image_client.py
+ixspy_ai_api/version.py
+ixspy_ai_api/video_client.py
+ixspy_ai_api.egg-info/PKG-INFO
+ixspy_ai_api.egg-info/SOURCES.txt
+ixspy_ai_api.egg-info/dependency_links.txt
+ixspy_ai_api.egg-info/requires.txt
+ixspy_ai_api.egg-info/top_level.txt

ixspy_ai_api-1.0.1/ixspy_ai_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ixspy_ai_api-1.0.1/ixspy_ai_api.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2

ixspy_ai_api-1.0.1/ixspy_ai_api.egg-info/top_level.txt

@@ -0,0 +1 @@
+ixspy_ai_api

ixspy_ai_api-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ixspy_ai_api-1.0.1/setup.py

@@ -0,0 +1,39 @@
+import os
+import pathlib
+
+from setuptools import setup, find_packages
+
+HERE = pathlib.Path(__file__).parent.resolve()
+LONG_DESCRIPTION = (HERE / "README.md").read_text(encoding="utf8")
+LONG_DESC_TYPE = "text/markdown"
+
+try:
+      __version__ = os.environ.get('GITHUB_REF_NAME', '0.0.0')
+except:
+      __version__ = "0.0.0"
+
+VERSION = tuple(map(int, __version__.split('.')))
+CURR_VERSION = '.'.join(str(x) for x in VERSION)
+
+setup(name='ixspy-ai-api',
+      version=CURR_VERSION,
+      description='A client of IXSPY AI  Api',
+      long_description=LONG_DESCRIPTION,
+      long_description_content_type=LONG_DESC_TYPE,
+      author='IXSPY Team',
+      author_email='tech@ixspy.com',
+      url='https://github.com/ixspyinc/ixspy-ai-api-python',
+      license='MIT',
+      keywords='',
+      packages=find_packages(),
+      install_requires=['requests >= 2'],
+      classifiers=["Programming Language :: Python :: 3.5",
+                   "Programming Language :: Python :: 3.6",
+                   "Programming Language :: Python :: 3.7",
+                   "Programming Language :: Python :: 3.8",
+                   "Programming Language :: Python :: 3.9",
+                   "Programming Language :: Python :: 3.10",
+                   "Programming Language :: Python :: 3.11",
+                   "Programming Language :: Python :: 3.12",
+                   "Programming Language :: Python :: 3.13",]
+      )