volcengine-python-sdk 4.0.29__py2.py3-none-any.whl → 4.0.31__py2.py3-none-any.whl

volcenginesdkarkruntime/types/responses/response_stream_event.py

@@ -1,4 +1,3 @@
-
 # Copyright (c) [2025] [OpenAI]
 # Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
 # SPDX-License-Identifier: Apache-2.0
@@ -11,83 +10,123 @@
 # This modified file is released under the same license.
 
 from typing import Union
+
 from typing_extensions import Annotated, TypeAlias
 
 from ..._utils import PropertyInfo
+from .response_completed_event import ResponseCompletedEvent
+from .response_content_part_added_event import ResponseContentPartAddedEvent
+from .response_content_part_done_event import ResponseContentPartDoneEvent
+from .response_created_event import ResponseCreatedEvent
 from .response_error_event import ResponseErrorEvent
 from .response_failed_event import ResponseFailedEvent
-from .response_created_event import ResponseCreatedEvent
-from .response_completed_event import ResponseCompletedEvent
-from .response_text_done_event import ResponseTextDoneEvent
-from .response_incomplete_event import ResponseIncompleteEvent
-from .response_text_delta_event import ResponseTextDeltaEvent
+from .response_function_call_arguments_delta_event import (
+    ResponseFunctionCallArgumentsDeltaEvent,
+)
+from .response_function_call_arguments_done_event import (
+    ResponseFunctionCallArgumentsDoneEvent,
+)
+from .response_image_process_call_completed_event import (
+    ResponseImageProcessCallCompletedEvent,
+)
+from .response_image_process_call_in_progress_event import (
+    ResponseImageProcessCallInProgressEvent,
+)
+from .response_image_process_call_processing_event import (
+    ResponseImageProcessCallProcessingEvent,
+)
 from .response_in_progress_event import ResponseInProgressEvent
-from .response_output_item_done_event import ResponseOutputItemDoneEvent
-from .response_content_part_done_event import ResponseContentPartDoneEvent
-from .response_output_item_added_event import ResponseOutputItemAddedEvent
-from .response_content_part_added_event import ResponseContentPartAddedEvent
-from .response_reasoning_summary_part_done_event import ResponseReasoningSummaryPartDoneEvent
-from .response_reasoning_summary_text_done_event import ResponseReasoningSummaryTextDoneEvent
-from .response_function_call_arguments_done_event import ResponseFunctionCallArgumentsDoneEvent
-from .response_reasoning_summary_part_added_event import ResponseReasoningSummaryPartAddedEvent
-from .response_reasoning_summary_text_delta_event import ResponseReasoningSummaryTextDeltaEvent
-from .response_function_call_arguments_delta_event import ResponseFunctionCallArgumentsDeltaEvent
-from .response_web_search_call_in_progress_event import ResponseWebSearchCallInProgressEvent
-from .response_web_search_call_searching_event import ResponseWebSearchCallSearchingEvent
-from .response_web_search_call_completed_event import ResponseWebSearchCallCompletedEvent
-from .response_annotation_added_event import ResponseOutputTextAnnotationAddedEvent
+from .response_incomplete_event import ResponseIncompleteEvent
+from .response_knowledge_search_call_completed_event import (
+    ResponseKnowledgeSearchCallCompletedEvent,
+)
+from .response_knowledge_search_call_failed_event import (
+    ResponseKnowledgeSearchCallFailedEvent,
+)
+from .response_knowledge_search_call_in_progress_event import (
+    ResponseKnowledgeSearchCallInProgressEvent,
+)
+from .response_knowledge_search_call_searching_event import (
+    ResponseKnowledgeSearchCallSearchingEvent,
+)
+from .response_mcp_call_arguments_delta_event import ResponseMcpCallArgumentsDeltaEvent
+from .response_mcp_call_arguments_done_event import ResponseMcpCallArgumentsDoneEvent
+from .response_mcp_call_completed_event import ResponseMcpCallCompletedEvent
 from .response_mcp_call_failed_event import ResponseMcpCallFailedEvent
 from .response_mcp_call_in_progress_event import ResponseMcpCallInProgressEvent
