Merge 'feat/support-audio-1-5-pro' into 'integration_2025-12-25_1097365330690'

feat: [development task] ark runtime (1971895)

See merge request: !986

Author: BitsAdmin

volcenginesdkarkruntime/_models.py

@@ -654,6 +654,8 @@ def _extract_field_schema_pv2(
     model: type[BaseModel], field_name: str
 ) -> ModelField | None:
     schema = model.__pydantic_core_schema__
+    if schema["type"] == "definitions":
+        schema = schema["schema"]
     if schema["type"] != "model":
         return None
 

volcenginesdkarkruntime/resources/content_generation/tasks.py

@@ -48,6 +48,7 @@ def create(
         return_last_frame: Optional[bool] = None,
         service_tier: Optional[str] = None,
         execution_expires_after: Optional[int] = None,
+        generate_audio: Optional[bool] = None,
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
@@ -62,6 +63,7 @@ def create(
                 "return_last_frame": return_last_frame,
                 "service_tier": service_tier,
                 "execution_expires_after": execution_expires_after,
+                "generate_audio": generate_audio,
             },
             options=make_request_options(
                 extra_headers=extra_headers,
@@ -176,6 +178,7 @@ async def create(
         return_last_frame: Optional[bool] = None,
         service_tier: Optional[str] = None,
         execution_expires_after: Optional[int] = None,
+        generate_audio: Optional[bool] = None,
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
@@ -190,6 +193,7 @@ async def create(
                 "return_last_frame": return_last_frame,
                 "service_tier": service_tier,
                 "execution_expires_after": execution_expires_after,
+                "generate_audio": generate_audio,
             },
             options=make_request_options(
                 extra_headers=extra_headers,

volcenginesdkarkruntime/resources/responses/responses.py

@@ -75,6 +75,18 @@ def _add_beta_headers(
             if extra_headers is None:
                 extra_headers = {}
             extra_headers["ark-beta-mcp"] = "true"
+        if tool_param.get("type", "") == "knowledge_search":
+            if extra_headers is None:
+                extra_headers = {}
+            extra_headers["ark-beta-knowledge-search"] = "true"
+        if tool_param.get("type", "") == "doubao_app":
+            if extra_headers is None:
+                extra_headers = {}
+            extra_headers["ark-beta-doubao-app"] = "true"
+        if tool_param.get("type", "") == "image_process":
+            if extra_headers is None:
+                extra_headers = {}
+            extra_headers["ark-beta-image-process"] = "true"
     return extra_headers
 
 

volcenginesdkarkruntime/types/content_generation/content_generation_task.py

@@ -86,3 +86,6 @@ class ContentGenerationTask(BaseModel):
 
     execution_expires_after: int
     """The expiration time in seconds after which execution should end (optional)."""
+
+    generate_audio: bool
+    """Whether to generate audio."""

volcenginesdkarkruntime/types/responses/content.py

@@ -0,0 +1,24 @@
+# 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 Union
+
+from typing_extensions import Annotated, TypeAlias
+
+from ..._utils import PropertyInfo
+from .response_output_text import ResponseOutputText
+
+__all__ = ["Content"]
+
+Content: TypeAlias = Annotated[
+    Union[ResponseOutputText],
+    PropertyInfo(discriminator="type"),
+]

volcenginesdkarkruntime/types/responses/doubao_app_call_block.py

@@ -0,0 +1,32 @@
+# 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 Union
+
+from typing_extensions import Annotated, TypeAlias
+
+from ..._utils import PropertyInfo
+from .doubao_app_call_block_output_text import DoubaoAppCallBlockOutputText
+from .doubao_app_call_block_reasoning_search import DoubaoAppCallBlockReasoningSearch
+from .doubao_app_call_block_reasoning_text import DoubaoAppCallBlockReasoningText
+from .doubao_app_call_block_search import DoubaoAppCallBlockSearch
+
+__all__ = ["DoubaoAppCallBlock"]
+
+DoubaoAppCallBlock: TypeAlias = Annotated[
+    Union[
+        DoubaoAppCallBlockOutputText,
+        DoubaoAppCallBlockReasoningText,
+        DoubaoAppCallBlockSearch,
+        DoubaoAppCallBlockReasoningSearch,
+    ],
+    PropertyInfo(discriminator="type"),
+]

volcenginesdkarkruntime/types/responses/doubao_app_call_block_output_text.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__ = ["DoubaoAppCallBlockOutputText"]
+
+
+class DoubaoAppCallBlockOutputText(BaseModel):
+    id: Optional[str] = None
+
+    type: Literal["output_text"]
+
+    text: str
+
+    status: Literal["in_progress", "completed", "incomplete", "searching", "failed"]
+
+    parent_id: Optional[str] = None

volcenginesdkarkruntime/types/responses/doubao_app_call_block_reasoning_search.py

@@ -0,0 +1,35 @@
+# 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 List, Optional
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from .doubao_app_search_result import DoubaoAppSearchResult
+
+__all__ = ["DoubaoAppCallBlockReasoningSearch"]
+
+
+class DoubaoAppCallBlockReasoningSearch(BaseModel):
+    id: Optional[str] = None
+
+    type: Literal["reasoning_search"]
+
+    summary: Optional[str] = None
+
+    queries: List[str]
+
+    results: List[DoubaoAppSearchResult]
+
+    status: Literal["in_progress", "completed", "incomplete", "searching", "failed"]
+
+    parent_id: Optional[str] = None

volcenginesdkarkruntime/types/responses/doubao_app_call_block_reasoning_text.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__ = ["DoubaoAppCallBlockReasoningText"]
+
+
+class DoubaoAppCallBlockReasoningText(BaseModel):
+    id: Optional[str] = None
+
+    type: Literal["reasoning_text"]
+
+    reasoning_text: str
+
+    status: Literal["in_progress", "completed", "incomplete", "searching", "failed"]
+
+    parent_id: Optional[str] = None

volcenginesdkarkruntime/types/responses/doubao_app_call_block_search.py

@@ -0,0 +1,35 @@
+# 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 List, Optional
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from .doubao_app_search_result import DoubaoAppSearchResult
+
+__all__ = ["DoubaoAppCallBlockSearch"]
+
+
+class DoubaoAppCallBlockSearch(BaseModel):
+    id: Optional[str] = None
+
+    type: Literal["search"]
+
+    summary: Optional[str] = None
+
+    queries: List[str]
+
+    results: List[DoubaoAppSearchResult]
+
+    status: Literal["in_progress", "completed", "incomplete", "searching", "failed"]
+
+    parent_id: Optional[str] = None