perplexityai 0.13.0__tar.gz → 0.14.0__tar.gz

perplexityai-0.14.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.14.0"
+}

{perplexityai-0.13.0 → perplexityai-0.14.0}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.14.0 (2025-10-08)
+
+Full Changelog: [v0.13.0...v0.14.0](https://github.com/perplexityai/perplexity-py/compare/v0.13.0...v0.14.0)
+
+### Features
+
+* **api:** manual updates ([6c510ea](https://github.com/perplexityai/perplexity-py/commit/6c510eaf7239b14380059214d2fdb65fe2048d5c))
+
 ## 0.13.0 (2025-10-02)
 
 Full Changelog: [v0.12.1...v0.13.0](https://github.com/perplexityai/perplexity-py/compare/v0.12.1...v0.13.0)

{perplexityai-0.13.0 → perplexityai-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: perplexityai
-Version: 0.13.0
+Version: 0.14.0
 Summary: The official Python library for the perplexity API
 Project-URL: Homepage, https://github.com/perplexityai/perplexity-py
 Project-URL: Repository, https://github.com/perplexityai/perplexity-py

{perplexityai-0.13.0 → perplexityai-0.14.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "perplexityai"
-version = "0.13.0"
+version = "0.14.0"
 description = "The official Python library for the perplexity API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "perplexity"
-__version__ = "0.13.0"  # x-release-please-version
+__version__ = "0.14.0"  # x-release-please-version

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/resources/async_/chat/completions.py

@@ -58,10 +58,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionCreateResponse:
         """
-        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.
+        Submit an asynchronous chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -97,7 +94,7 @@ class CompletionsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionListResponse:
-        """list all async chat completion requests for a given user."""
+        """Retrieve a list of all asynchronous chat completion requests for a given user."""
         return self._get(
             "/async/chat/completions",
             options=make_request_options(
@@ -113,6 +110,7 @@ class CompletionsResource(SyncAPIResource):
         local_mode: bool | Omit = omit,
         x_client_env: str | Omit = omit,
         x_client_name: str | Omit = omit,
+        x_created_at_epoch_seconds: str | Omit = omit,
         x_request_time: str | Omit = omit,
         x_usage_tier: str | Omit = omit,
         x_user_id: str | Omit = omit,
@@ -124,7 +122,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionGetResponse:
         """
-        get the response for a given async chat completion request.
+        Retrieve the response for a given asynchronous chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -142,6 +140,7 @@ class CompletionsResource(SyncAPIResource):
                 {
                     "x-client-env": x_client_env,
                     "x-client-name": x_client_name,
+                    "x-created-at-epoch-seconds": x_created_at_epoch_seconds,
                     "x-request-time": x_request_time,
                     "x-usage-tier": x_usage_tier,
                     "x-user-id": x_user_id,
@@ -195,10 +194,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionCreateResponse:
         """
-        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.
+        Submit an asynchronous chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -234,7 +230,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionListResponse:
-        """list all async chat completion requests for a given user."""
+        """Retrieve a list of all asynchronous chat completion requests for a given user."""
         return await self._get(
             "/async/chat/completions",
             options=make_request_options(
@@ -250,6 +246,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         local_mode: bool | Omit = omit,
         x_client_env: str | Omit = omit,
         x_client_name: str | Omit = omit,
+        x_created_at_epoch_seconds: str | Omit = omit,
         x_request_time: str | Omit = omit,
         x_usage_tier: str | Omit = omit,
         x_user_id: str | Omit = omit,
@@ -261,7 +258,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionGetResponse:
         """
-        get the response for a given async chat completion request.
+        Retrieve the response for a given asynchronous chat completion request.
 
         Args:
           extra_headers: Send extra headers
@@ -279,6 +276,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
                 {
                     "x-client-env": x_client_env,
                     "x-client-name": x_client_name,
+                    "x-created-at-epoch-seconds": x_created_at_epoch_seconds,
                     "x-request-time": x_request_time,
                     "x-usage-tier": x_usage_tier,
                     "x-user-id": x_user_id,

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/resources/chat/completions.py

@@ -68,6 +68,7 @@ class CompletionsResource(SyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -95,7 +96,9 @@ class CompletionsResource(SyncAPIResource):
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
         stream: Optional[Literal[False]] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -103,6 +106,7 @@ class CompletionsResource(SyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -112,7 +116,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StreamChunk:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -148,6 +152,7 @@ class CompletionsResource(SyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -174,7 +179,9 @@ class CompletionsResource(SyncAPIResource):
         search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -182,6 +189,7 @@ class CompletionsResource(SyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -191,7 +199,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Stream[StreamChunk]:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -227,6 +235,7 @@ class CompletionsResource(SyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -253,7 +262,9 @@ class CompletionsResource(SyncAPIResource):
         search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -261,6 +272,7 @@ class CompletionsResource(SyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -270,7 +282,7 @@ class CompletionsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StreamChunk | Stream[StreamChunk]:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -305,6 +317,7 @@ class CompletionsResource(SyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -332,7 +345,9 @@ class CompletionsResource(SyncAPIResource):
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
         stream: Optional[Literal[False]] | Literal[True] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -340,6 +355,7 @@ class CompletionsResource(SyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -370,6 +386,7 @@ class CompletionsResource(SyncAPIResource):
                     "has_image_url": has_image_url,
                     "image_domain_filter": image_domain_filter,
                     "image_format_filter": image_format_filter,
+                    "language_preference": language_preference,
                     "last_updated_after_filter": last_updated_after_filter,
                     "last_updated_before_filter": last_updated_before_filter,
                     "latitude": latitude,
@@ -397,7 +414,9 @@ class CompletionsResource(SyncAPIResource):
                     "search_tenant": search_tenant,
                     "stop": stop,
                     "stream": stream,
+                    "stream_mode": stream_mode,
                     "temperature": temperature,
+                    "thread_id": thread_id,
                     "tool_choice": tool_choice,
                     "tools": tools,
                     "top_k": top_k,
@@ -405,6 +424,7 @@ class CompletionsResource(SyncAPIResource):
                     "top_p": top_p,
                     "updated_after_timestamp": updated_after_timestamp,
                     "updated_before_timestamp": updated_before_timestamp,
+                    "use_threads": use_threads,
                     "web_search_options": web_search_options,
                 },
                 completion_create_params.CompletionCreateParamsStreaming
@@ -462,6 +482,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -489,7 +510,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
         stream: Optional[Literal[False]] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -497,6 +520,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -506,7 +530,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StreamChunk:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -542,6 +566,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -568,7 +593,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
         search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -576,6 +603,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -585,7 +613,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncStream[StreamChunk]:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -621,6 +649,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -647,7 +676,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
         search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -655,6 +686,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -664,7 +696,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> StreamChunk | AsyncStream[StreamChunk]:
         """
-        FastAPI wrapper around chat completions
+        Generate a chat completion response for the given conversation.
 
         Args:
           extra_headers: Send extra headers
@@ -699,6 +731,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         has_image_url: bool | Omit = omit,
         image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
         image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        language_preference: Optional[str] | Omit = omit,
         last_updated_after_filter: Optional[str] | Omit = omit,
         last_updated_before_filter: Optional[str] | Omit = omit,
         latitude: Optional[float] | Omit = omit,
@@ -726,7 +759,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
         search_tenant: Optional[str] | Omit = omit,
         stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
         stream: Optional[Literal[False]] | Literal[True] | Omit = omit,
+        stream_mode: Literal["full", "concise"] | Omit = omit,
         temperature: Optional[float] | Omit = omit,
+        thread_id: Optional[str] | Omit = omit,
         tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
         tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
         top_k: Optional[int] | Omit = omit,
@@ -734,6 +769,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         top_p: Optional[float] | Omit = omit,
         updated_after_timestamp: Optional[int] | Omit = omit,
         updated_before_timestamp: Optional[int] | Omit = omit,
+        use_threads: Optional[bool] | Omit = omit,
         web_search_options: completion_create_params.WebSearchOptions | 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.
@@ -764,6 +800,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
                     "has_image_url": has_image_url,
                     "image_domain_filter": image_domain_filter,
                     "image_format_filter": image_format_filter,
+                    "language_preference": language_preference,
                     "last_updated_after_filter": last_updated_after_filter,
                     "last_updated_before_filter": last_updated_before_filter,
                     "latitude": latitude,
@@ -791,7 +828,9 @@ class AsyncCompletionsResource(AsyncAPIResource):
                     "search_tenant": search_tenant,
                     "stop": stop,
                     "stream": stream,
+                    "stream_mode": stream_mode,
                     "temperature": temperature,
+                    "thread_id": thread_id,
                     "tool_choice": tool_choice,
                     "tools": tools,
                     "top_k": top_k,
@@ -799,6 +838,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
                     "top_p": top_p,
                     "updated_after_timestamp": updated_after_timestamp,
                     "updated_before_timestamp": updated_before_timestamp,
+                    "use_threads": use_threads,
                     "web_search_options": web_search_options,
                 },
                 completion_create_params.CompletionCreateParamsStreaming

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/resources/search.py

@@ -48,7 +48,7 @@ class SearchResource(SyncAPIResource):
         self,
         *,
         query: Union[str, SequenceNotStr[str]],
-        country: Optional[str] | Omit = omit,
+        display_server_time: bool | Omit = omit,
         max_results: int | Omit = omit,
         max_tokens: int | Omit = omit,
         max_tokens_per_page: int | Omit = omit,
@@ -61,7 +61,7 @@ class SearchResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchCreateResponse:
         """
-        Search
+        Search the web and retrieve relevant web page contents.
 
         Args:
           extra_headers: Send extra headers
@@ -77,7 +77,7 @@ class SearchResource(SyncAPIResource):
             body=maybe_transform(
                 {
                     "query": query,
-                    "country": country,
+                    "display_server_time": display_server_time,
                     "max_results": max_results,
                     "max_tokens": max_tokens,
                     "max_tokens_per_page": max_tokens_per_page,
@@ -116,7 +116,7 @@ class AsyncSearchResource(AsyncAPIResource):
         self,
         *,
         query: Union[str, SequenceNotStr[str]],
-        country: Optional[str] | Omit = omit,
+        display_server_time: bool | Omit = omit,
         max_results: int | Omit = omit,
         max_tokens: int | Omit = omit,
         max_tokens_per_page: int | Omit = omit,
@@ -129,7 +129,7 @@ class AsyncSearchResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchCreateResponse:
         """
-        Search
+        Search the web and retrieve relevant web page contents.
 
         Args:
           extra_headers: Send extra headers
@@ -145,7 +145,7 @@ class AsyncSearchResource(AsyncAPIResource):
             body=await async_maybe_transform(
                 {
                     "query": query,
-                    "country": country,
+                    "display_server_time": display_server_time,
                     "max_results": max_results,
                     "max_tokens": max_tokens,
                     "max_tokens_per_page": max_tokens_per_page,

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/types/async_/chat/completion_create_params.py

@@ -124,7 +124,7 @@ class RequestWebSearchOptions(TypedDict, total=False):
 
     search_context_size: Literal["low", "medium", "high"]
 
-    search_type: Literal["fast", "pro", "auto"]
+    search_type: Optional[Literal["fast", "pro", "auto"]]
 
     user_location: Optional[RequestWebSearchOptionsUserLocation]
 
@@ -166,6 +166,8 @@ class Request(TypedDict, total=False):
 
     image_format_filter: Optional[SequenceNotStr[str]]
 
+    language_preference: Optional[str]
+
     last_updated_after_filter: Optional[str]
 
     last_updated_before_filter: Optional[str]
@@ -220,8 +222,12 @@ class Request(TypedDict, total=False):
 
     stream: Optional[bool]
 
+    stream_mode: Literal["full", "concise"]
+
     temperature: Optional[float]
 
+    thread_id: Optional[str]
+
     tool_choice: Optional[Literal["none", "auto", "required"]]
 
     tools: Optional[Iterable[RequestTool]]
@@ -236,4 +242,6 @@ class Request(TypedDict, total=False):
 
     updated_before_timestamp: Optional[int]
 
+    use_threads: Optional[bool]
+
     web_search_options: RequestWebSearchOptions

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/types/async_/chat/completion_get_params.py

@@ -16,6 +16,8 @@ class CompletionGetParams(TypedDict, total=False):
 
     x_client_name: Annotated[str, PropertyInfo(alias="x-client-name")]
 
+    x_created_at_epoch_seconds: Annotated[str, PropertyInfo(alias="x-created-at-epoch-seconds")]
+
     x_request_time: Annotated[str, PropertyInfo(alias="x-request-time")]
 
     x_usage_tier: Annotated[str, PropertyInfo(alias="x-usage-tier")]

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/types/chat/completion_create_params.py

@@ -64,6 +64,8 @@ class CompletionCreateParamsBase(TypedDict, total=False):
 
     image_format_filter: Optional[SequenceNotStr[str]]
 
+    language_preference: Optional[str]
+
     last_updated_after_filter: Optional[str]
 
     last_updated_before_filter: Optional[str]
@@ -116,8 +118,12 @@ class CompletionCreateParamsBase(TypedDict, total=False):
 
     stop: Union[str, SequenceNotStr[str], None]
 
+    stream_mode: Literal["full", "concise"]
+
     temperature: Optional[float]
 
+    thread_id: Optional[str]
+
     tool_choice: Optional[Literal["none", "auto", "required"]]
 
     tools: Optional[Iterable[Tool]]
@@ -132,6 +138,8 @@ class CompletionCreateParamsBase(TypedDict, total=False):
 
     updated_before_timestamp: Optional[int]
 
+    use_threads: Optional[bool]
+
     web_search_options: WebSearchOptions
 
 
@@ -225,7 +233,7 @@ class WebSearchOptions(TypedDict, total=False):
 
     search_context_size: Literal["low", "medium", "high"]
 
-    search_type: Literal["fast", "pro", "auto"]
+    search_type: Optional[Literal["fast", "pro", "auto"]]
 
     user_location: Optional[WebSearchOptionsUserLocation]
 

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/types/search_create_params.py

@@ -13,7 +13,7 @@ __all__ = ["SearchCreateParams"]
 class SearchCreateParams(TypedDict, total=False):
     query: Required[Union[str, SequenceNotStr[str]]]
 
-    country: Optional[str]
+    display_server_time: bool
 
     max_results: int
 

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/types/search_create_response.py

@@ -23,3 +23,5 @@ class SearchCreateResponse(BaseModel):
     id: str
 
     results: List[Result]
+
+    server_time: Optional[str] = None

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/types/shared/api_public_search_result.py

@@ -1,6 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from typing import Optional
+from typing_extensions import Literal
 
 from ..._models import BaseModel
 
@@ -17,3 +18,5 @@ class APIPublicSearchResult(BaseModel):
     last_updated: Optional[str] = None
 
     snippet: Optional[str] = None
+
+    source: Optional[Literal["web", "attachment"]] = None

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/types/shared_params/api_public_search_result.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Optional
-from typing_extensions import Required, TypedDict
+from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["APIPublicSearchResult"]
 
@@ -18,3 +18,5 @@ class APIPublicSearchResult(TypedDict, total=False):
     last_updated: Optional[str]
 
     snippet: str
+
+    source: Literal["web", "attachment"]

{perplexityai-0.13.0 → perplexityai-0.14.0}/src/perplexity/types/stream_chunk.py

@@ -20,8 +20,6 @@ class StreamChunk(BaseModel):
 
     model: str
 
-    usage: UsageInfo
-
     citations: Optional[List[str]] = None
 
     object: Optional[str] = None
@@ -31,3 +29,5 @@ class StreamChunk(BaseModel):
     status: Optional[Literal["PENDING", "COMPLETED"]] = None
 
     type: Optional[Literal["message", "info", "end_of_stream"]] = None
+
+    usage: Optional[UsageInfo] = None