chore: regen translate stream

Author: shuakami

README.md

@@ -24,7 +24,7 @@ print(result)
 ```
 
 > [!TIP]
-> 请使用与运行脚本一致的解释器安装依赖：执行 `python -m pip install uapi-sdk-python` 后直接 `python myip.py`。如果 VS Code / Pyright 报 “Import uapi could not be resolved”，将解释器切换到你的虚拟环境（例如 `.venv/Scripts/python.exe`）即可恢复补全。
+> 请使用与运行脚本相同的 Python 解释器安装依赖，例如执行 `python -m pip install uapi-sdk-python` 后再运行 `python main.py`。在 VS Code / Pyright 中若提示 “Import uapi could not be resolved”，将解释器切换到当前虚拟环境即可恢复补全。
 
 ## 特性
 
@@ -51,13 +51,13 @@ from uapi import UapiClient
 client = UapiClient("https://uapis.cn/api/v1", token="<TOKEN>")
 
 @lru_cache(maxsize=128)
-def cached_user(qq: str):
+def cached_lookup(qq: str):
     return client.social.get_social_qq_userinfo(qq=qq)
 
-print(cached_user("10001"))
+user = cached_lookup("10001")
 ```
 
-也可以结合 Redis/Memcached：先读缓存，未命中再调用 SDK，并把结果序列化回写缓存。
+也可以在 FastAPI / Django 项目里配合 Redis，将 SDK 的响应序列化后写入缓存，命中即直接返回。
 
 ### 注入自定义 httpx.Client
 
@@ -66,7 +66,7 @@ import httpx
 from httpx import Auth
 from uapi import UapiClient
 
-class Bearer(Auth):
+class StaticToken(Auth):
     def __init__(self, token: str):
         self.token = token
     def auth_flow(self, request):