-from .response_mcp_call_completed_event import ResponseMcpCallCompletedEvent
-from .response_mcp_call_arguments_done_event import ResponseMcpCallArgumentsDoneEvent
-from .response_mcp_call_arguments_delta_event import ResponseMcpCallArgumentsDeltaEvent
-from .response_mcp_list_tools_failed_event import ResponseMcpListToolsFailedEvent
-from .response_mcp_list_tools_in_progress_event import ResponseMcpListToolsInProgressEvent
 from .response_mcp_list_tools_completed_event import ResponseMcpListToolsCompletedEvent
-
+from .response_mcp_list_tools_in_progress_event import (
+    ResponseMcpListToolsInProgressEvent,
+)
+from .response_output_item_added_event import ResponseOutputItemAddedEvent
+from .response_output_item_done_event import ResponseOutputItemDoneEvent
+from .response_output_text_annotation_added_event import (
+    ResponseOutputTextAnnotationAddedEvent,
+)
+from .response_reasoning_summary_part_added_event import (
+    ResponseReasoningSummaryPartAddedEvent,
+)
+from .response_reasoning_summary_part_done_event import (
+    ResponseReasoningSummaryPartDoneEvent,
+)
+from .response_reasoning_summary_text_delta_event import (
+    ResponseReasoningSummaryTextDeltaEvent,
+)
+from .response_reasoning_summary_text_done_event import (
+    ResponseReasoningSummaryTextDoneEvent,
+)
+from .response_text_delta_event import ResponseTextDeltaEvent
+from .response_text_done_event import ResponseTextDoneEvent
+from .response_web_search_call_completed_event import (
+    ResponseWebSearchCallCompletedEvent,
+)
+from .response_web_search_call_in_progress_event import (
+    ResponseWebSearchCallInProgressEvent,
+)
+from .response_web_search_call_searching_event import (
+    ResponseWebSearchCallSearchingEvent,
+)
 
 __all__ = ["ResponseStreamEvent"]
 
 ResponseStreamEvent: TypeAlias = Annotated[
     Union[
         ResponseCreatedEvent,
-        ResponseInProgressEvent,
-        ResponseCompletedEvent,
-        ResponseFailedEvent,
-        ResponseIncompleteEvent,
-
         ResponseOutputItemAddedEvent,
-        ResponseOutputItemDoneEvent,
-
         ResponseContentPartAddedEvent,
-        ResponseContentPartDoneEvent,
-
         ResponseTextDeltaEvent,
-        ResponseTextDoneEvent,
-
         ResponseReasoningSummaryPartAddedEvent,
-        ResponseReasoningSummaryPartDoneEvent,
         ResponseReasoningSummaryTextDeltaEvent,
-        ResponseReasoningSummaryTextDoneEvent,
-
         ResponseFunctionCallArgumentsDeltaEvent,
-        ResponseFunctionCallArgumentsDoneEvent,
-
         ResponseErrorEvent,
-
         ResponseWebSearchCallInProgressEvent,
         ResponseWebSearchCallSearchingEvent,
         ResponseWebSearchCallCompletedEvent,
         ResponseOutputTextAnnotationAddedEvent,
-
-        ResponseMcpCallFailedEvent,
-        ResponseMcpCallInProgressEvent,
-        ResponseMcpCallCompletedEvent,
-        ResponseMcpCallArgumentsDoneEvent,
-        ResponseMcpCallArgumentsDeltaEvent,
-        ResponseMcpListToolsFailedEvent,
+        ResponseImageProcessCallInProgressEvent,
+        ResponseImageProcessCallProcessingEvent,
+        ResponseImageProcessCallCompletedEvent,
         ResponseMcpListToolsInProgressEvent,
         ResponseMcpListToolsCompletedEvent,
+        ResponseMcpCallInProgressEvent,
+        ResponseMcpCallArgumentsDeltaEvent,
+        ResponseMcpCallArgumentsDoneEvent,
+        ResponseMcpCallCompletedEvent,
+        ResponseMcpCallFailedEvent,
+        ResponseKnowledgeSearchCallInProgressEvent,
+        ResponseKnowledgeSearchCallSearchingEvent,
+        ResponseKnowledgeSearchCallCompletedEvent,
+        ResponseKnowledgeSearchCallFailedEvent,
+        ResponseInProgressEvent,
+        ResponseCompletedEvent,
+        ResponseFailedEvent,
+        ResponseIncompleteEvent,
+        ResponseOutputItemDoneEvent,
+        ResponseContentPartDoneEvent,
+        ResponseTextDoneEvent,
+        ResponseReasoningSummaryPartDoneEvent,
+        ResponseReasoningSummaryTextDoneEvent,
+        ResponseFunctionCallArgumentsDoneEvent,
     ],
     PropertyInfo(discriminator="type"),
 ]

