arkruntime 0.1.0__py3-none-any.whl

arkruntime/resources/chat/completions.py

@@ -0,0 +1,242 @@
+# Copyright (c) 2025 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+# License text: https://github.com/volcengine/ark-runtime-python/blob/main/LICENSE
+
+from __future__ import annotations
+
+from typing import (
+    Dict,
+    List,
+    Optional,
+)
+
+import httpx
+
+from ..._base_client import make_request_options
+from ..._compat import cached_property
+from ..._resource import AsyncAPIResource, SyncAPIResource
+from ..._response import (
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+)
+from ..._streaming import AsyncStream, Stream
+from ..._types import Body, Headers, Query
+from ..._utils._utils import async_with_sts_token, with_sts_token
+
+# AUTOGEN-START create-imports
+from ...types.chat.chat_completion_request_message_param import ChatCompletionRequestMessageParam
+from ...types.chat.chat_completion_response import ChatCompletionResponse
+from ...types.chat.chat_completion_response_format_param import ChatCompletionResponseFormatParam
+from ...types.chat.chat_completion_stop_param import ChatCompletionStopParam
+from ...types.chat.chat_completion_stream_options_param import ChatCompletionStreamOptionsParam
+from ...types.chat.chat_completion_stream_response import ChatCompletionStreamResponse
+from ...types.chat.chat_completion_tool_choice_param import ChatCompletionToolChoiceParam
+from ...types.chat.chat_completion_tool_param import ChatCompletionToolParam
+from ...types.chat.reasoning_effort import ReasoningEffort
+from ...types.chat.request_service_tier import RequestServiceTier
+from ...types.chat.thinking_param import ThinkingParam
+from ..encryption import async_with_e2e_encryption, with_e2e_encryption
+
+# AUTOGEN-END create-imports
+
+__all__ = ["Completions", "AsyncCompletions"]
+
+
+class Completions(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> CompletionsWithRawResponse:
+        return CompletionsWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> CompletionsWithStreamingResponse:
+        return CompletionsWithStreamingResponse(self)
+
+    @with_sts_token
+    @with_e2e_encryption
+    def create(
+        self,
+        *,
+        # AUTOGEN-START create-kwargs
+        messages: List[ChatCompletionRequestMessageParam],
+        model: str,
+        frequency_penalty: Optional[float] = None,
+        presence_penalty: Optional[float] = None,
+        repetition_penalty: Optional[float] = None,
+        logit_bias: Optional[Dict[str, float]] = None,
+        logprobs: Optional[bool] = None,
+        top_logprobs: Optional[int] = None,
+        max_tokens: Optional[int] = None,
+        max_completion_tokens: Optional[int] = None,
+        n: Optional[int] = None,
+        response_format: Optional[ChatCompletionResponseFormatParam] = None,
+        stop: Optional[ChatCompletionStopParam] = None,
+        stream: Optional[bool] = None,
+        stream_options: Optional[ChatCompletionStreamOptionsParam] = None,
+        temperature: Optional[float] = None,
+        top_p: Optional[float] = None,
+        tool_choice: Optional[ChatCompletionToolChoiceParam] = None,
+        tools: Optional[List[ChatCompletionToolParam]] = None,
+        parallel_tool_calls: Optional[bool] = None,
+        user: Optional[str] = None,
+        service_tier: Optional[RequestServiceTier] = None,
+        reasoning_effort: Optional[ReasoningEffort] = None,
+        thinking: Optional[ThinkingParam] = None,
+        # AUTOGEN-END create-kwargs
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> ChatCompletionResponse | Stream[ChatCompletionStreamResponse]:
+        return self._post(
+            "/chat/completions",
+            body={
+                # AUTOGEN-START create-body
+                "messages": messages,
+                "model": model,
+                "frequency_penalty": frequency_penalty,
+                "presence_penalty": presence_penalty,
+                "repetition_penalty": repetition_penalty,
+                "logit_bias": logit_bias,
+                "logprobs": logprobs,
+                "top_logprobs": top_logprobs,
+                "max_tokens": max_tokens,
+                "max_completion_tokens": max_completion_tokens,
+                "n": n,
+                "response_format": response_format,
+                "stop": stop,
+                "stream": stream,
+                "stream_options": stream_options,
+                "temperature": temperature,
+                "top_p": top_p,
+                "tool_choice": tool_choice,
+                "tools": tools,
+                "parallel_tool_calls": parallel_tool_calls,
+                "user": user,
+                "service_tier": service_tier,
+                "reasoning_effort": reasoning_effort,
+                "thinking": thinking,
+                # AUTOGEN-END create-body
+            },
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            cast_to=ChatCompletionResponse,
+            stream=stream or False,
+            stream_cls=Stream[ChatCompletionStreamResponse],
+        )
+
+
+class AsyncCompletions(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncCompletionsWithRawResponse:
+        return AsyncCompletionsWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncCompletionsWithStreamingResponse:
+        return AsyncCompletionsWithStreamingResponse(self)
+
+    @async_with_sts_token
+    @async_with_e2e_encryption
+    async def create(
+        self,
+        *,
+        # AUTOGEN-START create-kwargs
+        messages: List[ChatCompletionRequestMessageParam],
+        model: str,
+        frequency_penalty: Optional[float] = None,
+        presence_penalty: Optional[float] = None,
+        repetition_penalty: Optional[float] = None,
+        logit_bias: Optional[Dict[str, float]] = None,
+        logprobs: Optional[bool] = None,
+        top_logprobs: Optional[int] = None,
+        max_tokens: Optional[int] = None,
+        max_completion_tokens: Optional[int] = None,
+        n: Optional[int] = None,
+        response_format: Optional[ChatCompletionResponseFormatParam] = None,
+        stop: Optional[ChatCompletionStopParam] = None,
+        stream: Optional[bool] = None,
+        stream_options: Optional[ChatCompletionStreamOptionsParam] = None,
+        temperature: Optional[float] = None,
+        top_p: Optional[float] = None,
+        tool_choice: Optional[ChatCompletionToolChoiceParam] = None,
+        tools: Optional[List[ChatCompletionToolParam]] = None,
+        parallel_tool_calls: Optional[bool] = None,
+        user: Optional[str] = None,
+        service_tier: Optional[RequestServiceTier] = None,
+        reasoning_effort: Optional[ReasoningEffort] = None,
+        thinking: Optional[ThinkingParam] = None,
+        # AUTOGEN-END create-kwargs
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> ChatCompletionResponse | AsyncStream[ChatCompletionStreamResponse]:
+        return await self._post(
+            "/chat/completions",
+            body={
+                # AUTOGEN-START create-body
+                "messages": messages,
+                "model": model,
+                "frequency_penalty": frequency_penalty,
+                "presence_penalty": presence_penalty,
+                "repetition_penalty": repetition_penalty,
+                "logit_bias": logit_bias,
+                "logprobs": logprobs,
+                "top_logprobs": top_logprobs,
+                "max_tokens": max_tokens,
+                "max_completion_tokens": max_completion_tokens,
+                "n": n,
+                "response_format": response_format,
+                "stop": stop,
+                "stream": stream,
+                "stream_options": stream_options,
+                "temperature": temperature,
+                "top_p": top_p,
+                "tool_choice": tool_choice,
+                "tools": tools,
+                "parallel_tool_calls": parallel_tool_calls,
+                "user": user,
+                "service_tier": service_tier,
+                "reasoning_effort": reasoning_effort,
+                "thinking": thinking,
+                # AUTOGEN-END create-body
+            },
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            cast_to=ChatCompletionResponse,
+            stream=stream or False,
+            stream_cls=AsyncStream[ChatCompletionStreamResponse],
+        )
+
+
+class CompletionsWithRawResponse:
+    def __init__(self, completions: Completions) -> None:
+        self._completions = completions
+        self.create = to_raw_response_wrapper(completions.create)
+
+
+class AsyncCompletionsWithRawResponse:
+    def __init__(self, completions: AsyncCompletions) -> None:
+        self._completions = completions
+        self.create = async_to_raw_response_wrapper(completions.create)
+
+
+class CompletionsWithStreamingResponse:
+    def __init__(self, completions: Completions) -> None:
+        self._completions = completions
+        self.create = to_streamed_response_wrapper(completions.create)
+
+
+class AsyncCompletionsWithStreamingResponse:
+    def __init__(self, completions: AsyncCompletions) -> None:
+        self._completions = completions
+        self.create = async_to_streamed_response_wrapper(completions.create)

arkruntime/resources/content_generation/__init__.py

@@ -0,0 +1,7 @@
+# Copyright (c) 2025 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+# License text: https://github.com/volcengine/ark-runtime-python/blob/main/LICENSE
+
+from .content_generation import AsyncContentGeneration, ContentGeneration
+
+__all__ = ["ContentGeneration", "AsyncContentGeneration"]

arkruntime/resources/content_generation/content_generation.py

@@ -0,0 +1,21 @@
+# Copyright (c) 2025 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+# License text: https://github.com/volcengine/ark-runtime-python/blob/main/LICENSE
+
+from __future__ import annotations
+
+from ..._compat import cached_property
+from ..._resource import AsyncAPIResource, SyncAPIResource
+from .tasks import AsyncTasks, Tasks
+
+
+class ContentGeneration(SyncAPIResource):
+    @cached_property
+    def tasks(self) -> Tasks:
+        return Tasks(self._client)
+
+
+class AsyncContentGeneration(AsyncAPIResource):
+    @cached_property
+    def tasks(self) -> AsyncTasks:
+        return AsyncTasks(self._client)

arkruntime/resources/content_generation/tasks.py

@@ -0,0 +1,331 @@
+# Copyright (c) 2025 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+# License text: https://github.com/volcengine/ark-runtime-python/blob/main/LICENSE
+
+from __future__ import annotations
+
+from typing import List, Optional
+
+import httpx
+from typing_extensions import Literal
+
+from ..._base_client import make_request_options
+from ..._resource import AsyncAPIResource, SyncAPIResource
+from ..._types import Body, Headers, Query
+from ..._utils import maybe_transform
+
+# AUTOGEN-START create-imports
+from ...types.content_generation.content_generation_task import ContentGenerationTask
+from ...types.content_generation.content_item_param import ContentItemParam
+from ...types.content_generation.create_content_generation_task_response import CreateContentGenerationTaskResponse
+from ...types.content_generation.list_content_generation_tasks_response import ListContentGenerationTasksResponse
+from ...types.content_generation.reasoning_effort import ReasoningEffort
+from ...types.content_generation.tool_param import ToolParam
+
+# AUTOGEN-END create-imports
+
+__all__ = ["Tasks", "AsyncTasks"]
+
+_BASE = "/contents/generations/tasks"
+
+
+class Tasks(SyncAPIResource):
+    def create(
+        self,
+        *,
+        # AUTOGEN-START create-kwargs
+        model: str,
+        content: List[ContentItemParam],
+        callback_url: Optional[str] = None,
+        return_last_frame: Optional[bool] = None,
+        service_tier: Optional[str] = None,
+        execution_expires_after: Optional[int] = None,
+        generate_audio: Optional[bool] = None,
+        camera_fixed: Optional[bool] = None,
+        watermark: Optional[bool] = None,
+        seed: Optional[int] = None,
+        resolution: Optional[str] = None,
+        ratio: Optional[str] = None,
+        duration: Optional[int] = None,
+        frames: Optional[int] = None,
+        subdivision_level: Optional[str] = None,
+        file_format: Optional[str] = None,
+        draft: Optional[bool] = None,
+        optimize_prompt: Optional[bool] = None,
+        tools: Optional[List[ToolParam]] = None,
+        reasoning_effort: Optional[ReasoningEffort] = None,
+        human_face_mode: Optional[str] = None,
+        safety_identifier: Optional[str] = None,
+        # AUTOGEN-END create-kwargs
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> CreateContentGenerationTaskResponse:
+        return self._post(
+            _BASE,
+            body={
+                # AUTOGEN-START create-body
+                "model": model,
+                "content": content,
+                "callback_url": callback_url,
+                "return_last_frame": return_last_frame,
+                "service_tier": service_tier,
+                "execution_expires_after": execution_expires_after,
+                "generate_audio": generate_audio,
+                "camera_fixed": camera_fixed,
+                "watermark": watermark,
+                "seed": seed,
+                "resolution": resolution,
+                "ratio": ratio,
+                "duration": duration,
+                "frames": frames,
+                "subdivision_level": subdivision_level,
+                "file_format": file_format,
+                "draft": draft,
+                "optimize_prompt": optimize_prompt,
+                "tools": tools,
+                "reasoning_effort": reasoning_effort,
+                "human_face_mode": human_face_mode,
+                "safety_identifier": safety_identifier,
+                # AUTOGEN-END create-body
+            },
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            cast_to=CreateContentGenerationTaskResponse,
+        )
+
+    def get(
+        self,
+        task_id: str,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> ContentGenerationTask:
+        return self._get(
+            f"{_BASE}/{task_id}",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            cast_to=ContentGenerationTask,
+        )
+
+    def list(
+        self,
+        *,
+        # AUTOGEN-START list-kwargs
+        page_num: Optional[int] = None,
+        page_size: Optional[int] = None,
+        status: Optional[Literal["queued", "running", "cancelled", "succeeded", "failed"]] = None,
+        task_ids: Optional[List[str]] = None,
+        model: Optional[str] = None,
+        service_tier: Optional[str] = None,
+        # AUTOGEN-END list-kwargs
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> ListContentGenerationTasksResponse:
+        return self._get(
+            _BASE,
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        # AUTOGEN-START list-query
+                        "page_num": page_num,
+                        "page_size": page_size,
+                        "filter.status": status,
+                        "filter.task_ids": task_ids,
+                        "filter.model": model,
+                        "filter.service_tier": service_tier,
+                        # AUTOGEN-END list-query
+                    },
+                    dict,
+                ),
+            ),
+            cast_to=ListContentGenerationTasksResponse,
+        )
+
+    def delete(
+        self,
+        task_id: str,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> None:
+        self._delete(
+            f"{_BASE}/{task_id}",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            cast_to=type(None),
+        )
+
+
+class AsyncTasks(AsyncAPIResource):
+    async def create(
+        self,
+        *,
+        # AUTOGEN-START create-kwargs
+        model: str,
+        content: List[ContentItemParam],
+        callback_url: Optional[str] = None,
+        return_last_frame: Optional[bool] = None,
+        service_tier: Optional[str] = None,
+        execution_expires_after: Optional[int] = None,
+        generate_audio: Optional[bool] = None,
+        camera_fixed: Optional[bool] = None,
+        watermark: Optional[bool] = None,
+        seed: Optional[int] = None,
+        resolution: Optional[str] = None,
+        ratio: Optional[str] = None,
+        duration: Optional[int] = None,
+        frames: Optional[int] = None,
+        subdivision_level: Optional[str] = None,
+        file_format: Optional[str] = None,
+        draft: Optional[bool] = None,
+        optimize_prompt: Optional[bool] = None,
+        tools: Optional[List[ToolParam]] = None,
+        reasoning_effort: Optional[ReasoningEffort] = None,
+        human_face_mode: Optional[str] = None,
+        safety_identifier: Optional[str] = None,
+        # AUTOGEN-END create-kwargs
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> CreateContentGenerationTaskResponse:
+        return await self._post(
+            _BASE,
+            body={
+                # AUTOGEN-START create-body
+                "model": model,
+                "content": content,
+                "callback_url": callback_url,
+                "return_last_frame": return_last_frame,
+                "service_tier": service_tier,
+                "execution_expires_after": execution_expires_after,
+                "generate_audio": generate_audio,
+                "camera_fixed": camera_fixed,
+                "watermark": watermark,
+                "seed": seed,
+                "resolution": resolution,
+                "ratio": ratio,
+                "duration": duration,
+                "frames": frames,
+                "subdivision_level": subdivision_level,
+                "file_format": file_format,
+                "draft": draft,
+                "optimize_prompt": optimize_prompt,
+                "tools": tools,
+                "reasoning_effort": reasoning_effort,
+                "human_face_mode": human_face_mode,
+                "safety_identifier": safety_identifier,
+                # AUTOGEN-END create-body
+            },
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            cast_to=CreateContentGenerationTaskResponse,
+        )
+
+    async def get(
+        self,
+        task_id: str,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> ContentGenerationTask:
+        return await self._get(
+            f"{_BASE}/{task_id}",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            cast_to=ContentGenerationTask,
+        )
+
+    async def list(
+        self,
+        *,
+        # AUTOGEN-START list-kwargs
+        page_num: Optional[int] = None,
+        page_size: Optional[int] = None,
+        status: Optional[Literal["queued", "running", "cancelled", "succeeded", "failed"]] = None,
+        task_ids: Optional[List[str]] = None,
+        model: Optional[str] = None,
+        service_tier: Optional[str] = None,
+        # AUTOGEN-END list-kwargs
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> ListContentGenerationTasksResponse:
+        return await self._get(
+            _BASE,
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        # AUTOGEN-START list-query
+                        "page_num": page_num,
+                        "page_size": page_size,
+                        "filter.status": status,
+                        "filter.task_ids": task_ids,
+                        "filter.model": model,
+                        "filter.service_tier": service_tier,
+                        # AUTOGEN-END list-query
+                    },
+                    dict,
+                ),
+            ),
+            cast_to=ListContentGenerationTasksResponse,
+        )
+
+    async def delete(
+        self,
+        task_id: str,
+        *,
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None = None,
+    ) -> None:
+        await self._delete(
+            f"{_BASE}/{task_id}",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+            ),
+            cast_to=type(None),
+        )

arkruntime/resources/embeddings/__init__.py

@@ -0,0 +1,6 @@
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from arkruntime.resources.embeddings.embeddings import AsyncEmbeddings, Embeddings
+
+__all__ = ["Embeddings", "AsyncEmbeddings"]