prelude-python-sdk 0.5.0__tar.gz → 0.7.0__tar.gz

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/.gitignore

@@ -1,5 +1,4 @@
 .prism.log
-.vscode
 _dev
 
 __pycache__

prelude_python_sdk-0.7.0/.release-please-manifest.json

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

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/CHANGELOG.md

@@ -1,5 +1,79 @@
 # Changelog
 
+## 0.7.0 (2025-09-03)
+
+Full Changelog: [v0.6.0...v0.7.0](https://github.com/prelude-so/python-sdk/compare/v0.6.0...v0.7.0)
+
+### Features
+
+* **api:** api update ([cebd59c](https://github.com/prelude-so/python-sdk/commit/cebd59c1f67146b7e840bbccc6b4a2d17916bdca))
+* **api:** update via SDK Studio ([609835d](https://github.com/prelude-so/python-sdk/commit/609835dc935b7c22bd0bfec3216278ede1771bed))
+* clean up environment call outs ([ff48f3e](https://github.com/prelude-so/python-sdk/commit/ff48f3e5cb1fb68096e0f4957905ee48856d1df7))
+* **client:** support file upload requests ([ac0a4c1](https://github.com/prelude-so/python-sdk/commit/ac0a4c1701251a38422125a077ae7add7416c1a5))
+* improve future compat with pydantic v3 ([8ac53e8](https://github.com/prelude-so/python-sdk/commit/8ac53e8eb18c084e32881aa804eb003610133276))
+* **types:** replace List[str] with SequenceNotStr in params ([a376204](https://github.com/prelude-so/python-sdk/commit/a3762043fce5190bf8e507a0eb45de86bbc52183))
+
+
+### Bug Fixes
+
+* avoid newer type syntax ([a254a0e](https://github.com/prelude-so/python-sdk/commit/a254a0eaff6b2c7e4c0beb7ae704bf0e11a99f03))
+* **ci:** correct conditional ([b7261ff](https://github.com/prelude-so/python-sdk/commit/b7261ff9886067756fb25e32b6909b15790377dc))
+* **ci:** release-doctor — report correct token name ([77a8e56](https://github.com/prelude-so/python-sdk/commit/77a8e5698965234e6619e1050e703af72b57e48e))
+* **client:** don't send Content-Type header on GET requests ([c613df9](https://github.com/prelude-so/python-sdk/commit/c613df92d49194b1a1f89e2a9e0f6ab0fac8d472))
+* **parsing:** correctly handle nested discriminated unions ([3436bf4](https://github.com/prelude-so/python-sdk/commit/3436bf4532297cd94a44e997474ac0398483dd0c))
+* **parsing:** ignore empty metadata ([c23e14b](https://github.com/prelude-so/python-sdk/commit/c23e14b9ec01412e132ee9d03ae4bbaff74f33ac))
+* **parsing:** parse extra field types ([bf9be03](https://github.com/prelude-so/python-sdk/commit/bf9be03f3613d2babb797dd5f74da85c09c3c897))
+
+
+### Chores
+
+* **ci:** change upload type ([7c6c5df](https://github.com/prelude-so/python-sdk/commit/7c6c5df63e1959589d2675e0ebf7137d4670e12f))
+* **ci:** only run for pushes and fork pull requests ([b32650a](https://github.com/prelude-so/python-sdk/commit/b32650a2b717410e7e41e4a99e3fe65fc8a855f5))
+* **internal:** add Sequence related utils ([7a7d144](https://github.com/prelude-so/python-sdk/commit/7a7d144d831e463f2ede025dc1324d9162ffc3ed))
+* **internal:** bump pinned h11 dep ([0402574](https://github.com/prelude-so/python-sdk/commit/040257411723704ee4f230aeeb4afc23835903bf))
+* **internal:** change ci workflow machines ([3248bbf](https://github.com/prelude-so/python-sdk/commit/3248bbfe138fe7d6ed1bef914d96e3e2c12953bb))
+* **internal:** codegen related update ([b5e89fd](https://github.com/prelude-so/python-sdk/commit/b5e89fdf678bd950a842af41215cffdd15e8ed78))
+* **internal:** fix ruff target version ([88b0123](https://github.com/prelude-so/python-sdk/commit/88b012325f232611a76989c3af466e499994ce97))
+* **internal:** update comment in script ([786148a](https://github.com/prelude-so/python-sdk/commit/786148a170efc4290dbd513bc52036a9b129d179))
+* **internal:** update pyright exclude list ([c160b8a](https://github.com/prelude-so/python-sdk/commit/c160b8a4fdce40e4408927204dfb602b808ad8de))
+* **internal:** update test skipping reason ([80f788b](https://github.com/prelude-so/python-sdk/commit/80f788b5680588ef9970c40a7f8c26926acf2a3d))
+* **package:** mark python 3.13 as supported ([17711c4](https://github.com/prelude-so/python-sdk/commit/17711c472c274e2b8bf5e094f392d12411c36fc1))
+* **project:** add settings file for vscode ([7f5049f](https://github.com/prelude-so/python-sdk/commit/7f5049f0f71e4b0288d4102ffa67ebf60a1bd500))
+* **readme:** fix version rendering on pypi ([fb60330](https://github.com/prelude-so/python-sdk/commit/fb60330a88cd4371ebee780ffbf5295953d8c43d))
+* update @stainless-api/prism-cli to v5.15.0 ([16ee61e](https://github.com/prelude-so/python-sdk/commit/16ee61e3b8dd042fe52dd6b75b5216f8a0c314d4))
+* update github action ([0541486](https://github.com/prelude-so/python-sdk/commit/054148684c50734248c3a12a78a59686bff5925f))
+
+## 0.6.0 (2025-06-23)
+
+Full Changelog: [v0.5.0...v0.6.0](https://github.com/prelude-so/python-sdk/compare/v0.5.0...v0.6.0)
+
+### Features
+
+* **client:** add follow_redirects request option ([da19e96](https://github.com/prelude-so/python-sdk/commit/da19e966164aceec4e1a1b0d48411972dd16ac57))
+* **client:** add support for aiohttp ([fe01e14](https://github.com/prelude-so/python-sdk/commit/fe01e142af02731f76b0c6d4199a9384f1e9707e))
+
+
+### Bug Fixes
+
+* **client:** correctly parse binary response | stream ([e3dfded](https://github.com/prelude-so/python-sdk/commit/e3dfded9ae983f50630cab36befb34dd6306eb1f))
+* **tests:** fix: tests which call HTTP endpoints directly with the example parameters ([77eef78](https://github.com/prelude-so/python-sdk/commit/77eef78d5df7e67d148a0e52a914b5b91a69b804))
+
+
+### Chores
+
+* **ci:** enable for pull requests ([da78c21](https://github.com/prelude-so/python-sdk/commit/da78c212562c4561494ea3c648aa21289e2e15dc))
+* **docs:** remove reference to rye shell ([17caed7](https://github.com/prelude-so/python-sdk/commit/17caed7d4f227f504f924cb7117923153dbe0c57))
+* **internal:** update conftest.py ([4d73eac](https://github.com/prelude-so/python-sdk/commit/4d73eace815b6ac0422b55f1d52837fd7b515b46))
+* **readme:** update badges ([a5f1b45](https://github.com/prelude-so/python-sdk/commit/a5f1b45fb802eea987c0dcadb5f464fe9071cf44))
+* **tests:** add tests for httpx client instantiation & proxies ([c0a7434](https://github.com/prelude-so/python-sdk/commit/c0a743495858c5082d1a1634855e72efacaaaa22))
+* **tests:** run tests in parallel ([646764a](https://github.com/prelude-so/python-sdk/commit/646764ac379ac82faf861bd1bf00ce593cbf13e9))
+* **tests:** skip some failing tests on the latest python versions ([734cb0d](https://github.com/prelude-so/python-sdk/commit/734cb0dc7855541bc3379bd87c89a41a49f618c7))
+
+
+### Documentation
+
+* **client:** fix httpx.Timeout documentation reference ([041dd82](https://github.com/prelude-so/python-sdk/commit/041dd82ad1711670db7e1fbd4ee11fd1eae0ea99))
+
 ## 0.5.0 (2025-06-02)
 
 Full Changelog: [v0.4.0...v0.5.0](https://github.com/prelude-so/python-sdk/compare/v0.4.0...v0.5.0)

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/CONTRIBUTING.md

@@ -17,8 +17,7 @@ $ rye sync --all-features
 You can then run scripts using `rye run python script.py` or by activating the virtual environment:
 
 ```sh
-$ rye shell
-# or manually activate - https://docs.python.org/3/library/venv.html#how-venvs-work
+# Activate the virtual environment - https://docs.python.org/3/library/venv.html#how-venvs-work
 $ source .venv/bin/activate
 
 # now you can omit the `rye run` prefix

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: prelude-python-sdk
-Version: 0.5.0
+Version: 0.7.0
 Summary: The official Python library for the Prelude API
 Project-URL: Homepage, https://github.com/prelude-so/python-sdk
 Project-URL: Repository, https://github.com/prelude-so/python-sdk
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.8
@@ -27,11 +28,15 @@ Requires-Dist: httpx<1,>=0.23.0
 Requires-Dist: pydantic<3,>=1.9.0
 Requires-Dist: sniffio
 Requires-Dist: typing-extensions<5,>=4.10
+Provides-Extra: aiohttp
+Requires-Dist: aiohttp; extra == 'aiohttp'
+Requires-Dist: httpx-aiohttp>=0.1.8; extra == 'aiohttp'
 Description-Content-Type: text/markdown
 
 # Prelude Python API library
 
-[![PyPI version](https://img.shields.io/pypi/v/prelude-python-sdk.svg)](https://pypi.org/project/prelude-python-sdk/)
+<!-- prettier-ignore -->
+[![PyPI version](https://img.shields.io/pypi/v/prelude-python-sdk.svg?label=pypi%20(stable))](https://pypi.org/project/prelude-python-sdk/)
 
 The Prelude Python library provides convenient access to the Prelude REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,
@@ -105,6 +110,42 @@ asyncio.run(main())
 
 Functionality between the synchronous and asynchronous clients is otherwise identical.
 
+### With aiohttp
+
+By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.
+
+You can enable this by installing `aiohttp`:
+
+```sh
+# install from PyPI
+pip install prelude-python-sdk[aiohttp]
+```
+
+Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
+
+```python
+import asyncio
+from prelude_python_sdk import DefaultAioHttpClient
+from prelude_python_sdk import AsyncPrelude
+
+
+async def main() -> None:
+    async with AsyncPrelude(
+        api_token="My API Token",
+        http_client=DefaultAioHttpClient(),
+    ) as client:
+        verification = await client.verification.create(
+            target={
+                "type": "phone_number",
+                "value": "+30123456789",
+            },
+        )
+        print(verification.id)
+
+
+asyncio.run(main())
+```
+
 ## Using types
 
 Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
@@ -207,7 +248,7 @@ client.with_options(max_retries=5).verification.create(
 ### Timeouts
 
 By default requests time out after 1 minute. You can configure this with a `timeout` option,
-which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
+which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
 from prelude_python_sdk import Prelude

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/README.md

@@ -1,6 +1,7 @@
 # Prelude Python API library
 
-[![PyPI version](https://img.shields.io/pypi/v/prelude-python-sdk.svg)](https://pypi.org/project/prelude-python-sdk/)
+<!-- prettier-ignore -->
+[![PyPI version](https://img.shields.io/pypi/v/prelude-python-sdk.svg?label=pypi%20(stable))](https://pypi.org/project/prelude-python-sdk/)
 
 The Prelude Python library provides convenient access to the Prelude REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,
@@ -74,6 +75,42 @@ asyncio.run(main())
 
 Functionality between the synchronous and asynchronous clients is otherwise identical.
 
+### With aiohttp
+
+By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.
+
+You can enable this by installing `aiohttp`:
+
+```sh
+# install from PyPI
+pip install prelude-python-sdk[aiohttp]
+```
+
+Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
+
+```python
+import asyncio
+from prelude_python_sdk import DefaultAioHttpClient
+from prelude_python_sdk import AsyncPrelude
+
+
+async def main() -> None:
+    async with AsyncPrelude(
+        api_token="My API Token",
+        http_client=DefaultAioHttpClient(),
+    ) as client:
+        verification = await client.verification.create(
+            target={
+                "type": "phone_number",
+                "value": "+30123456789",
+            },
+        )
+        print(verification.id)
+
+
+asyncio.run(main())
+```
+
 ## Using types
 
 Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict). Responses are [Pydantic models](https://docs.pydantic.dev) which also provide helper methods for things like:
@@ -176,7 +213,7 @@ client.with_options(max_retries=5).verification.create(
 ### Timeouts
 
 By default requests time out after 1 minute. You can configure this with a `timeout` option,
-which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
+which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
 from prelude_python_sdk import Prelude

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/bin/check-release-environment

@@ -3,7 +3,7 @@
 errors=()
 
 if [ -z "${PYPI_TOKEN}" ]; then
-  errors+=("The PRELUDE_PYPI_TOKEN secret has not been set. Please set it in either this repository's secrets or your organization secrets.")
+  errors+=("The PYPI_TOKEN secret has not been set. Please set it in either this repository's secrets or your organization secrets.")
 fi
 
 lenErrors=${#errors[@]}

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "prelude-python-sdk"
-version = "0.5.0"
+version = "0.7.0"
 description = "The official Python library for the Prelude API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -24,6 +24,7 @@ classifiers = [
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "Operating System :: OS Independent",
   "Operating System :: POSIX",
   "Operating System :: MacOS",
@@ -37,6 +38,8 @@ classifiers = [
 Homepage = "https://github.com/prelude-so/python-sdk"
 Repository = "https://github.com/prelude-so/python-sdk"
 
+[project.optional-dependencies]
+aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.8"]
 
 [tool.rye]
 managed = true
@@ -54,6 +57,7 @@ dev-dependencies = [
     "importlib-metadata>=6.7.0",
     "rich>=13.7.1",
     "nest_asyncio==1.6.0",
+    "pytest-xdist>=3.6.1",
 ]
 
 [tool.rye.scripts]
@@ -125,7 +129,7 @@ replacement = '[\1](https://github.com/prelude-so/python-sdk/tree/main/\g<2>)'
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-addopts = "--tb=short"
+addopts = "--tb=short -n auto"
 xfail_strict = true
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "session"
@@ -144,6 +148,7 @@ exclude = [
     "_dev",
     ".venv",
     ".nox",
+    ".git",
 ]
 
 reportImplicitOverride = true
@@ -155,7 +160,7 @@ reportPrivateUsage = false
 [tool.ruff]
 line-length = 120
 output-format = "grouped"
-target-version = "py37"
+target-version = "py38"
 
 [tool.ruff.format]
 docstring-code-format = true

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/requirements-dev.lock

@@ -10,6 +10,13 @@
 #   universal: false
 
 -e file:.
+aiohappyeyeballs==2.6.1
+    # via aiohttp
+aiohttp==3.12.8
+    # via httpx-aiohttp
+    # via prelude-python-sdk
+aiosignal==1.3.2
+    # via aiohttp
 annotated-types==0.6.0
     # via pydantic
 anyio==4.4.0
@@ -17,6 +24,10 @@ anyio==4.4.0
     # via prelude-python-sdk
 argcomplete==3.1.2
     # via nox
+async-timeout==5.0.1
+    # via aiohttp
+attrs==25.3.0
+    # via aiohttp
 certifi==2023.7.22
     # via httpcore
     # via httpx
@@ -30,18 +41,27 @@ distro==1.8.0
 exceptiongroup==1.2.2
     # via anyio
     # via pytest
+execnet==2.1.1
+    # via pytest-xdist
 filelock==3.12.4
     # via virtualenv
-h11==0.14.0
+frozenlist==1.6.2
+    # via aiohttp
+    # via aiosignal
+h11==0.16.0
     # via httpcore
-httpcore==1.0.2
+httpcore==1.0.9
     # via httpx
 httpx==0.28.1
+    # via httpx-aiohttp
     # via prelude-python-sdk
     # via respx
+httpx-aiohttp==0.1.8
+    # via prelude-python-sdk
 idna==3.4
     # via anyio
     # via httpx
+    # via yarl
 importlib-metadata==7.0.0
 iniconfig==2.0.0
     # via pytest
@@ -49,6 +69,9 @@ markdown-it-py==3.0.0
     # via rich
 mdurl==0.1.2
     # via markdown-it-py
+multidict==6.4.4
+    # via aiohttp
+    # via yarl
 mypy==1.14.1
 mypy-extensions==1.0.0
     # via mypy
@@ -63,6 +86,9 @@ platformdirs==3.11.0
     # via virtualenv
 pluggy==1.5.0
     # via pytest
+propcache==0.3.1
+    # via aiohttp
+    # via yarl
 pydantic==2.10.3
     # via prelude-python-sdk
 pydantic-core==2.27.1
@@ -72,7 +98,9 @@ pygments==2.18.0
 pyright==1.1.399
 pytest==8.3.3
     # via pytest-asyncio
+    # via pytest-xdist
 pytest-asyncio==0.24.0
+pytest-xdist==3.7.0
 python-dateutil==2.8.2
     # via time-machine
 pytz==2023.3.post1
@@ -93,6 +121,7 @@ tomli==2.0.2
     # via pytest
 typing-extensions==4.12.2
     # via anyio
+    # via multidict
     # via mypy
     # via prelude-python-sdk
     # via pydantic
@@ -100,5 +129,7 @@ typing-extensions==4.12.2
     # via pyright
 virtualenv==20.24.5
     # via nox
+yarl==1.20.0
+    # via aiohttp
 zipp==3.17.0
     # via importlib-metadata

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/requirements.lock

@@ -10,11 +10,22 @@
 #   universal: false
 
 -e file:.
+aiohappyeyeballs==2.6.1
+    # via aiohttp
+aiohttp==3.12.8
+    # via httpx-aiohttp
+    # via prelude-python-sdk
+aiosignal==1.3.2
+    # via aiohttp
 annotated-types==0.6.0
     # via pydantic
 anyio==4.4.0
     # via httpx
     # via prelude-python-sdk
+async-timeout==5.0.1
+    # via aiohttp
+attrs==25.3.0
+    # via aiohttp
 certifi==2023.7.22
     # via httpcore
     # via httpx
@@ -22,15 +33,28 @@ distro==1.8.0
     # via prelude-python-sdk
 exceptiongroup==1.2.2
     # via anyio
-h11==0.14.0
+frozenlist==1.6.2
+    # via aiohttp
+    # via aiosignal
+h11==0.16.0
     # via httpcore
-httpcore==1.0.2
+httpcore==1.0.9
     # via httpx
 httpx==0.28.1
+    # via httpx-aiohttp
+    # via prelude-python-sdk
+httpx-aiohttp==0.1.8
     # via prelude-python-sdk
 idna==3.4
     # via anyio
     # via httpx
+    # via yarl
+multidict==6.4.4
+    # via aiohttp
+    # via yarl
+propcache==0.3.1
+    # via aiohttp
+    # via yarl
 pydantic==2.10.3
     # via prelude-python-sdk
 pydantic-core==2.27.1
@@ -40,6 +64,9 @@ sniffio==1.3.0
     # via prelude-python-sdk
 typing-extensions==4.12.2
     # via anyio
+    # via multidict
     # via prelude-python-sdk
     # via pydantic
     # via pydantic-core
+yarl==1.20.0
+    # via aiohttp

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/src/prelude_python_sdk/__init__.py

@@ -26,7 +26,7 @@ from ._exceptions import (
     UnprocessableEntityError,
     APIResponseValidationError,
 )
-from ._base_client import DefaultHttpxClient, DefaultAsyncHttpxClient
+from ._base_client import DefaultHttpxClient, DefaultAioHttpClient, DefaultAsyncHttpxClient
 from ._utils._logs import setup_logging as _setup_logging
 
 __all__ = [
@@ -68,6 +68,7 @@ __all__ = [
     "DEFAULT_CONNECTION_LIMITS",
     "DefaultHttpxClient",
     "DefaultAsyncHttpxClient",
+    "DefaultAioHttpClient",
 ]
 
 if not _t.TYPE_CHECKING:

{prelude_python_sdk-0.5.0 → prelude_python_sdk-0.7.0}/src/prelude_python_sdk/_base_client.py

@@ -59,7 +59,7 @@ from ._types import (
     ModelBuilderProtocol,
 )
 from ._utils import is_dict, is_list, asyncify, is_given, lru_cache, is_mapping
-from ._compat import PYDANTIC_V2, model_copy, model_dump
+from ._compat import PYDANTIC_V1, model_copy, model_dump
 from ._models import GenericModel, FinalRequestOptions, validate_type, construct_type
 from ._response import (
     APIResponse,
@@ -232,7 +232,7 @@ class BaseSyncPage(BasePage[_T], Generic[_T]):
         model: Type[_T],
         options: FinalRequestOptions,
     ) -> None:
-        if PYDANTIC_V2 and getattr(self, "__pydantic_private__", None) is None:
+        if (not PYDANTIC_V1) and getattr(self, "__pydantic_private__", None) is None:
             self.__pydantic_private__ = {}
 
         self._model = model
@@ -320,7 +320,7 @@ class BaseAsyncPage(BasePage[_T], Generic[_T]):
         client: AsyncAPIClient,
         options: FinalRequestOptions,
     ) -> None:
-        if PYDANTIC_V2 and getattr(self, "__pydantic_private__", None) is None:
+        if (not PYDANTIC_V1) and getattr(self, "__pydantic_private__", None) is None:
             self.__pydantic_private__ = {}
 
         self._model = model
@@ -529,6 +529,18 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
             # work around https://github.com/encode/httpx/discussions/2880
             kwargs["extensions"] = {"sni_hostname": prepared_url.host.replace("_", "-")}
 
+        is_body_allowed = options.method.lower() != "get"
+
+        if is_body_allowed:
+            if isinstance(json_data, bytes):
+                kwargs["content"] = json_data
+            else:
+                kwargs["json"] = json_data if is_given(json_data) else None
+            kwargs["files"] = files
+        else:
+            headers.pop("Content-Type", None)
+            kwargs.pop("data", None)
+
         # TODO: report this error to httpx
         return self._client.build_request(  # pyright: ignore[reportUnknownMemberType]
             headers=headers,
@@ -540,8 +552,6 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
             # so that passing a `TypedDict` doesn't cause an error.
             # https://github.com/microsoft/pyright/issues/3526#event-6715453066
             params=self.qs.stringify(cast(Mapping[str, Any], params)) if params else None,
-            json=json_data if is_given(json_data) else None,
-            files=files,
             **kwargs,
         )
 
@@ -960,6 +970,9 @@ class SyncAPIClient(BaseClient[httpx.Client, Stream[Any]]):
             if self.custom_auth is not None:
                 kwargs["auth"] = self.custom_auth
 
+            if options.follow_redirects is not None:
+                kwargs["follow_redirects"] = options.follow_redirects
+
             log.debug("Sending HTTP Request: %s %s", request.method, request.url)
 
             response = None
@@ -1068,7 +1081,14 @@ class SyncAPIClient(BaseClient[httpx.Client, Stream[Any]]):
     ) -> ResponseT:
         origin = get_origin(cast_to) or cast_to
 
-        if inspect.isclass(origin) and issubclass(origin, BaseAPIResponse):
+        if (
+            inspect.isclass(origin)
+            and issubclass(origin, BaseAPIResponse)
+            # we only want to actually return the custom BaseAPIResponse class if we're
+            # returning the raw response, or if we're not streaming SSE, as if we're streaming
+            # SSE then `cast_to` doesn't actively reflect the type we need to parse into
+            and (not stream or bool(response.request.headers.get(RAW_RESPONSE_HEADER)))
+        ):
             if not issubclass(origin, APIResponse):
                 raise TypeError(f"API Response types must subclass {APIResponse}; Received {origin}")
 
@@ -1279,6 +1299,24 @@ class _DefaultAsyncHttpxClient(httpx.AsyncClient):
         super().__init__(**kwargs)
 
 
+try:
+    import httpx_aiohttp
+except ImportError:
+
+    class _DefaultAioHttpClient(httpx.AsyncClient):
+        def __init__(self, **_kwargs: Any) -> None:
+            raise RuntimeError("To use the aiohttp client you must have installed the package with the `aiohttp` extra")
+else:
+
+    class _DefaultAioHttpClient(httpx_aiohttp.HttpxAiohttpClient):  # type: ignore
+        def __init__(self, **kwargs: Any) -> None:
+            kwargs.setdefault("timeout", DEFAULT_TIMEOUT)
+            kwargs.setdefault("limits", DEFAULT_CONNECTION_LIMITS)
+            kwargs.setdefault("follow_redirects", True)
+
+            super().__init__(**kwargs)
+
+
 if TYPE_CHECKING:
     DefaultAsyncHttpxClient = httpx.AsyncClient
     """An alias to `httpx.AsyncClient` that provides the same defaults that this SDK
@@ -1287,8 +1325,12 @@ if TYPE_CHECKING:
     This is useful because overriding the `http_client` with your own instance of
     `httpx.AsyncClient` will result in httpx's defaults being used, not ours.
     """
+
+    DefaultAioHttpClient = httpx.AsyncClient
+    """An alias to `httpx.AsyncClient` that changes the default HTTP transport to `aiohttp`."""
 else:
     DefaultAsyncHttpxClient = _DefaultAsyncHttpxClient
+    DefaultAioHttpClient = _DefaultAioHttpClient
 
 
 class AsyncHttpxClientWrapper(DefaultAsyncHttpxClient):
@@ -1460,6 +1502,9 @@ class AsyncAPIClient(BaseClient[httpx.AsyncClient, AsyncStream[Any]]):
             if self.custom_auth is not None:
                 kwargs["auth"] = self.custom_auth
 
+            if options.follow_redirects is not None:
+                kwargs["follow_redirects"] = options.follow_redirects
+
             log.debug("Sending HTTP Request: %s %s", request.method, request.url)
 
             response = None
@@ -1568,7 +1613,14 @@ class AsyncAPIClient(BaseClient[httpx.AsyncClient, AsyncStream[Any]]):
     ) -> ResponseT:
         origin = get_origin(cast_to) or cast_to
 
-        if inspect.isclass(origin) and issubclass(origin, BaseAPIResponse):
+        if (
+            inspect.isclass(origin)
+            and issubclass(origin, BaseAPIResponse)
+            # we only want to actually return the custom BaseAPIResponse class if we're
+            # returning the raw response, or if we're not streaming SSE, as if we're streaming
+            # SSE then `cast_to` doesn't actively reflect the type we need to parse into
+            and (not stream or bool(response.request.headers.get(RAW_RESPONSE_HEADER)))
+        ):
             if not issubclass(origin, AsyncAPIResponse):
                 raise TypeError(f"API Response types must subclass {AsyncAPIResponse}; Received {origin}")