@@ -76,17 +76,17 @@ class Bearer(Auth):
 http_client = httpx.Client(
     timeout=5,
     transport=httpx.HTTPTransport(retries=3),
-    event_hooks={"request": [lambda req: print("->", req.url)]},
+    event_hooks={"request": [lambda request: print("->", request.url)]},
 )
 
 client = UapiClient(
     "https://uapis.cn/api/v1",
     client=http_client,
-    auth=Bearer("<TOKEN>"),
+    auth=StaticToken("<TOKEN>"),
 )
 ```
 
-这样可以把企业代理、日志、APM、重试策略统统放进同一个 `httpx.Client`，SDK 会原样复用。
+通过自定义 `client` / `transport` / `auth`，可以无缝植入代理、重试策略或 APM 埋点。
 
 ## 错误模型概览
 

internal/.openapi-generator/FILES

@@ -264,6 +264,9 @@ docs/PostTextMd5Request.md
 docs/PostTextMd5Verify200Response.md
 docs/PostTextMd5Verify400Response.md
 docs/PostTextMd5VerifyRequest.md
+docs/PostTranslateStream400Response.md
+docs/PostTranslateStream500Response.md
+docs/PostTranslateStreamRequest.md
 docs/PostTranslateText200Response.md
 docs/PostTranslateText400Response.md
 docs/PostTranslateText500Response.md
@@ -284,6 +287,9 @@ setup.cfg
 setup.py
 test-requirements.txt
 test/__init__.py
+test/test_post_translate_stream400_response.py
+test/test_post_translate_stream500_response.py
+test/test_post_translate_stream_request.py
 tox.ini
 uapi/__init__.py
 uapi/api/__init__.py
@@ -559,6 +565,9 @@ uapi/models/post_text_md5_request.py
 uapi/models/post_text_md5_verify200_response.py
 uapi/models/post_text_md5_verify400_response.py
 uapi/models/post_text_md5_verify_request.py
+uapi/models/post_translate_stream400_response.py
+uapi/models/post_translate_stream500_response.py
+uapi/models/post_translate_stream_request.py
 uapi/models/post_translate_text200_response.py
 uapi/models/post_translate_text400_response.py
 uapi/models/post_translate_text500_response.py

internal/README.md

@@ -156,6 +156,7 @@ Class | Method | HTTP request | Description
 *TextApi* | [**post_text_md5_verify**](docs/TextApi.md#post_text_md5_verify) | **POST** /text/md5/verify | 校验MD5哈希值
 *TranslateApi* | [**get_ai_translate_languages**](docs/TranslateApi.md#get_ai_translate_languages) | **GET** /ai/translate/languages | 获取AI翻译支持的语言和配置
 *TranslateApi* | [**post_ai_translate**](docs/TranslateApi.md#post_ai_translate) | **POST** /ai/translate | AI智能翻译
+*TranslateApi* | [**post_translate_stream**](docs/TranslateApi.md#post_translate_stream) | **POST** /translate/stream | 流式翻译（中英互译）
 *TranslateApi* | [**post_translate_text**](docs/TranslateApi.md#post_translate_text) | **POST** /translate/text | 多语言文本翻译
 *WebParseApi* | [**get_web_tomarkdown_async_status**](docs/WebParseApi.md#get_web_tomarkdown_async_status) | **GET** /web/tomarkdown/async/{task_id} | 查询网页转换任务状态和结果
 *WebParseApi* | [**get_webparse_extractimages**](docs/WebParseApi.md#get_webparse_extractimages) | **GET** /webparse/extractimages | 提取网页中的所有图片
@@ -417,6 +418,9 @@ Class | Method | HTTP request | Description
  - [PostTextMd5Verify200Response](docs/PostTextMd5Verify200Response.md)
  - [PostTextMd5Verify400Response](docs/PostTextMd5Verify400Response.md)
  - [PostTextMd5VerifyRequest](docs/PostTextMd5VerifyRequest.md)
+ - [PostTranslateStream400Response](docs/PostTranslateStream400Response.md)
+ - [PostTranslateStream500Response](docs/PostTranslateStream500Response.md)
+ - [PostTranslateStreamRequest](docs/PostTranslateStreamRequest.md)
  - [PostTranslateText200Response](docs/PostTranslateText200Response.md)
  - [PostTranslateText400Response](docs/PostTranslateText400Response.md)
  - [PostTranslateText500Response](docs/PostTranslateText500Response.md)

internal/docs/PostTranslateStream400Response.md

@@ -0,0 +1,30 @@
+# PostTranslateStream400Response
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**error** | **str** | 错误描述 | [optional] 
+**code** | **str** | 错误码 | [optional] 
+
+## Example
+
+```python
+from uapi.models.post_translate_stream400_response import PostTranslateStream400Response
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of PostTranslateStream400Response from a JSON string
+post_translate_stream400_response_instance = PostTranslateStream400Response.from_json(json)
+# print the JSON string representation of the object
+print(PostTranslateStream400Response.to_json())
+
+# convert the object into a dict
+post_translate_stream400_response_dict = post_translate_stream400_response_instance.to_dict()
+# create an instance of PostTranslateStream400Response from a dict
+post_translate_stream400_response_from_dict = PostTranslateStream400Response.from_dict(post_translate_stream400_response_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

internal/docs/PostTranslateStream500Response.md

@@ -0,0 +1,30 @@
+# PostTranslateStream500Response
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**error** | **str** | 错误描述 | [optional] 
+**code** | **str** |  | [optional] 
+
+## Example
+
+```python
+from uapi.models.post_translate_stream500_response import PostTranslateStream500Response
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of PostTranslateStream500Response from a JSON string
+post_translate_stream500_response_instance = PostTranslateStream500Response.from_json(json)
+# print the JSON string representation of the object
+print(PostTranslateStream500Response.to_json())
+
+# convert the object into a dict
+post_translate_stream500_response_dict = post_translate_stream500_response_instance.to_dict()
+# create an instance of PostTranslateStream500Response from a dict
+post_translate_stream500_response_from_dict = PostTranslateStream500Response.from_dict(post_translate_stream500_response_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

internal/docs/PostTranslateStreamRequest.md

@@ -0,0 +1,32 @@
+# PostTranslateStreamRequest
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**query** | **str** | 待翻译的文本内容 | 
+**to_lang** | **str** | 目标语言，支持：中文、英文 | 
+**from_lang** | **str** | 源语言，支持：中文、英文、auto（自动检测）。默认为auto | [optional] [default to 'auto']
+**tone** | **str** | 语气参数，可选 | [optional] 
+
+## Example
+
+```python
+from uapi.models.post_translate_stream_request import PostTranslateStreamRequest
+
+# TODO update the JSON string below
+json = "{}"
+# create an instance of PostTranslateStreamRequest from a JSON string
+post_translate_stream_request_instance = PostTranslateStreamRequest.from_json(json)
+# print the JSON string representation of the object
+print(PostTranslateStreamRequest.to_json())
+
+# convert the object into a dict
+post_translate_stream_request_dict = post_translate_stream_request_instance.to_dict()
+# create an instance of PostTranslateStreamRequest from a dict
+post_translate_stream_request_from_dict = PostTranslateStreamRequest.from_dict(post_translate_stream_request_dict)
+```
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

internal/docs/TranslateApi.md

@@ -6,6 +6,7 @@ Method | HTTP request | Description
 ------------- | ------------- | -------------
 [**get_ai_translate_languages**](TranslateApi.md#get_ai_translate_languages) | **GET** /ai/translate/languages | 获取AI翻译支持的语言和配置
 [**post_ai_translate**](TranslateApi.md#post_ai_translate) | **POST** /ai/translate | AI智能翻译
+[**post_translate_stream**](TranslateApi.md#post_translate_stream) | **POST** /translate/stream | 流式翻译（中英互译）
 [**post_translate_text**](TranslateApi.md#post_translate_text) | **POST** /translate/text | 多语言文本翻译
 
 
@@ -162,6 +163,91 @@ No authorization required
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
+# **post_translate_stream**
+> str post_translate_stream(post_translate_stream_request)
+
+流式翻译（中英互译）
+
+想让翻译结果像打字机一样逐字显示出来？这个流式翻译接口能实现这种效果。
+
+## 功能概述
+不同于传统翻译API一次性返回完整结果，这个接口会实时地、一个字一个字地把翻译内容推给你（就像ChatGPT回复消息那样），非常适合用在聊天应用、直播字幕等需要即时反馈的场景。
+
+## 它能做什么
+- **中英互译**：支持中文和英文之间的双向翻译
+- **自动识别**：不确定源语言？设置为 `auto` 让我们自动检测
+- **逐字返回**：翻译结果会像打字机一样逐字流式返回，用户体验更流畅
+- **音频朗读**：部分翻译结果会附带音频链接，方便朗读
+
+## 支持的语言
+目前专注于中英互译，支持以下选项：
+- `中文`（简体/繁体）
+- `英文`
+- `auto`（自动检测）
+
+### Example
+
+
+```python
+import uapi
+from uapi.models.post_translate_stream_request import PostTranslateStreamRequest
+from uapi.rest import ApiException
+from pprint import pprint
+
+# Defining the host is optional and defaults to https://uapis.cn/api/v1
+# See configuration.py for a list of all supported configuration parameters.
+configuration = uapi.Configuration(
+    host = "https://uapis.cn/api/v1"
+)
+
+
+# Enter a context with an instance of the API client
+with uapi.ApiClient(configuration) as api_client:
+    # Create an instance of the API class
+    api_instance = uapi.TranslateApi(api_client)
+    post_translate_stream_request = uapi.PostTranslateStreamRequest() # PostTranslateStreamRequest | 包含翻译参数的JSON对象
+
+    try:
+        # 流式翻译（中英互译）
+        api_response = api_instance.post_translate_stream(post_translate_stream_request)
+        print("The response of TranslateApi->post_translate_stream:\n")
+        pprint(api_response)
+    except Exception as e:
+        print("Exception when calling TranslateApi->post_translate_stream: %s\n" % e)
+```
+
+
+
+### Parameters
+
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **post_translate_stream_request** | [**PostTranslateStreamRequest**](PostTranslateStreamRequest.md)| 包含翻译参数的JSON对象 | 
+
+### Return type
+
+**str**
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: text/event-stream, application/json
+
+### HTTP response details
+
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | SSE流式响应。Content-Type为text/event-stream |  -  |
+**400** | 请求参数错误 |  -  |
+**500** | 翻译服务错误 |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
 # **post_translate_text**
 > PostTranslateText200Response post_translate_text(to_lang, post_translate_text_request)
 

internal/test/test_post_translate_stream400_response.py

@@ -0,0 +1,52 @@
+# coding: utf-8
+
+"""
+    UAPI
+
+    UAPI 官方接口文档
+
+    The version of the OpenAPI document: 1.0.0
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+import unittest
+
+from uapi.models.post_translate_stream400_response import PostTranslateStream400Response
+
+class TestPostTranslateStream400Response(unittest.TestCase):
+    """PostTranslateStream400Response unit test stubs"""
+
+    def setUp(self):
+        pass
+
+    def tearDown(self):
+        pass
+
+    def make_instance(self, include_optional) -> PostTranslateStream400Response:
+        """Test PostTranslateStream400Response
+            include_optional is a boolean, when False only required
+            params are included, when True both required and
+            optional params are included """
+        # uncomment below to create an instance of `PostTranslateStream400Response`
+        """
+        model = PostTranslateStream400Response()
+        if include_optional:
+            return PostTranslateStream400Response(
+                error = 'Missing required parameter',
+                code = 'MISSING_QUERY'
+            )
+        else:
+            return PostTranslateStream400Response(
+        )
+        """
+
+    def testPostTranslateStream400Response(self):
+        """Test PostTranslateStream400Response"""
+        # inst_req_only = self.make_instance(include_optional=False)
+        # inst_req_and_optional = self.make_instance(include_optional=True)
+
+if __name__ == '__main__':
+    unittest.main()