volcenginesdkarkruntime/types/responses/response_tool_usage.py

@@ -1,4 +1,3 @@
-
 # Copyright (c) [2025] [OpenAI]
 # Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
 # SPDX-License-Identifier: Apache-2.0
@@ -10,6 +9,8 @@
 #
 # This modified file is released under the same license.
 
+from typing import Dict, Optional
+
 from typing_extensions import Dict, Optional
 
 from ..._models import BaseModel
@@ -18,15 +19,22 @@ __all__ = ["ToolUsage", "ToolUsageDetails"]
 
 
 class ToolUsage(BaseModel):
-    web_search: Optional[int]
+    web_search: Optional[int] = None
     """The usage of web search tools."""
-    mcp: Optional[int]
-    """The usage of MCP tools."""
+
+    mcp: Optional[int] = None
+    """The usage of mcp tools."""
+
+    knowledge_search: Optional[int] = None
+    """The usage of knowledge search tools."""
 
 
 class ToolUsageDetails(BaseModel):
-    web_search: Optional[Dict[str, int]]
+    web_search: "Dict[str, int]"
     """The usage of web search tools."""
-    mcp: Optional[Dict[str, int]]
+
+    mcp: "Dict[str, int]"
     """The usage of MCP tools."""
 
+    knowledge_search: "Dict[str, int]"
+    """The usage of knowledge search tools."""

volcenginesdkarkruntime/types/responses/responses_output_text_annotation_cover_image.py

@@ -0,0 +1,25 @@
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ResponsesOutputTextAnnotationCoverImage"]
+
+
+class ResponsesOutputTextAnnotationCoverImage(BaseModel):
+    url: Optional[str] = None
+    """The url of the cover image."""
+    width: Optional[int] = None
+    """The width of the cover image."""
+    height: Optional[int] = None
+    """The height of the cover image."""

volcenginesdkarkruntime/types/responses/tool.py

@@ -1,4 +1,3 @@
-
 # Copyright (c) [2025] [OpenAI]
 # Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
 # SPDX-License-Identifier: Apache-2.0
@@ -11,15 +10,19 @@
 # This modified file is released under the same license.
 
 from typing import Union
+
 from typing_extensions import Annotated, TypeAlias
 
 from ..._utils import PropertyInfo
 from .function_tool import FunctionTool
+from .image_process_tool import ImageProcessTool
+from .knowledge_search_tool import KnowledgeSearchTool
 from .mcp_tool import Mcp
 from .web_search_tool import WebSearchTool
 
 __all__ = ["Tool"]
 
 Tool: TypeAlias = Annotated[
-    Union[FunctionTool, WebSearchTool, Mcp], PropertyInfo(discriminator="type")
+    Union[FunctionTool, WebSearchTool, ImageProcessTool, Mcp, KnowledgeSearchTool],
+    PropertyInfo(discriminator="type"),
 ]

volcenginesdkarkruntime/types/responses/tool_choice_knowledge_search.py

@@ -0,0 +1,22 @@
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from __future__ import annotations
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ToolChoiceKnowledgeSearch"]
+
+
+class ToolChoiceKnowledgeSearch(BaseModel):
+    type: Literal["knowledge_search"]

volcenginesdkarkruntime/types/responses/tool_choice_knowledge_search_param.py

@@ -0,0 +1,20 @@
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ToolChoiceKnowledgeSearchParam"]
+
+
+class ToolChoiceKnowledgeSearchParam(TypedDict, total=False):
+    type: Required[Literal["knowledge_search"]]

volcenginesdkarkruntime/types/responses/tool_choice_mcp.py

@@ -0,0 +1,31 @@
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from __future__ import annotations
+
+from typing import Optional
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ToolChoiceMcp"]
+
+
+class ToolChoiceMcp(BaseModel):
+    type: Literal["mcp"]
+    """For MCP tools, the type is always `mcp`."""
+
+    server_label: str
+    """The label of the MCP server to use."""
+
+    name: Optional[str] = None
+    """The name of the tool to call on the server."""

