arkruntime 0.1.0__py3-none-any.whl

arkruntime/types/chat/__init__.py

@@ -0,0 +1,212 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from .chat_completion_choice_logprobs import ChatCompletionChoiceLogprobs
+from .chat_completion_content_part import ChatCompletionContentPart
+from .chat_completion_content_part_audio import ChatCompletionContentPartAudio
+from .chat_completion_content_part_audio_input_audio import (
+    ChatCompletionContentPartAudioInputAudio,
+)
+from .chat_completion_content_part_file import ChatCompletionContentPartFile
+from .chat_completion_content_part_file_file import ChatCompletionContentPartFileFile
+from .chat_completion_content_part_image import ChatCompletionContentPartImage
+from .chat_completion_content_part_image_image_url import (
+    ChatCompletionContentPartImageImageUrl,
+)
+from .chat_completion_content_part_text import ChatCompletionContentPartText
+from .chat_completion_content_part_video import ChatCompletionContentPartVideo
+from .chat_completion_content_part_video_video_url import (
+    ChatCompletionContentPartVideoVideoUrl,
+)
+from .chat_completion_message_content import ChatCompletionMessageContent
+from .chat_completion_message_tool_call import ChatCompletionMessageToolCall
+from .chat_completion_message_tool_call_chunk import ChatCompletionMessageToolCallChunk
+from .chat_completion_message_tool_call_chunk_function import (
+    ChatCompletionMessageToolCallChunkFunction,
+)
+from .chat_completion_message_tool_call_function import (
+    ChatCompletionMessageToolCallFunction,
+)
+from .chat_completion_named_tool_choice import ChatCompletionNamedToolChoice
+from .chat_completion_request import ChatCompletionRequest
+from .chat_completion_request_assistant_message import (
+    ChatCompletionRequestAssistantMessage,
+)
+from .chat_completion_request_message import ChatCompletionRequestMessage
+from .chat_completion_request_system_message import ChatCompletionRequestSystemMessage
+from .chat_completion_request_tool_message import ChatCompletionRequestToolMessage
+from .chat_completion_request_user_message import ChatCompletionRequestUserMessage
+from .chat_completion_response import ChatCompletionResponse
+from .chat_completion_response_choice import ChatCompletionResponseChoice
+from .chat_completion_response_format import ChatCompletionResponseFormat
+from .chat_completion_response_format_json_schema import (
+    ChatCompletionResponseFormatJsonSchema,
+)
+from .chat_completion_response_message import ChatCompletionResponseMessage
+from .chat_completion_role import ChatCompletionRole
+from .chat_completion_service_status import ChatCompletionServiceStatus
+from .chat_completion_stop import ChatCompletionStop
+from .chat_completion_stream_choice_logprobs import ChatCompletionStreamChoiceLogprobs
+from .chat_completion_stream_options import ChatCompletionStreamOptions
+from .chat_completion_stream_response import ChatCompletionStreamResponse
+from .chat_completion_stream_response_choice import ChatCompletionStreamResponseChoice
+from .chat_completion_stream_response_delta import ChatCompletionStreamResponseDelta
+from .chat_completion_token_logprob import ChatCompletionTokenLogprob
+from .chat_completion_token_logprob_top_logprob import (
+    ChatCompletionTokenLogprobTopLogprob,
+)
+from .chat_completion_tool import ChatCompletionTool
+from .chat_completion_tool_choice import ChatCompletionToolChoice
+from .chat_completion_tool_choice_function import ChatCompletionToolChoiceFunction
+from .completion_tokens_details import CompletionTokensDetails
+from .completion_usage import CompletionUsage
+from .error import Error
+from .error_response import ErrorResponse
+from .finish_reason import FinishReason
+from .function_object import FunctionObject
+from .image_detail import ImageDetail
+from .image_pixel_limit import ImagePixelLimit
+from .model_fallback_status import ModelFallbackStatus
+from .moderation_hit_type import ModerationHitType
+from .prompt_tokens_details import PromptTokensDetails
+from .reasoning_effort import ReasoningEffort
+from .request_service_tier import RequestServiceTier
+from .response_format_type import ResponseFormatType
+from .response_service_tier import ResponseServiceTier
+from .thinking import Thinking
+from .thinking_mode import ThinkingMode
+from .tool_choice_mode import ToolChoiceMode
+from .tool_type import ToolType
+from .video_image_pixel_limit import VideoImagePixelLimit
+
+__all__ = [
+    "ChatCompletionChoiceLogprobs",
+    "ChatCompletionContentPart",
+    "ChatCompletionContentPartAudio",
+    "ChatCompletionContentPartAudioInputAudio",
+    "ChatCompletionContentPartFile",
+    "ChatCompletionContentPartFileFile",
+    "ChatCompletionContentPartImage",
+    "ChatCompletionContentPartImageImageUrl",
+    "ChatCompletionContentPartText",
+    "ChatCompletionContentPartVideo",
+    "ChatCompletionContentPartVideoVideoUrl",
+    "ChatCompletionMessageContent",
+    "ChatCompletionMessageToolCall",
+    "ChatCompletionMessageToolCallChunk",
+    "ChatCompletionMessageToolCallChunkFunction",
+    "ChatCompletionMessageToolCallFunction",
+    "ChatCompletionNamedToolChoice",
+    "ChatCompletionRequest",
+    "ChatCompletionRequestAssistantMessage",
+    "ChatCompletionRequestMessage",
+    "ChatCompletionRequestSystemMessage",
+    "ChatCompletionRequestToolMessage",
+    "ChatCompletionRequestUserMessage",
+    "ChatCompletionResponse",
+    "ChatCompletionResponseChoice",
+    "ChatCompletionResponseFormat",
+    "ChatCompletionResponseFormatJsonSchema",
+    "ChatCompletionResponseMessage",
+    "ChatCompletionRole",
+    "ChatCompletionServiceStatus",
+    "ChatCompletionStop",
+    "ChatCompletionStreamChoiceLogprobs",
+    "ChatCompletionStreamOptions",
+    "ChatCompletionStreamResponse",
+    "ChatCompletionStreamResponseChoice",
+    "ChatCompletionStreamResponseDelta",
+    "ChatCompletionTokenLogprob",
+    "ChatCompletionTokenLogprobTopLogprob",
+    "ChatCompletionTool",
+    "ChatCompletionToolChoice",
+    "ChatCompletionToolChoiceFunction",
+    "CompletionTokensDetails",
+    "CompletionUsage",
+    "Error",
+    "ErrorResponse",
+    "FinishReason",
+    "FunctionObject",
+    "ImageDetail",
+    "ImagePixelLimit",
+    "ModelFallbackStatus",
+    "ModerationHitType",
+    "PromptTokensDetails",
+    "ReasoningEffort",
+    "RequestServiceTier",
+    "ResponseFormatType",
+    "ResponseServiceTier",
+    "Thinking",
+    "ThinkingMode",
+    "ToolChoiceMode",
+    "ToolType",
+    "VideoImagePixelLimit",
+]
+from .chat_completion_content_part_audio_input_audio_param import (
+    ChatCompletionContentPartAudioInputAudioParam,
+)
+from .chat_completion_content_part_audio_param import (
+    ChatCompletionContentPartAudioParam,
+)
+from .chat_completion_content_part_file_file_param import (
+    ChatCompletionContentPartFileFileParam,
+)
+from .chat_completion_content_part_file_param import ChatCompletionContentPartFileParam
+from .chat_completion_content_part_image_image_url_param import (
+    ChatCompletionContentPartImageImageUrlParam,
+)
+from .chat_completion_content_part_image_param import (
+    ChatCompletionContentPartImageParam,
+)
+from .chat_completion_content_part_param import ChatCompletionContentPartParam
+from .chat_completion_content_part_text_param import ChatCompletionContentPartTextParam
+from .chat_completion_content_part_video_param import (
+    ChatCompletionContentPartVideoParam,
+)
+from .chat_completion_content_part_video_video_url_param import (
+    ChatCompletionContentPartVideoVideoUrlParam,
+)
+from .chat_completion_message_content_param import ChatCompletionMessageContentParam
+from .chat_completion_message_tool_call_function_param import (
+    ChatCompletionMessageToolCallFunctionParam,
+)
+from .chat_completion_message_tool_call_param import ChatCompletionMessageToolCallParam
+from .chat_completion_named_tool_choice_param import ChatCompletionNamedToolChoiceParam
+from .chat_completion_request_assistant_message_param import (
+    ChatCompletionRequestAssistantMessageParam,
+)
+from .chat_completion_request_message_param import ChatCompletionRequestMessageParam
+from .chat_completion_request_param import ChatCompletionRequestParam
+from .chat_completion_request_system_message_param import (
+    ChatCompletionRequestSystemMessageParam,
+)
+from .chat_completion_request_tool_message_param import (
+    ChatCompletionRequestToolMessageParam,
+)
+from .chat_completion_request_user_message_param import (
+    ChatCompletionRequestUserMessageParam,
+)
+from .chat_completion_response_format_json_schema_param import (
+    ChatCompletionResponseFormatJsonSchemaParam,
+)
+from .chat_completion_response_format_param import ChatCompletionResponseFormatParam
+from .chat_completion_stop_param import ChatCompletionStopParam
+from .chat_completion_stream_options_param import ChatCompletionStreamOptionsParam
+from .chat_completion_tool_choice_function_param import (
+    ChatCompletionToolChoiceFunctionParam,
+)
+from .chat_completion_tool_choice_param import ChatCompletionToolChoiceParam
+from .chat_completion_tool_param import ChatCompletionToolParam
+from .function_object_param import FunctionObjectParam
+from .image_pixel_limit_param import ImagePixelLimitParam
+from .thinking_param import ThinkingParam
+from .tool_type_param import ToolTypeParam
+from .video_image_pixel_limit_param import VideoImagePixelLimitParam
+
+# Hand-written extras (preserved across regen via Makefile rsync --exclude=*_shim.py).
+from ._init_extras_shim import *  # noqa: F401,F403

