release: 0.28.0 (#245)

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: Graden Rea <[email protected]>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.27.0"
+  ".": "0.28.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-d6462cdccc879903e070222172f392feb1487969a39fb8399983e57f0a731fdd.yml
-openapi_spec_hash: 00207ab94189df55f0229c088475d4ad
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud%2Fgroqcloud-ea5b03626ef6c5d62792b87e2bef9acff936112791abe056db5d0a7a66ba39d7.yml
+openapi_spec_hash: 841fe2e4ce7db3d377f7ad03cd973344
 config_hash: 6b1c374dcc1ffa3165dd22f52a77ff89

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.28.0 (2025-06-12)
+
+Full Changelog: [v0.27.0...v0.28.0](https://github.com/groq/groq-python/compare/v0.27.0...v0.28.0)
+
+### Features
+
+* **api:** api update ([1b088b1](https://github.com/groq/groq-python/commit/1b088b11e42ddd9b04c3fa9fc0d1cf957696529a))
+* **api:** api update ([2a96d4f](https://github.com/groq/groq-python/commit/2a96d4fbcf6dbff9a8125a0f5f9d73ffe97d5223))
+* **api:** api update ([089ab40](https://github.com/groq/groq-python/commit/089ab404ada560ca59048ec23981252f439165ea))
+
+
+### Chores
+
+* fix streaming overloads ([bb31101](https://github.com/groq/groq-python/commit/bb3110118ca7fe8258d7eaed6856a1bed560e533))
+
 ## 0.27.0 (2025-06-10)
 
 Full Changelog: [v0.26.0...v0.27.0](https://github.com/groq/groq-python/compare/v0.26.0...v0.27.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "groq"
-version = "0.27.0"
+version = "0.28.0"
 description = "The official Python library for the groq API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/groq/_version.py

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

src/groq/resources/chat/completions.py

@@ -68,6 +68,7 @@ def create(
         n: Optional[int] | NotGiven = NOT_GIVEN,
         parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
         presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
+        reasoning_effort: Optional[Literal["none", "default"]] | NotGiven = NOT_GIVEN,
         reasoning_format: Optional[Literal["hidden", "raw", "parsed"]] | NotGiven = NOT_GIVEN,
         response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
         search_settings: Optional[completion_create_params.SearchSettings] | NotGiven = NOT_GIVEN,
@@ -110,6 +111,7 @@ def create(
         n: Optional[int] | NotGiven = NOT_GIVEN,
         parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
         presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
+        reasoning_effort: Optional[Literal["none", "default"]] | NotGiven = NOT_GIVEN,
         reasoning_format: Optional[Literal["hidden", "raw", "parsed"]] | NotGiven = NOT_GIVEN,
         response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
         search_settings: Optional[completion_create_params.SearchSettings] | NotGiven = NOT_GIVEN,
@@ -152,6 +154,7 @@ def create(
         n: Optional[int] | NotGiven = NOT_GIVEN,
         parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
         presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
+        reasoning_effort: Optional[Literal["none", "default"]] | NotGiven = NOT_GIVEN,
         reasoning_format: Optional[Literal["hidden", "raw", "parsed"]] | NotGiven = NOT_GIVEN,
         response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
         search_settings: Optional[completion_create_params.SearchSettings] | NotGiven = NOT_GIVEN,
@@ -203,6 +206,7 @@ def create(
         n: Optional[int] | NotGiven = NOT_GIVEN,
         parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
         presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
+        reasoning_effort: Optional[Literal["none", "default"]] | NotGiven = NOT_GIVEN,
         reasoning_format: Optional[Literal["hidden", "raw", "parsed"]] | NotGiven = NOT_GIVEN,
         response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
         search_settings: Optional[completion_create_params.SearchSettings] | NotGiven = NOT_GIVEN,
@@ -285,6 +289,9 @@ def create(
               whether they appear in the text so far, increasing the model's likelihood to
               talk about new topics.
 
+          reasoning_effort: this field is only available for qwen3 models. Set to 'none' to disable
+              reasoning. Set to 'default' or null to let Qwen reason.
+
           reasoning_format: Specifies how to output reasoning tokens
 
           response_format: An object specifying the format that the model must output. Setting to
@@ -377,6 +384,7 @@ def create(
                     "n": n,
                     "parallel_tool_calls": parallel_tool_calls,
                     "presence_penalty": presence_penalty,
+                    "reasoning_effort": reasoning_effort,
                     "reasoning_format": reasoning_format,
                     "response_format": response_format,
                     "search_settings": search_settings,
@@ -442,6 +450,7 @@ async def create(
         n: Optional[int] | NotGiven = NOT_GIVEN,
         parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
         presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
+        reasoning_effort: Optional[Literal["none", "default"]] | NotGiven = NOT_GIVEN,
         reasoning_format: Optional[Literal["hidden", "raw", "parsed"]] | NotGiven = NOT_GIVEN,
         response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
         search_settings: Optional[completion_create_params.SearchSettings] | NotGiven = NOT_GIVEN,
@@ -484,6 +493,7 @@ async def create(
         n: Optional[int] | NotGiven = NOT_GIVEN,
         parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
         presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
+        reasoning_effort: Optional[Literal["none", "default"]] | NotGiven = NOT_GIVEN,
         reasoning_format: Optional[Literal["hidden", "raw", "parsed"]] | NotGiven = NOT_GIVEN,
         response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
         search_settings: Optional[completion_create_params.SearchSettings] | NotGiven = NOT_GIVEN,
@@ -526,6 +536,7 @@ async def create(
         n: Optional[int] | NotGiven = NOT_GIVEN,
         parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
         presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
+        reasoning_effort: Optional[Literal["none", "default"]] | NotGiven = NOT_GIVEN,
         reasoning_format: Optional[Literal["hidden", "raw", "parsed"]] | NotGiven = NOT_GIVEN,
         response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
         search_settings: Optional[completion_create_params.SearchSettings] | NotGiven = NOT_GIVEN,
@@ -577,6 +588,7 @@ async def create(
         n: Optional[int] | NotGiven = NOT_GIVEN,
         parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
         presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
+        reasoning_effort: Optional[Literal["none", "default"]] | NotGiven = NOT_GIVEN,
         reasoning_format: Optional[Literal["hidden", "raw", "parsed"]] | NotGiven = NOT_GIVEN,
         response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
         search_settings: Optional[completion_create_params.SearchSettings] | NotGiven = NOT_GIVEN,
@@ -659,6 +671,9 @@ async def create(
               whether they appear in the text so far, increasing the model's likelihood to
               talk about new topics.
 
+          reasoning_effort: this field is only available for qwen3 models. Set to 'none' to disable
+              reasoning. Set to 'default' or null to let Qwen reason.
+
           reasoning_format: Specifies how to output reasoning tokens
 
           response_format: An object specifying the format that the model must output. Setting to
@@ -751,6 +766,7 @@ async def create(
                     "n": n,
                     "parallel_tool_calls": parallel_tool_calls,
                     "presence_penalty": presence_penalty,
+                    "reasoning_effort": reasoning_effort,
                     "reasoning_format": reasoning_format,
                     "response_format": response_format,
                     "search_settings": search_settings,

src/groq/types/chat/chat_completion_assistant_message_param.py

@@ -47,5 +47,11 @@ class ChatCompletionAssistantMessageParam(TypedDict, total=False):
     role.
     """
 
+    reasoning: Optional[str]
+    """
+    The reasoning output by the assistant if reasoning_format was set to 'parsed'.
+    This field is only useable with qwen3 models.
+    """
+
     tool_calls: Iterable[ChatCompletionMessageToolCallParam]
     """The tool calls generated by the model, such as function calls."""

src/groq/types/chat/chat_completion_message.py

@@ -25,15 +25,32 @@ class ExecutedToolCodeResultChartElement(BaseModel):
     angle: Optional[float] = None
     """The angle for this element"""
 
+    first_quartile: Optional[float] = None
+    """The first quartile value for this element"""
+
     group: Optional[str] = None
     """The group this element belongs to"""
 
+    max: Optional[float] = None
+
+    median: Optional[float] = None
+    """The median value for this element"""
+
+    min: Optional[float] = None
+    """The minimum value for this element"""
+
+    outliers: Optional[List[float]] = None
+    """The outliers for this element"""
+
     points: Optional[List[List[float]]] = None
     """The points for this element"""
 
     radius: Optional[float] = None
     """The radius for this element"""
 
+    third_quartile: Optional[float] = None
+    """The third quartile value for this element"""
+
     value: Optional[float] = None
     """The value for this element"""
 

src/groq/types/chat/completion_create_params.py

@@ -132,6 +132,12 @@ class CompletionCreateParams(TypedDict, total=False):
     far, increasing the model's likelihood to talk about new topics.
     """
 
+    reasoning_effort: Optional[Literal["none", "default"]]
+    """
+    this field is only available for qwen3 models. Set to 'none' to disable
+    reasoning. Set to 'default' or null to let Qwen reason.
+    """
+
     reasoning_format: Optional[Literal["hidden", "raw", "parsed"]]
     """Specifies how to output reasoning tokens"""
 

tests/api_resources/chat/test_completions.py

@@ -60,6 +60,7 @@ def test_method_create_with_all_params(self, client: Groq) -> None:
             n=1,
             parallel_tool_calls=True,
             presence_penalty=-2,
+            reasoning_effort="none",
             reasoning_format="hidden",
             response_format={"type": "text"},
             search_settings={
@@ -173,6 +174,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncGroq) -> N
             n=1,
             parallel_tool_calls=True,
             presence_penalty=-2,
+            reasoning_effort="none",
             reasoning_format="hidden",
             response_format={"type": "text"},
             search_settings={