release: 1.5.0

.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/groqcloud-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install Rye
         run: |
@@ -46,7 +46,7 @@ jobs:
       id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/groqcloud-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install Rye
         run: |
@@ -67,7 +67,7 @@ jobs:
           github.repository == 'stainless-sdks/groqcloud-python' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -87,7 +87,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/groqcloud-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install Rye
         run: |

.github/workflows/publish-pypi.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install Rye
         run: |

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'groq/groq-python' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check release environment
         run: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.4.0"
+  ".": "1.5.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 17
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud/groqcloud-0298a69b7d74303a353e8a586d85e5cc769b9560920487fadfe773c0100af249.yml
-openapi_spec_hash: 4fad55cf0c3fc26500f4030edf31b64d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/groqcloud/groqcloud-e027dee69ce2400029f173e30aa64962a1237f18d1c1a31ffb64d7985666bc3b.yml
+openapi_spec_hash: 4adaaf66c023faf06005a6a68512fee8
 config_hash: 6468f67ad7c0d0333daea97b2f5403a4

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.5.0 (2026-06-03)
+
+Full Changelog: [v1.4.0...v1.5.0](https://github.com/groq/groq-python/compare/v1.4.0...v1.5.0)
+
+### Features
+
+* **api:** api update ([8f8ef54](https://github.com/groq/groq-python/commit/8f8ef5411bec440b97ab8951e04e806770a4cbf3))
+
 ## 1.4.0 (2026-05-12)
 
 Full Changelog: [v1.3.0...v1.4.0](https://github.com/groq/groq-python/compare/v1.3.0...v1.4.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "groq"
-version = "1.4.0"
+version = "1.5.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__ = "1.4.0"  # x-release-please-version
+__version__ = "1.5.0"  # x-release-please-version

src/groq/types/chat/chat_completion.py

@@ -86,9 +86,7 @@ class UsageBreakdownModel(BaseModel):
 
 
 class UsageBreakdown(BaseModel):
-    """
-    Detailed usage breakdown by model when multiple models are used in the request for compound AI systems.
-    """
+    """Usage statistics for compound AI completion requests."""
 
     models: List[UsageBreakdownModel]
     """List of models used in the request and their individual usage statistics"""
@@ -188,10 +186,7 @@ class ChatCompletion(BaseModel):
     """Usage statistics for the completion request."""
 
     usage_breakdown: Optional[UsageBreakdown] = None
-    """
-    Detailed usage breakdown by model when multiple models are used in the request
-    for compound AI systems.
-    """
+    """Usage statistics for compound AI completion requests."""
 
     x_groq: Optional[XGroq] = None
     """Groq-specific metadata for non-streaming chat completion responses."""