volcenginesdkarkruntime/types/responses/tool_choice_mcp_param.py

@@ -1,4 +1,3 @@
-
 # Copyright (c) [2025] [OpenAI]
 # Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
 # SPDX-License-Identifier: Apache-2.0
@@ -13,17 +12,18 @@
 from __future__ import annotations
 
 from typing import Optional
+
 from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["ToolChoiceMcpParam"]
 
 
 class ToolChoiceMcpParam(TypedDict, total=False):
-    server_label: Required[str]
-    """The label of the MCP server to use."""
-
     type: Required[Literal["mcp"]]
     """For MCP tools, the type is always `mcp`."""
 
+    server_label: Required[str]
+    """The label of the MCP server to use."""
+
     name: Optional[str]
     """The name of the tool to call on the server."""

volcenginesdkarkruntime/types/responses/tool_choice_web_search.py

@@ -0,0 +1,22 @@
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from __future__ import annotations
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ToolChoiceWebSearch"]
+
+
+class ToolChoiceWebSearch(BaseModel):
+    type: Literal["web_search"]

volcenginesdkarkruntime/types/responses/tool_choice_web_search_param.py

@@ -0,0 +1,20 @@
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ToolChoiceWebSearchParam"]
+
+
+class ToolChoiceWebSearchParam(TypedDict, total=False):
+    type: Required[Literal["web_search"]]

volcenginesdkarkruntime/types/responses/tool_param.py

@@ -1,4 +1,3 @@
-
 # Copyright (c) [2025] [OpenAI]
 # Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
 # SPDX-License-Identifier: Apache-2.0
@@ -13,12 +12,21 @@
 from __future__ import annotations
 
 from typing import Union
+
 from typing_extensions import TypeAlias
 
 from .function_tool_param import FunctionToolParam
-from .web_search_tool_param import WebSearchToolParam
+from .image_process_tool_param import ImageProcessToolParam
+from .knowledge_search_tool_param import KnowledgeSearchToolParam
 from .mcp_tool_param import Mcp
+from .web_search_tool_param import WebSearchToolParam
 
 __all__ = ["ToolParam"]
 
-ToolParam: TypeAlias = Union[FunctionToolParam, WebSearchToolParam, Mcp]
+ToolParam: TypeAlias = Union[
+    FunctionToolParam,
+    WebSearchToolParam,
+    ImageProcessToolParam,
+    Mcp,
+    KnowledgeSearchToolParam,
+]

volcenginesdkarkruntime/types/responses/user_location.py

@@ -0,0 +1,30 @@
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["UserLocation"]
+
+
+class UserLocation(BaseModel):
+    type: Literal["approximate"]
+    """The type of the user location. Always `approximate`."""
+    city: Optional[str]
+    """The city of the user location."""
+    country: Optional[str]
+    """The country of the user location."""
+    region: Optional[str]
+    """The region of the user location."""
+    timezone: Optional[float]
+    """The timezone of the user location."""

volcenginesdkarkruntime/types/responses/user_location_param.py

@@ -0,0 +1,31 @@
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, Required, TypedDict
+
+
+__all__ = ["UserLocationParam"]
+
+
+class UserLocationParam(TypedDict, total=False):
+    type: Required[Literal["approximate"]]
+    """The type of the user location. Always `approximate`."""
+    city: Optional[str]
+    """The city of the user location."""
+    country: Optional[str]
+    """The country of the user location."""
+    region: Optional[str]
+    """The region of the user location."""
+    timezone: Optional[float]
+    """The timezone of the user location."""

volcenginesdkarkruntime/types/responses/web_search_tool.py

@@ -1,4 +1,3 @@
-
 # Copyright (c) [2025] [OpenAI]
 # Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
 # SPDX-License-Identifier: Apache-2.0
@@ -10,40 +9,30 @@
 #
 # This modified file is released under the same license.
 
-from typing_extensions import Literal, Required, Optional, List
+from typing import List, Optional
+
+from typing_extensions import Literal
 
 from ..._models import BaseModel
+from .user_location import UserLocation
 
 __all__ = [
     "WebSearchTool",
-    "UserLocation",
 ]
 
 
