chore: update OpenAPI spec and rebuild SDKs

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 36
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/replicate%2Freplicate-client-729e21274ba5899bc422e10f9bc19fea7279c9166216480fefa3f3e73be5f3b4.yml
-openapi_spec_hash: bc7c6df73c0563285573965ab248c01b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/replicate%2Freplicate-client-7a537f433b0b71a42a3d53ce6182cc06790157bbb379461eed93cdb68659bc92.yml
+openapi_spec_hash: 5c7633dce3ece58e21f74d826946914c
 config_hash: 407acf62c906ee301314f2d23cdb58b1

api.md

@@ -90,7 +90,7 @@ from replicate.types import (
 Methods:
 
 - <code title="post /models">replicate.models.<a href="./src/replicate/resources/models/models.py">create</a>(\*\*<a href="src/replicate/types/model_create_params.py">params</a>) -> <a href="./src/replicate/types/model_create_response.py">ModelCreateResponse</a></code>
-- <code title="get /models">replicate.models.<a href="./src/replicate/resources/models/models.py">list</a>() -> <a href="./src/replicate/types/model_list_response.py">SyncCursorURLPage[ModelListResponse]</a></code>
+- <code title="get /models">replicate.models.<a href="./src/replicate/resources/models/models.py">list</a>(\*\*<a href="src/replicate/types/model_list_params.py">params</a>) -> <a href="./src/replicate/types/model_list_response.py">SyncCursorURLPage[ModelListResponse]</a></code>
 - <code title="delete /models/{model_owner}/{model_name}">replicate.models.<a href="./src/replicate/resources/models/models.py">delete</a>(\*, model_owner, model_name) -> None</code>
 - <code title="get /models/{model_owner}/{model_name}">replicate.models.<a href="./src/replicate/resources/models/models.py">get</a>(\*, model_owner, model_name) -> <a href="./src/replicate/types/model_get_response.py">ModelGetResponse</a></code>
 - <code title="query /models">replicate.models.<a href="./src/replicate/resources/models/models.py">search</a>(\*\*<a href="src/replicate/types/model_search_params.py">params</a>) -> <a href="./src/replicate/types/model_search_response.py">SyncCursorURLPage[ModelSearchResponse]</a></code>

src/replicate/resources/models/models.py

@@ -14,7 +14,7 @@
     ReadmeResourceWithStreamingResponse,
     AsyncReadmeResourceWithStreamingResponse,
 )
-from ...types import model_create_params, model_search_params
+from ...types import model_list_params, model_create_params, model_search_params
 from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from .examples import (
@@ -209,6 +209,8 @@ def create(
     def list(
         self,
         *,
+        sort_by: Literal["model_created_at", "latest_version_created_at"] | Omit = omit,
+        sort_direction: Literal["asc", "desc"] | 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,
@@ -231,12 +233,56 @@ def list(
 
         See the [`models.get`](#models.get) docs for more details about the model
         object.
+
+        ## Sorting
+
+        You can sort the results using the `sort_by` and `sort_direction` query
+        parameters.
+
+        For example, to get the most recently created models:
+
+        ```console
+        curl -s \\
+          -H "Authorization: Bearer $REPLICATE_API_TOKEN" \\
+          "https://api.replicate.com/v1/models?sort_by=model_created_at&sort_direction=desc"
+        ```
+
+        Available sorting options:
+
+        - `model_created_at`: Sort by when the model was first created
+        - `latest_version_created_at`: Sort by when the model's latest version was
+          created (default)
+
+        Sort direction can be `asc` (ascending) or `desc` (descending, default).
+
+        Args:
+          sort_by: Field to sort models by. Defaults to `latest_version_created_at`.
+
+          sort_direction: Sort direction. Defaults to `desc` (descending, newest first).
+
+          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._get_api_list(
             "/models",
             page=SyncCursorURLPage[ModelListResponse],
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "sort_by": sort_by,
+                        "sort_direction": sort_direction,
+                    },
+                    model_list_params.ModelListParams,
+                ),
             ),
             model=ModelListResponse,
         )
@@ -608,6 +654,8 @@ async def create(
     def list(
         self,
         *,
+        sort_by: Literal["model_created_at", "latest_version_created_at"] | Omit = omit,
+        sort_direction: Literal["asc", "desc"] | 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,
@@ -630,12 +678,56 @@ def list(
 
         See the [`models.get`](#models.get) docs for more details about the model
         object.
+
+        ## Sorting
+
+        You can sort the results using the `sort_by` and `sort_direction` query
+        parameters.
+
+        For example, to get the most recently created models:
+
+        ```console
+        curl -s \\
+          -H "Authorization: Bearer $REPLICATE_API_TOKEN" \\
+          "https://api.replicate.com/v1/models?sort_by=model_created_at&sort_direction=desc"
+        ```
+
+        Available sorting options:
+
+        - `model_created_at`: Sort by when the model was first created
+        - `latest_version_created_at`: Sort by when the model's latest version was
+          created (default)
+
+        Sort direction can be `asc` (ascending) or `desc` (descending, default).
+
+        Args:
+          sort_by: Field to sort models by. Defaults to `latest_version_created_at`.
+
+          sort_direction: Sort direction. Defaults to `desc` (descending, newest first).
+
+          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._get_api_list(
             "/models",
             page=AsyncCursorURLPage[ModelListResponse],
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "sort_by": sort_by,
+                        "sort_direction": sort_direction,
+                    },
+                    model_list_params.ModelListParams,
+                ),
             ),
             model=ModelListResponse,
         )

src/replicate/types/__init__.py

@@ -5,6 +5,7 @@
 from .prediction import Prediction as Prediction
 from .search_response import SearchResponse as SearchResponse
 from .file_get_response import FileGetResponse as FileGetResponse
+from .model_list_params import ModelListParams as ModelListParams
 from .file_create_params import FileCreateParams as FileCreateParams
 from .file_list_response import FileListResponse as FileListResponse
 from .model_get_response import ModelGetResponse as ModelGetResponse

src/replicate/types/model_list_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["ModelListParams"]
+
+
+class ModelListParams(TypedDict, total=False):
+    sort_by: Literal["model_created_at", "latest_version_created_at"]
+    """Field to sort models by. Defaults to `latest_version_created_at`."""
+
+    sort_direction: Literal["asc", "desc"]
+    """Sort direction. Defaults to `desc` (descending, newest first)."""

tests/api_resources/test_models.py

@@ -88,6 +88,15 @@ def test_method_list(self, client: Replicate) -> None:
         model = client.models.list()
         assert_matches_type(SyncCursorURLPage[ModelListResponse], model, path=["response"])
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_list_with_all_params(self, client: Replicate) -> None:
+        model = client.models.list(
+            sort_by="model_created_at",
+            sort_direction="asc",
+        )
+        assert_matches_type(SyncCursorURLPage[ModelListResponse], model, path=["response"])
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_raw_response_list(self, client: Replicate) -> None:
@@ -319,6 +328,15 @@ async def test_method_list(self, async_client: AsyncReplicate) -> None:
         model = await async_client.models.list()
         assert_matches_type(AsyncCursorURLPage[ModelListResponse], model, path=["response"])
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_list_with_all_params(self, async_client: AsyncReplicate) -> None:
+        model = await async_client.models.list(
+            sort_by="model_created_at",
+            sort_direction="asc",
+        )
+        assert_matches_type(AsyncCursorURLPage[ModelListResponse], model, path=["response"])
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_raw_response_list(self, async_client: AsyncReplicate) -> None: