fiuai-sdk-python 0.16.1__tar.gz → 0.16.3__tar.gz

{fiuai_sdk_python-0.16.1 → fiuai_sdk_python-0.16.3}/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.16.3] - 2026-07-19
+
+### Added
+- `FiuaiSDK.internal_create` 支持单请求 `timeout`，用于覆盖慢写操作的客户端默认超时。
+
 ## [0.16.1] - 2026-07-18
 
 ### Fixed

{fiuai_sdk_python-0.16.1 → fiuai_sdk_python-0.16.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fiuai_sdk_python
-Version: 0.16.1
+Version: 0.16.3
 Summary: FiuAI Python SDK - 企业级AI服务集成开发工具包
 Project-URL: Homepage, https://github.com/fiuai/fiuai-sdk-python
 Project-URL: Documentation, https://github.com/fiuai/fiuai-sdk-python#readme

{fiuai_sdk_python-0.16.1 → fiuai_sdk_python-0.16.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fiuai_sdk_python"
-version = "0.16.1"
+version = "0.16.3"
 description = "FiuAI Python SDK - 企业级AI服务集成开发工具包"
 readme = "README.md"
 requires-python = ">=3.12"

{fiuai_sdk_python-0.16.1 → fiuai_sdk_python-0.16.3}/src/fiuai_sdk_python/__init__.py

@@ -18,7 +18,7 @@ from .error_code import (
 )
 from .resp import ApiError, ApiResponse, parse_response
 
-__version__ = "0.16.1"
+__version__ = "0.16.3"
 
 __all__ = [
     'FiuaiSDK',

{fiuai_sdk_python-0.16.1 → fiuai_sdk_python-0.16.3}/src/fiuai_sdk_python/client.py

@@ -299,13 +299,30 @@ class FiuaiSDK(object):
 
 
    
-    def internal_post_req(self, uri, postdata={}, extra_headers: Optional[Dict[str, Any]] = None) -> ApiResponse:
+    def internal_post_req(
+        self,
+        uri: str,
+        postdata: Optional[Dict[str, Any]] = None,
+        extra_headers: Optional[Dict[str, Any]] = None,
+        *,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> ApiResponse:
+        """调用 internal POST 接口，并允许慢写操作覆盖本次请求超时。
+
+        ``timeout`` 未提供时沿用客户端全局配置；该方法不自动重试 POST 请求。
+        网络超时仍按 SDK 契约返回状态为 504 的结构化 ``ApiResponse``。
+        """
         headers = self._get_merged_headers(extra_headers)
+        request_kwargs: Dict[str, Any] = {
+            "data": postdata or {},
+            "headers": headers,
+        }
+        if timeout is not None:
+            request_kwargs["timeout"] = timeout
         return self._safe_request(
             "POST",
             self.url + '/api/v2/internal/' + uri.lstrip('/'),
-            data=postdata,
-            headers=headers,
+            **request_kwargs,
         )
 
     def internal_get_req(self, uri, params={}, extra_headers: Optional[Dict[str, Any]] = None) -> ApiResponse:
@@ -317,13 +334,32 @@ class FiuaiSDK(object):
             headers=headers,
         )
 
-    def internal_create(self, data={}, auto_submit: bool = False, extra_headers: Optional[Dict[str, Any]] = None) -> ApiResponse:
+    def internal_create(
+        self,
+        data={},
+        auto_submit: bool = False,
+        extra_headers: Optional[Dict[str, Any]] = None,
+        *,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> ApiResponse:
+        """创建文档，并允许慢写操作覆盖本次请求超时。
+
+        ``timeout`` 未提供时沿用客户端全局配置；该方法不自动重试 POST 请求。
+        """
         headers = self._get_merged_headers(extra_headers)
+        request_kwargs: Dict[str, Any] = {
+            "data": {
+                "data": json.dumps(data, ensure_ascii=False),
+                "auto_submit": auto_submit,
+            },
+            "headers": headers,
+        }
+        if timeout is not None:
+            request_kwargs["timeout"] = timeout
         return self._safe_request(
             "POST",
             self.url + '/api/v2/internal/doctype/create',
-            data={"data": json.dumps(data, ensure_ascii=False), "auto_submit": auto_submit},
-            headers=headers,
+            **request_kwargs,
         )
 
     def internal_get(self, doctype, name, fields=None, filters=None, extra_headers: Optional[Dict[str, Any]] = None) -> ApiResponse: