together 2.0.0a16__py3-none-any.whl → 2.0.0a18__py3-none-any.whl

together/resources/beta/jig/volumes.py

@@ -0,0 +1,514 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal
+
+import httpx
+
+from ...._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from ...._utils import maybe_transform, async_maybe_transform
+from ...._compat import cached_property
+from ...._resource import SyncAPIResource, AsyncAPIResource
+from ...._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ...._base_client import make_request_options
+from ....types.beta.jig import volume_create_params, volume_update_params
+from ....types.beta.jig.volume import Volume
+from ....types.beta.jig.volume_list_response import VolumeListResponse
+
+__all__ = ["VolumesResource", "AsyncVolumesResource"]
+
+
+class VolumesResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> VolumesResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/togethercomputer/together-py#accessing-raw-response-data-eg-headers
+        """
+        return VolumesResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> VolumesResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/togethercomputer/together-py#with_streaming_response
+        """
+        return VolumesResourceWithStreamingResponse(self)
+
+    def create(
+        self,
+        *,
+        content: volume_create_params.Content,
+        name: str,
+        type: Literal["readOnly"],
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Volume:
+        """
+        Create a new volume to preload files in deployments
+
+        Args:
+          content: Content specifies the content configuration for this volume
+
+          name: Name is the unique identifier for the volume within the project
+
+          type: Type is the volume type (currently only "readOnly" is supported)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/deployments/storage/volumes",
+            body=maybe_transform(
+                {
+                    "content": content,
+                    "name": name,
+                    "type": type,
+                },
+                volume_create_params.VolumeCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Volume,
+        )
+
+    def retrieve(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Volume:
+        """
+        Retrieve details of a specific volume by its ID or name
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get(
+            f"/deployments/storage/volumes/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Volume,
+        )
+
+    def update(
+        self,
+        id: str,
+        *,
+        content: volume_update_params.Content | Omit = omit,
+        name: str | Omit = omit,
+        type: Literal["readOnly"] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Volume:
+        """
+        Update an existing volume's configuration or contents
+
+        Args:
+          content: Content specifies the new content that will be preloaded to this volume
+
+          name: Name is the new unique identifier for the volume within the project
+
+          type: Type is the new volume type (currently only "readOnly" is supported)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._patch(
+            f"/deployments/storage/volumes/{id}",
+            body=maybe_transform(
+                {
+                    "content": content,
+                    "name": name,
+                    "type": type,
+                },
+                volume_update_params.VolumeUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Volume,
+        )
+
+    def list(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> VolumeListResponse:
+        """Retrieve all volumes in your project"""
+        return self._get(
+            "/deployments/storage/volumes",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=VolumeListResponse,
+        )
+
+    def delete(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> object:
+        """
+        Delete an existing volume
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._delete(
+            f"/deployments/storage/volumes/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
+
+class AsyncVolumesResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncVolumesResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/togethercomputer/together-py#accessing-raw-response-data-eg-headers
+        """
+        return AsyncVolumesResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncVolumesResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/togethercomputer/together-py#with_streaming_response
+        """
+        return AsyncVolumesResourceWithStreamingResponse(self)
+
+    async def create(
+        self,
+        *,
+        content: volume_create_params.Content,
+        name: str,
+        type: Literal["readOnly"],
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Volume:
+        """
+        Create a new volume to preload files in deployments
+
+        Args:
+          content: Content specifies the content configuration for this volume
+
+          name: Name is the unique identifier for the volume within the project
+
+          type: Type is the volume type (currently only "readOnly" is supported)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/deployments/storage/volumes",
+            body=await async_maybe_transform(
+                {
+                    "content": content,
+                    "name": name,
+                    "type": type,
+                },
+                volume_create_params.VolumeCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Volume,
+        )
+
+    async def retrieve(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Volume:
+        """
+        Retrieve details of a specific volume by its ID or name
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._get(
+            f"/deployments/storage/volumes/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Volume,
+        )
+
+    async def update(
+        self,
+        id: str,
+        *,
+        content: volume_update_params.Content | Omit = omit,
+        name: str | Omit = omit,
+        type: Literal["readOnly"] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Volume:
+        """
+        Update an existing volume's configuration or contents
+
+        Args:
+          content: Content specifies the new content that will be preloaded to this volume
+
+          name: Name is the new unique identifier for the volume within the project
+
+          type: Type is the new volume type (currently only "readOnly" is supported)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._patch(
+            f"/deployments/storage/volumes/{id}",
+            body=await async_maybe_transform(
+                {
+                    "content": content,
+                    "name": name,
+                    "type": type,
+                },
+                volume_update_params.VolumeUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Volume,
+        )
+
+    async def list(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> VolumeListResponse:
+        """Retrieve all volumes in your project"""
+        return await self._get(
+            "/deployments/storage/volumes",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=VolumeListResponse,
+        )
+
+    async def delete(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> object:
+        """
+        Delete an existing volume
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._delete(
+            f"/deployments/storage/volumes/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
+
+class VolumesResourceWithRawResponse:
+    def __init__(self, volumes: VolumesResource) -> None:
+        self._volumes = volumes
+
+        self.create = to_raw_response_wrapper(
+            volumes.create,
+        )
+        self.retrieve = to_raw_response_wrapper(
+            volumes.retrieve,
+        )
+        self.update = to_raw_response_wrapper(
+            volumes.update,
+        )
+        self.list = to_raw_response_wrapper(
+            volumes.list,
+        )
+        self.delete = to_raw_response_wrapper(
+            volumes.delete,
+        )
+
+
+class AsyncVolumesResourceWithRawResponse:
+    def __init__(self, volumes: AsyncVolumesResource) -> None:
+        self._volumes = volumes
+
+        self.create = async_to_raw_response_wrapper(
+            volumes.create,
+        )
+        self.retrieve = async_to_raw_response_wrapper(
+            volumes.retrieve,
+        )
+        self.update = async_to_raw_response_wrapper(
+            volumes.update,
+        )
+        self.list = async_to_raw_response_wrapper(
+            volumes.list,
+        )
+        self.delete = async_to_raw_response_wrapper(
+            volumes.delete,
+        )
+
+
+class VolumesResourceWithStreamingResponse:
+    def __init__(self, volumes: VolumesResource) -> None:
+        self._volumes = volumes
+
+        self.create = to_streamed_response_wrapper(
+            volumes.create,
+        )
+        self.retrieve = to_streamed_response_wrapper(
+            volumes.retrieve,
+        )
+        self.update = to_streamed_response_wrapper(
+            volumes.update,
+        )
+        self.list = to_streamed_response_wrapper(
+            volumes.list,
+        )
+        self.delete = to_streamed_response_wrapper(
+            volumes.delete,
+        )
+
+
+class AsyncVolumesResourceWithStreamingResponse:
+    def __init__(self, volumes: AsyncVolumesResource) -> None:
+        self._volumes = volumes
+
+        self.create = async_to_streamed_response_wrapper(
+            volumes.create,
+        )
+        self.retrieve = async_to_streamed_response_wrapper(
+            volumes.retrieve,
+        )
+        self.update = async_to_streamed_response_wrapper(
+            volumes.update,
+        )
+        self.list = async_to_streamed_response_wrapper(
+            volumes.list,
+        )
+        self.delete = async_to_streamed_response_wrapper(
+            volumes.delete,
+        )

together/resources/chat/completions.py

@@ -74,6 +74,7 @@ class CompletionsResource(SyncAPIResource):
         min_p: float | Omit = omit,
         n: int | Omit = omit,
         presence_penalty: float | Omit = omit,
+        reasoning: completion_create_params.Reasoning | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         repetition_penalty: float | Omit = omit,
         response_format: completion_create_params.ResponseFormat | Omit = omit,
@@ -222,6 +223,7 @@ class CompletionsResource(SyncAPIResource):
         min_p: float | Omit = omit,
         n: int | Omit = omit,
         presence_penalty: float | Omit = omit,
+        reasoning: completion_create_params.Reasoning | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         repetition_penalty: float | Omit = omit,
         response_format: completion_create_params.ResponseFormat | Omit = omit,
@@ -369,6 +371,7 @@ class CompletionsResource(SyncAPIResource):
         min_p: float | Omit = omit,
         n: int | Omit = omit,
         presence_penalty: float | Omit = omit,
+        reasoning: completion_create_params.Reasoning | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         repetition_penalty: float | Omit = omit,
         response_format: completion_create_params.ResponseFormat | Omit = omit,
@@ -515,6 +518,7 @@ class CompletionsResource(SyncAPIResource):
         min_p: float | Omit = omit,
         n: int | Omit = omit,
         presence_penalty: float | Omit = omit,
+        reasoning: completion_create_params.Reasoning | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         repetition_penalty: float | Omit = omit,
         response_format: completion_create_params.ResponseFormat | Omit = omit,
@@ -552,6 +556,7 @@ class CompletionsResource(SyncAPIResource):
                     "min_p": min_p,
                     "n": n,
                     "presence_penalty": presence_penalty,
+                    "reasoning": reasoning,
                     "reasoning_effort": reasoning_effort,
                     "repetition_penalty": repetition_penalty,
                     "response_format": response_format,
@@ -625,6 +630,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         min_p: float | Omit = omit,
         n: int | Omit = omit,
         presence_penalty: float | Omit = omit,
+        reasoning: completion_create_params.Reasoning | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         repetition_penalty: float | Omit = omit,
         response_format: completion_create_params.ResponseFormat | Omit = omit,
@@ -773,6 +779,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         min_p: float | Omit = omit,
         n: int | Omit = omit,
         presence_penalty: float | Omit = omit,
+        reasoning: completion_create_params.Reasoning | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         repetition_penalty: float | Omit = omit,
         response_format: completion_create_params.ResponseFormat | Omit = omit,
@@ -920,6 +927,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         min_p: float | Omit = omit,
         n: int | Omit = omit,
         presence_penalty: float | Omit = omit,
+        reasoning: completion_create_params.Reasoning | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         repetition_penalty: float | Omit = omit,
         response_format: completion_create_params.ResponseFormat | Omit = omit,
@@ -1066,6 +1074,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         min_p: float | Omit = omit,
         n: int | Omit = omit,
         presence_penalty: float | Omit = omit,
+        reasoning: completion_create_params.Reasoning | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         repetition_penalty: float | Omit = omit,
         response_format: completion_create_params.ResponseFormat | Omit = omit,
@@ -1103,6 +1112,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
                     "min_p": min_p,
                     "n": n,
                     "presence_penalty": presence_penalty,
+                    "reasoning": reasoning,
                     "reasoning_effort": reasoning_effort,
                     "repetition_penalty": repetition_penalty,
                     "response_format": response_format,

together/resources/endpoints.py

@@ -81,7 +81,7 @@ class EndpointsResource(SyncAPIResource):
 
           availability_zone: Create the endpoint in a specified availability zone (e.g., us-central-4b)
 
-          disable_prompt_cache: Whether to disable the prompt cache for this endpoint
+          disable_prompt_cache: This parameter is deprecated and no longer has any effect.
 
           disable_speculative_decoding: Whether to disable speculative decoding for this endpoint
 
@@ -375,7 +375,7 @@ class AsyncEndpointsResource(AsyncAPIResource):
 
           availability_zone: Create the endpoint in a specified availability zone (e.g., us-central-4b)
 
-          disable_prompt_cache: Whether to disable the prompt cache for this endpoint
+          disable_prompt_cache: This parameter is deprecated and no longer has any effect.
 
           disable_speculative_decoding: Whether to disable speculative decoding for this endpoint
 

together/resources/models/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .models import (
+    ModelsResource,
+    AsyncModelsResource,
+    ModelsResourceWithRawResponse,
+    AsyncModelsResourceWithRawResponse,
+    ModelsResourceWithStreamingResponse,
+    AsyncModelsResourceWithStreamingResponse,
+)
+from .uploads import (
+    UploadsResource,
+    AsyncUploadsResource,
+    UploadsResourceWithRawResponse,
+    AsyncUploadsResourceWithRawResponse,
+    UploadsResourceWithStreamingResponse,
+    AsyncUploadsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "UploadsResource",
+    "AsyncUploadsResource",
+    "UploadsResourceWithRawResponse",
+    "AsyncUploadsResourceWithRawResponse",
+    "UploadsResourceWithStreamingResponse",
+    "AsyncUploadsResourceWithStreamingResponse",
+    "ModelsResource",
+    "AsyncModelsResource",
+    "ModelsResourceWithRawResponse",
+    "AsyncModelsResourceWithRawResponse",
+    "ModelsResourceWithStreamingResponse",
+    "AsyncModelsResourceWithStreamingResponse",
+]