-class UserLocation(BaseModel):
-    type: Literal["approximate"]
-    """The type of the user location. Always `approximate`."""
-    city: Optional[str]
-    """The city of the user location."""
-    country: Optional[str]
-    """The country of the user location."""
-    region: Optional[str]
-    """The region of the user location."""
-    timezone: Optional[float]
-    """The timezone of the user location."""
-
-
 class WebSearchTool(BaseModel):
-
     type: Literal["web_search"]
     """The type of the web search. Always `web_search`."""
 
-    limit: Optional[int]
+    limit: Optional[int] = None
     """The maximum number of results to return. Defaults to 3."""
 
-    sources: Optional[List[Literal["toutiao", "douyin", "moji", "search_engine"]]]
-    """The source type of web search."""
-
-    user_location: Optional[UserLocation]
+    user_location: Optional[UserLocation] = None
     """The user location."""
 
+    sources: List[Literal["toutiao", "douyin", "moji", "search_engine"]]
+    """The source type of web search."""
+
+    max_keyword: Optional[int] = None
+    """Max number of keywords to search per web search call"""

volcenginesdkarkruntime/types/responses/web_search_tool_param.py

@@ -1,4 +1,3 @@
-
 # Copyright (c) [2025] [OpenAI]
 # Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
 # SPDX-License-Identifier: Apache-2.0
@@ -12,35 +11,27 @@
 
 from __future__ import annotations
 
-from typing import Optional, List
+from typing import List, Optional
+
 from typing_extensions import Literal, Required, TypedDict
 
+from .user_location_param import UserLocationParam
+
 __all__ = ["WebSearchToolParam"]
 
 
 class WebSearchToolParam(TypedDict, total=False):
-
     type: Required[Literal["web_search"]]
     """The type of the web search. Always `web_search`."""
 
     limit: Optional[int]
     """The maximum number of results to return. Defaults to 3."""
 
-    sources: Optional[List[Literal["toutiao", "douyin", "moji", "search_engine"]]]
-    """The source type of web search."""
-
     user_location: Optional[UserLocationParam]
     """The user location."""
 
+    sources: Required[List[Literal["toutiao", "douyin", "moji", "search_engine"]]]
+    """The source type of web search."""
 
-class UserLocationParam(TypedDict, total=False):
-    type: Required[Literal["approximate"]]
-    """The type of the user location. Always `approximate`."""
-    city: Optional[str]
-    """The city of the user location."""
-    country: Optional[str]
-    """The country of the user location."""
-    region: Optional[str]
-    """The region of the user location."""
-    timezone: Optional[float]
-    """The timezone of the user location."""
+    max_keyword: Optional[int]
+    """Max number of keywords to search per web search call"""

volcenginesdkarkruntime/types/shared/__init__.py

@@ -17,3 +17,6 @@ from .response_format_json_object import (
 from .response_format_json_schema import (
     ResponseFormatJSONSchema as ResponseFormatJSONSchema,
 )
+from .reasoning import Reasoning as Reasoning
+
+from .reasoning_effort import ReasoningEffort as ReasoningEffort

volcenginesdkarkruntime/types/shared/reasoning.py

@@ -0,0 +1,10 @@
+from typing import Optional
+
+from volcenginesdkarkruntime._models import BaseModel
+from .reasoning_effort import ReasoningEffort
+
+__all__ = ["Reasoning"]
+
+
+class Reasoning(BaseModel):
+    effort: Optional[ReasoningEffort] = None

volcenginesdkarkruntime/types/shared_params/__init__.py

@@ -20,3 +20,5 @@ from .response_format_json_object import (
 from .response_format_json_schema import (
     ResponseFormatJSONSchema as ResponseFormatJSONSchema,
 )
+from .reasoning import Reasoning as Reasoning
+from .reasoning_effort import ReasoningEffort as ReasoningEffort

volcenginesdkarkruntime/types/shared_params/reasoning.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+from ..shared.reasoning_effort import ReasoningEffort
+
+__all__ = ["Reasoning"]
+
+
+class Reasoning(TypedDict, total=False):
+    effort: Optional[ReasoningEffort]

volcenginesdkarkruntime/types/shared_params/reasoning_effort.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["ReasoningEffort"]
+
+ReasoningEffort: TypeAlias = Optional[Literal["minimal", "low", "medium", "high"]]