arkruntime/types/chat/_init_extras_shim.py

@@ -0,0 +1,73 @@
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+"""Hand-written re-exports for the chat API.
+
+Pulled into ``__init__.py`` via a trailing
+``from ._init_extras_shim import *`` block emitted by the ark-apis
+generator. Preserved across regen by the Makefile rsync
+``--exclude='*_shim.py'`` rule.
+"""
+
+from __future__ import annotations
+
+# Backwards-compatible aliases. The generator emits longer canonical names
+# (e.g. ChatCompletionResponse) but downstream consumers and historical SDK
+# users address these objects by their short-form aliases.
+from .chat_completion_response import ChatCompletionResponse as ChatCompletion
+from .chat_completion_stream_response import (
+    ChatCompletionStreamResponse as ChatCompletionChunk,
+)
+from .chat_completion_response_message import (
+    ChatCompletionResponseMessage as ChatCompletionMessage,
+)
+from .chat_completion_request_message_param import (
+    ChatCompletionRequestMessageParam as ChatCompletionMessageParam,
+)
+from .chat_completion_request_user_message_param import (
+    ChatCompletionRequestUserMessageParam as ChatCompletionUserMessageParam,
+)
+from .chat_completion_request_system_message_param import (
+    ChatCompletionRequestSystemMessageParam as ChatCompletionSystemMessageParam,
+)
+from .chat_completion_request_assistant_message_param import (
+    ChatCompletionRequestAssistantMessageParam as ChatCompletionAssistantMessageParam,
+)
+from .chat_completion_request_tool_message_param import (
+    ChatCompletionRequestToolMessageParam as ChatCompletionToolMessageParam,
+)
+from .chat_completion_tool_choice_param import (
+    ChatCompletionToolChoiceParam as ChatCompletionToolChoiceOptionParam,
+)
+from .chat_completion_request_param import (
+    ChatCompletionRequestParam as CompletionCreateParams,
+)
+
+# SDK-only siblings (not generated).
+from .parsed_chat_completion_shim import (
+    ParsedChoice,
+    ParsedChatCompletion,
+    ParsedChatCompletionMessage,
+)
+from .parsed_function_tool_call_shim import (
+    ParsedFunction,
+    ParsedFunctionToolCall,
+)
+
+__all__ = [
+    "ChatCompletion",
+    "ChatCompletionChunk",
+    "ChatCompletionMessage",
+    "ChatCompletionMessageParam",
+    "ChatCompletionUserMessageParam",
+    "ChatCompletionSystemMessageParam",
+    "ChatCompletionAssistantMessageParam",
+    "ChatCompletionToolMessageParam",
+    "ChatCompletionToolChoiceOptionParam",
+    "CompletionCreateParams",
+    "ParsedChoice",
+    "ParsedChatCompletion",
+    "ParsedChatCompletionMessage",
+    "ParsedFunction",
+    "ParsedFunctionToolCall",
+]

