feat: support OCR handwriting recognition feature

Author: mengqian

src/zai/api_resource/file_parser/handwriting_ocr.py

@@ -24,6 +24,7 @@
 
 __all__ = ["HandwritingOCR"]
 
+
 class HandwritingOCR(BaseAPI):
 
     def __init__(self, client: "ZaiClient") -> None:
@@ -34,7 +35,7 @@ def handwriting_ocr(
             *,
             file: FileTypes,
             tool_type: Literal["hand_write"],
-            language_type: str = None,   # optional
+            language_type: str = None,  # optional
             extra_headers: Headers | None = None,
             extra_body: Body | None = None,
             timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
@@ -61,4 +62,4 @@ def handwriting_ocr(
                 extra_headers=extra_headers, extra_body=extra_body, timeout=timeout
             ),
             cast_type=HandwritingOCRResp,
-        )
+        )

src/zai/types/file_parser/handwriting_ocr_params.py

@@ -5,7 +5,8 @@
 
 __all__ = ["HandwritingOCRParams"]
 
+
 class HandwritingOCRParams(TypedDict, total=False):
     file: FileTypes  # Required
     tool_type: Literal["hand_write"]  # Required
-    language_type: str  # Optional
+    language_type: str  # Optional

src/zai/types/file_parser/handwriting_ocr_resp.py

@@ -5,19 +5,22 @@
 
 __all__ = ["HandwritingOCRResp"]
 
+
 class Location(BaseModel):
     left: int
     top: int
     width: int
     height: int
 
+
 class WordsResult(BaseModel):
     location: Location
     words: str
 
+
 class HandwritingOCRResp(BaseModel):
-    task_id: str                     # Task ID or Result ID
-    message: str                     # Status message
-    status: str                      # OCR task status
-    words_result_num: int            # Number of recognition results
-    words_result: Optional[List[WordsResult]] = None   # List of recognition resultst details (if any)
+    task_id: str  # Task ID or Result ID
+    message: str  # Status message
+    status: str  # OCR task status
+    words_result_num: int  # Number of recognition results
+    words_result: Optional[List[WordsResult]] = None  # List of recognition resultst details (if any)