feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 6
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/perplexity-ai%2Fperplexity-0a20b2c1a864613083f602f3589f85caa0e39b04c29c0a37db76f6398dfd2f50.yml
-openapi_spec_hash: 5c8d07ba17d180b472679f2b85def126
-config_hash: d3612805022ba4461f6399145be920d5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/perplexity-ai%2Fperplexity-0a0c41e4a1d04f467b380f19330aad7cccfdf3550c269995b6921dfd68615c51.yml
+openapi_spec_hash: 030643101899103819c1004f32cafbbc
+config_hash: 17c338b2ef0119791bd9f178936b252f

README.md

@@ -184,10 +184,10 @@ completion = client.chat.completions.create(
             "role": "system",
         }
     ],
-    model="sonar",
-    web_search_options={},
+    model="model",
+    debug_params={},
 )
-print(completion.web_search_options)
+print(completion.debug_params)
 ```
 
 ## Handling errors

api.md

@@ -1,7 +1,13 @@
 # Shared Types
 
 ```python
-from perplexity.types import ChatChoice, ChatMessage, SearchResult, UsageInfo
+from perplexity.types import (
+    APIPublicSearchResult,
+    ChatMessageInput,
+    ChatMessageOutput,
+    Choice,
+    UsageInfo,
+)
 ```
 
 # Chat
@@ -37,8 +43,8 @@ from perplexity.types.async_.chat import (
 Methods:
 
 - <code title="post /async/chat/completions">client.async*.chat.completions.<a href="./src/perplexity/resources/async*/chat/completions.py">create</a>(\*\*<a href="src/perplexity/types/async_/chat/completion_create_params.py">params</a>) -> <a href="./src/perplexity/types/async_/chat/completion_create_response.py">CompletionCreateResponse</a></code>
-- <code title="get /async/chat/completions">client.async*.chat.completions.<a href="./src/perplexity/resources/async*/chat/completions.py">list</a>(\*\*<a href="src/perplexity/types/async_/chat/completion_list_params.py">params</a>) -> <a href="./src/perplexity/types/async_/chat/completion_list_response.py">CompletionListResponse</a></code>
-- <code title="get /async/chat/completions/{request_id}">client.async*.chat.completions.<a href="./src/perplexity/resources/async*/chat/completions.py">get</a>(request*id) -> <a href="./src/perplexity/types/async*/chat/completion_get_response.py">CompletionGetResponse</a></code>
+- <code title="get /async/chat/completions">client.async*.chat.completions.<a href="./src/perplexity/resources/async*/chat/completions.py">list</a>() -> <a href="./src/perplexity/types/async_/chat/completion_list_response.py">CompletionListResponse</a></code>
+- <code title="get /async/chat/completions/{api_request}">client.async*.chat.completions.<a href="./src/perplexity/resources/async*/chat/completions.py">get</a>(api*request, \*\*<a href="src/perplexity/types/async*/chat/completion*get_params.py">params</a>) -> <a href="./src/perplexity/types/async*/chat/completion_get_response.py">CompletionGetResponse</a></code>
 
 # Search
 

src/perplexity/resources/async_/chat/completions.py

@@ -2,10 +2,12 @@
 
 from __future__ import annotations
 
+from typing import Optional
+
 import httpx
 
 from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
-from ...._utils import maybe_transform, async_maybe_transform
+from ...._utils import maybe_transform, strip_not_given, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
@@ -15,7 +17,7 @@
     async_to_streamed_response_wrapper,
 )
 from ...._base_client import make_request_options
-from ....types.async_.chat import completion_list_params, completion_create_params
+from ....types.async_.chat import completion_get_params, completion_create_params
 from ....types.async_.chat.completion_get_response import CompletionGetResponse
 from ....types.async_.chat.completion_list_response import CompletionListResponse
 from ....types.async_.chat.completion_create_response import CompletionCreateResponse
@@ -47,6 +49,7 @@ def create(
         self,
         *,
         request: completion_create_params.Request,
+        idempotency_key: Optional[str] | NotGiven = NOT_GIVEN,
         # 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,
@@ -55,7 +58,10 @@ def create(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> CompletionCreateResponse:
         """
-        Creates an asynchronous chat completion job
+        FastAPI wrapper around async chat completions
+
+        This endpoint creates an asynchronous chat completion job and returns a job ID
+        that can be used to poll for results.
 
         Args:
           extra_headers: Send extra headers
@@ -68,7 +74,13 @@ def create(
         """
         return self._post(
             "/async/chat/completions",
-            body=maybe_transform({"request": request}, completion_create_params.CompletionCreateParams),
+            body=maybe_transform(
+                {
+                    "request": request,
+                    "idempotency_key": idempotency_key,
+                },
+                completion_create_params.CompletionCreateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -78,53 +90,32 @@ def create(
     def list(
         self,
         *,
-        limit: int | NotGiven = NOT_GIVEN,
-        next_token: str | NotGiven = NOT_GIVEN,
         # 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,
     ) -> CompletionListResponse:
-        """
-        Lists all asynchronous chat completion requests for the authenticated user
-
-        Args:
-          limit: Maximum number of requests to return
-
-          next_token: Token for fetching the next page of results
-
-          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
-        """
+        """list all async chat completion requests for a given user."""
         return self._get(
             "/async/chat/completions",
             options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform(
-                    {
-                        "limit": limit,
-                        "next_token": next_token,
-                    },
-                    completion_list_params.CompletionListParams,
-                ),
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
             cast_to=CompletionListResponse,
         )
 
     def get(
         self,
-        request_id: str,
+        api_request: str,
         *,
+        local_mode: bool | NotGiven = NOT_GIVEN,
+        x_client_env: str | NotGiven = NOT_GIVEN,
+        x_client_name: str | NotGiven = NOT_GIVEN,
+        x_request_time: str | NotGiven = NOT_GIVEN,
+        x_usage_tier: str | NotGiven = NOT_GIVEN,
+        x_user_id: str | NotGiven = NOT_GIVEN,
         # 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,
@@ -133,7 +124,7 @@ def get(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> CompletionGetResponse:
         """
-        Retrieves the status and result of a specific asynchronous chat completion job
+        get the response for a given async chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -144,12 +135,28 @@ def get(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not request_id:
-            raise ValueError(f"Expected a non-empty value for `request_id` but received {request_id!r}")
+        if not api_request:
+            raise ValueError(f"Expected a non-empty value for `api_request` but received {api_request!r}")
+        extra_headers = {
+            **strip_not_given(
+                {
+                    "x-client-env": x_client_env,
+                    "x-client-name": x_client_name,
+                    "x-request-time": x_request_time,
+                    "x-usage-tier": x_usage_tier,
+                    "x-user-id": x_user_id,
+                }
+            ),
+            **(extra_headers or {}),
+        }
         return self._get(
-            f"/async/chat/completions/{request_id}",
+            f"/async/chat/completions/{api_request}",
             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({"local_mode": local_mode}, completion_get_params.CompletionGetParams),
             ),
             cast_to=CompletionGetResponse,
         )
@@ -179,6 +186,7 @@ async def create(
         self,
         *,
         request: completion_create_params.Request,
+        idempotency_key: Optional[str] | NotGiven = NOT_GIVEN,
         # 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,
@@ -187,7 +195,10 @@ async def create(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> CompletionCreateResponse:
         """
-        Creates an asynchronous chat completion job
+        FastAPI wrapper around async chat completions
+
+        This endpoint creates an asynchronous chat completion job and returns a job ID
+        that can be used to poll for results.
 
         Args:
           extra_headers: Send extra headers
@@ -200,7 +211,13 @@ async def create(
         """
         return await self._post(
             "/async/chat/completions",
-            body=await async_maybe_transform({"request": request}, completion_create_params.CompletionCreateParams),
+            body=await async_maybe_transform(
+                {
+                    "request": request,
+                    "idempotency_key": idempotency_key,
+                },
+                completion_create_params.CompletionCreateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -210,53 +227,32 @@ async def create(
     async def list(
         self,
         *,
-        limit: int | NotGiven = NOT_GIVEN,
-        next_token: str | NotGiven = NOT_GIVEN,
         # 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,
     ) -> CompletionListResponse:
-        """
-        Lists all asynchronous chat completion requests for the authenticated user
-
-        Args:
-          limit: Maximum number of requests to return
-
-          next_token: Token for fetching the next page of results
-
-          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
-        """
+        """list all async chat completion requests for a given user."""
         return await self._get(
             "/async/chat/completions",
             options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {
-                        "limit": limit,
-                        "next_token": next_token,
-                    },
-                    completion_list_params.CompletionListParams,
-                ),
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
             cast_to=CompletionListResponse,
         )
 
     async def get(
         self,
-        request_id: str,
+        api_request: str,
         *,
+        local_mode: bool | NotGiven = NOT_GIVEN,
+        x_client_env: str | NotGiven = NOT_GIVEN,
+        x_client_name: str | NotGiven = NOT_GIVEN,
+        x_request_time: str | NotGiven = NOT_GIVEN,
+        x_usage_tier: str | NotGiven = NOT_GIVEN,
+        x_user_id: str | NotGiven = NOT_GIVEN,
         # 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,
@@ -265,7 +261,7 @@ async def get(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> CompletionGetResponse:
         """
-        Retrieves the status and result of a specific asynchronous chat completion job
+        get the response for a given async chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -276,12 +272,30 @@ async def get(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not request_id:
-            raise ValueError(f"Expected a non-empty value for `request_id` but received {request_id!r}")
+        if not api_request:
+            raise ValueError(f"Expected a non-empty value for `api_request` but received {api_request!r}")
+        extra_headers = {
+            **strip_not_given(
+                {
+                    "x-client-env": x_client_env,
+                    "x-client-name": x_client_name,
+                    "x-request-time": x_request_time,
+                    "x-usage-tier": x_usage_tier,
+                    "x-user-id": x_user_id,
+                }
+            ),
+            **(extra_headers or {}),
+        }
         return await self._get(
-            f"/async/chat/completions/{request_id}",
+            f"/async/chat/completions/{api_request}",
             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=await async_maybe_transform(
+                    {"local_mode": local_mode}, completion_get_params.CompletionGetParams
+                ),
             ),
             cast_to=CompletionGetResponse,
         )