arkruntime/types/chat/chat_completion_choice_logprobs.py

@@ -0,0 +1,20 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import List
+
+from arkruntime._models import BaseModel
+
+from .chat_completion_token_logprob import ChatCompletionTokenLogprob
+
+
+class ChatCompletionChoiceLogprobs(BaseModel):
+    content: List[ChatCompletionTokenLogprob]
+    """
+    A list of message content tokens with log probability information.
+    """

arkruntime/types/chat/chat_completion_content_part.py

@@ -0,0 +1,32 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Annotated, Union
+
+from pydantic import Field
+from typing_extensions import TypeAliasType
+
+from .chat_completion_content_part_audio import ChatCompletionContentPartAudio
+from .chat_completion_content_part_file import ChatCompletionContentPartFile
+from .chat_completion_content_part_image import ChatCompletionContentPartImage
+from .chat_completion_content_part_text import ChatCompletionContentPartText
+from .chat_completion_content_part_video import ChatCompletionContentPartVideo
+
+ChatCompletionContentPart = TypeAliasType(
+    "ChatCompletionContentPart",
+    Annotated[
+        Union[
+            ChatCompletionContentPartText,
+            ChatCompletionContentPartImage,
+            ChatCompletionContentPartVideo,
+            ChatCompletionContentPartAudio,
+            ChatCompletionContentPartFile,
+        ],
+        Field(discriminator="type"),
+    ],
+)

arkruntime/types/chat/chat_completion_content_part_audio.py

@@ -0,0 +1,23 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Literal
+
+from arkruntime._models import BaseModel
+
+from .chat_completion_content_part_audio_input_audio import (
+    ChatCompletionContentPartAudioInputAudio,
+)
+
+
+class ChatCompletionContentPartAudio(BaseModel):
+    type: Literal["input_audio"]
+    """
+    The type of the content part. Always `input_audio`.
+    """
+    input_audio: ChatCompletionContentPartAudioInputAudio

arkruntime/types/chat/chat_completion_content_part_audio_input_audio.py

@@ -0,0 +1,30 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Optional
+
+from arkruntime._models import BaseModel
+
+
+class ChatCompletionContentPartAudioInputAudio(BaseModel):
+    url: Optional[str] = None
+    """
+    The URL of the audio to be sent to the model.
+    """
+    file_id: Optional[str] = None
+    """
+    The blob id of the audio, when uploaded out-of-band.
+    """
+    data: Optional[str] = None
+    """
+    Base64-encoded audio data.
+    """
+    format: Optional[str] = None
+    """
+    The format of the encoded audio data (e.g. `mp3`, `wav`).
+    """

arkruntime/types/chat/chat_completion_content_part_audio_input_audio_param.py

@@ -0,0 +1,25 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Optional
+
+from typing_extensions import TypedDict
+
+
+class ChatCompletionContentPartAudioInputAudioParam(TypedDict, total=False):
+    url: Optional[str]
+    """The URL of the audio to be sent to the model."""
+
+    file_id: Optional[str]
+    """The blob id of the audio, when uploaded out-of-band."""
+
+    data: Optional[str]
+    """Base64-encoded audio data."""
+
+    format: Optional[str]
+    """The format of the encoded audio data (e.g. `mp3`, `wav`)."""

arkruntime/types/chat/chat_completion_content_part_audio_param.py

@@ -0,0 +1,22 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Literal
+
+from typing_extensions import Required, TypedDict
+
+from .chat_completion_content_part_audio_input_audio_param import (
+    ChatCompletionContentPartAudioInputAudioParam,
+)
+
+
+class ChatCompletionContentPartAudioParam(TypedDict, total=False):
+    type: Required[Literal["input_audio"]]
+    """The type of the content part. Always `input_audio`."""
+
+    input_audio: Required[ChatCompletionContentPartAudioInputAudioParam]

arkruntime/types/chat/chat_completion_content_part_file.py

@@ -0,0 +1,21 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Literal
+
+from arkruntime._models import BaseModel
+
+from .chat_completion_content_part_file_file import ChatCompletionContentPartFileFile
+
+
+class ChatCompletionContentPartFile(BaseModel):
+    type: Literal["file"]
+    """
+    The type of the content part. Always `file`.
+    """
+    file: ChatCompletionContentPartFileFile

arkruntime/types/chat/chat_completion_content_part_file_file.py

@@ -0,0 +1,30 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Optional
+
+from arkruntime._models import BaseModel
+
+
+class ChatCompletionContentPartFileFile(BaseModel):
+    file_id: Optional[str] = None
+    """
+    The blob id of a file uploaded out-of-band.
+    """
+    file_url: Optional[str] = None
+    """
+    The URL of the file to be sent to the model.
+    """
+    file_data: Optional[str] = None
+    """
+    The base64 encoded file data, used when passing the file inline.
+    """
+    filename: Optional[str] = None
+    """
+    The name of the file, required when `file_data` is set.
+    """

arkruntime/types/chat/chat_completion_content_part_file_file_param.py

@@ -0,0 +1,25 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Optional
+
+from typing_extensions import TypedDict
+
+
+class ChatCompletionContentPartFileFileParam(TypedDict, total=False):
+    file_id: Optional[str]
+    """The blob id of a file uploaded out-of-band."""
+
+    file_url: Optional[str]
+    """The URL of the file to be sent to the model."""
+
+    file_data: Optional[str]
+    """The base64 encoded file data, used when passing the file inline."""
+
+    filename: Optional[str]
+    """The name of the file, required when `file_data` is set."""

arkruntime/types/chat/chat_completion_content_part_file_param.py

@@ -0,0 +1,22 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Literal
+
+from typing_extensions import Required, TypedDict
+
+from .chat_completion_content_part_file_file_param import (
+    ChatCompletionContentPartFileFileParam,
+)
+
+
+class ChatCompletionContentPartFileParam(TypedDict, total=False):
+    type: Required[Literal["file"]]
+    """The type of the content part. Always `file`."""
+
+    file: Required[ChatCompletionContentPartFileFileParam]

arkruntime/types/chat/chat_completion_content_part_image.py

@@ -0,0 +1,23 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Literal
+
+from arkruntime._models import BaseModel
+
+from .chat_completion_content_part_image_image_url import (
+    ChatCompletionContentPartImageImageUrl,
+)
+
+
+class ChatCompletionContentPartImage(BaseModel):
+    type: Literal["image_url"]
+    """
+    The type of the content part. Always `image_url`.
+    """
+    image_url: ChatCompletionContentPartImageImageUrl

arkruntime/types/chat/chat_completion_content_part_image_image_url.py

@@ -0,0 +1,33 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Optional
+
+from arkruntime._models import BaseModel
+
+from .image_detail import ImageDetail
+from .image_pixel_limit import ImagePixelLimit
+
+
+class ChatCompletionContentPartImageImageUrl(BaseModel):
+    url: Optional[str] = None
+    """
+    Either a URL of the image or the base64 encoded image data.
+    """
+    detail: Optional[ImageDetail] = None
+    """
+    Specifies the detail level of the image. Defaults to `auto`.
+    """
+    image_pixel_limit: Optional[ImagePixelLimit] = None
+    """
+    Optional pixel-size limits for image preprocessing.
+    """
+    file_id: Optional[str] = None
+    """
+    The blob id of the image, when uploaded out-of-band.
+    """

arkruntime/types/chat/chat_completion_content_part_image_image_url_param.py

@@ -0,0 +1,28 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Optional
+
+from typing_extensions import TypedDict
+
+from .image_detail import ImageDetail
+from .image_pixel_limit_param import ImagePixelLimitParam
+
+
+class ChatCompletionContentPartImageImageUrlParam(TypedDict, total=False):
+    url: Optional[str]
+    """Either a URL of the image or the base64 encoded image data."""
+
+    detail: Optional[ImageDetail]
+    """Specifies the detail level of the image. Defaults to `auto`."""
+
+    image_pixel_limit: Optional[ImagePixelLimitParam]
+    """Optional pixel-size limits for image preprocessing."""
+
+    file_id: Optional[str]
+    """The blob id of the image, when uploaded out-of-band."""

arkruntime/types/chat/chat_completion_content_part_image_param.py

@@ -0,0 +1,22 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Literal
+
+from typing_extensions import Required, TypedDict
+
+from .chat_completion_content_part_image_image_url_param import (
+    ChatCompletionContentPartImageImageUrlParam,
+)
+
+
+class ChatCompletionContentPartImageParam(TypedDict, total=False):
+    type: Required[Literal["image_url"]]
+    """The type of the content part. Always `image_url`."""
+
+    image_url: Required[ChatCompletionContentPartImageImageUrlParam]