Merge pull request openai#3213 from openai/release-please--branches--main--changes--next

release: 2.37.0

Author: xuanqi-oai

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "2.36.0"
+  ".": "2.37.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 233
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai/openai-371f497afe4d6070f6e252e5febbe8f453c7058a8dff0c26a01b4d88442a4ac2.yml
-openapi_spec_hash: d39f46e8fda45f77096448105efd175a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai/openai-50d816559ef0935e64d07789ff936a2b762e26ab0714a2fa6bc06d06d4484294.yml
+openapi_spec_hash: c5d8f37edbf66c1fef627d787b4c54fd
 config_hash: b64135fff1fe9cf4069b9ecf59ae8b07

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 2.37.0 (2026-05-13)
+
+Full Changelog: [v2.36.0...v2.37.0](https://github.com/openai/openai-python/compare/v2.36.0...v2.37.0)
+
+### Features
+
+* **api:** add service_tier parameter to responses compact method ([625827c](https://github.com/openai/openai-python/commit/625827c5509ece3c40e5002be37a9bd9d91b5374))
+* **internal/types:** support eagerly validating pydantic iterators ([7e527bc](https://github.com/openai/openai-python/commit/7e527bc927cc58b74d7619abf7f1fbcfff8bddfa))
+* Remove unnecessary client_id when using workload identity provider for auth ([c39ea8d](https://github.com/openai/openai-python/commit/c39ea8d12a010052d7f02cebe8daabd2d1f89597))
+
+
+### Bug Fixes
+
+* **client:** add missing f-string prefix in file type error message ([c85ebd9](https://github.com/openai/openai-python/commit/c85ebd935cb4b80e7e97ce255437684f6411fb00))
+
 ## 2.36.0 (2026-05-07)
 
 Full Changelog: [v2.35.1...v2.36.0](https://github.com/openai/openai-python/compare/v2.35.1...v2.36.0)

README.md

@@ -83,15 +83,12 @@ from openai.auth import k8s_service_account_token_provider
 
 client = OpenAI(
     workload_identity={
-        "client_id": "your-client-id",
         "identity_provider_id": "idp-123",
         "service_account_id": "sa-456",
         "provider": k8s_service_account_token_provider(
             "/var/run/secrets/kubernetes.io/serviceaccount/token"
         ),
     },
-    organization="org-xyz",
-    project="proj-abc",
 )
 
 response = client.chat.completions.create(
@@ -108,7 +105,6 @@ from openai.auth import azure_managed_identity_token_provider
 
 client = OpenAI(
     workload_identity={
-        "client_id": "your-client-id",
         "identity_provider_id": "idp-123",
         "service_account_id": "sa-456",
         "provider": azure_managed_identity_token_provider(
@@ -126,7 +122,6 @@ from openai.auth import gcp_id_token_provider
 
 client = OpenAI(
     workload_identity={
-        "client_id": "your-client-id",
         "identity_provider_id": "idp-123",
         "service_account_id": "sa-456",
         "provider": gcp_id_token_provider(audience="https://api.openai.com/v1"),
@@ -146,7 +141,6 @@ def get_custom_token() -> str:
 
 client = OpenAI(
     workload_identity={
-        "client_id": "your-client-id",
         "identity_provider_id": "idp-123",
         "service_account_id": "sa-456",
         "provider": {
@@ -165,7 +159,6 @@ from openai.auth import k8s_service_account_token_provider
 
 client = OpenAI(
     workload_identity={
-        "client_id": "your-client-id",
         "identity_provider_id": "idp-123",
         "service_account_id": "sa-456",
         "provider": k8s_service_account_token_provider("/var/token"),

pyproject.toml

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

src/openai/_files.py

@@ -99,7 +99,7 @@ async def async_to_httpx_files(files: RequestFiles | None) -> HttpxRequestFiles
     elif is_sequence_t(files):
         files = [(key, await _async_transform_file(file)) for key, file in files]
     else:
-        raise TypeError("Unexpected file type input {type(files)}, expected mapping or sequence")
+        raise TypeError(f"Unexpected file type input {type(files)}, expected mapping or sequence")
 
     return files
 

src/openai/_models.py

@@ -27,7 +27,9 @@
     Protocol,
     Required,
     Sequence,
+    Annotated,
     ParamSpec,
+    TypeAlias,
     TypedDict,
     TypeGuard,
     final,
@@ -81,7 +83,15 @@
 from ._constants import RAW_RESPONSE_HEADER
 
 if TYPE_CHECKING:
+    from pydantic import GetCoreSchemaHandler, ValidatorFunctionWrapHandler
+    from pydantic_core import CoreSchema, core_schema
     from pydantic_core.core_schema import ModelField, ModelSchema, LiteralSchema, ModelFieldsSchema
+else:
+    try:
+        from pydantic_core import CoreSchema, core_schema
+    except ImportError:
+        CoreSchema = None
+        core_schema = None
 
 __all__ = ["BaseModel", "GenericModel"]
 
@@ -422,6 +432,76 @@ def model_dump_json(
             )
 
 
+class _EagerIterable(list[_T], Generic[_T]):
+    """
+    Accepts any Iterable[T] input (including generators), consumes it
+    eagerly, and validates all items upfront.
+
+    Validation preserves the original container type where possible
+    (e.g. a set[T] stays a set[T]).  Serialization (model_dump / JSON)
+    always emits a list — round-tripping through model_dump() will not
+    restore the original container type.
+    """
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        source_type: Any,
+        handler: GetCoreSchemaHandler,
+    ) -> CoreSchema:
+        (item_type,) = get_args(source_type) or (Any,)
+        item_schema: CoreSchema = handler.generate_schema(item_type)
+        list_of_items_schema: CoreSchema = core_schema.list_schema(item_schema)
+
+        return core_schema.no_info_wrap_validator_function(
+            cls._validate,
+            list_of_items_schema,
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                cls._serialize,
+                info_arg=False,
+            ),
+        )
+
+    @staticmethod
+    def _validate(v: Iterable[_T], handler: "ValidatorFunctionWrapHandler") -> Any:
+        original_type: type[Any] = type(v)
+
+        # Normalize to list so list_schema can validate each item
+        if isinstance(v, list):
+            items: list[_T] = v
+        else:
+            try:
+                items = list(v)
+            except TypeError as e:
+                raise TypeError("Value is not iterable") from e
+
+        # Validate items against the inner schema
+        validated: list[_T] = handler(items)
+
+        # Reconstruct original container type
+        if original_type is list:
+            return validated
+        # str(list) produces the list's repr, not a string built from items,
+        # so skip reconstruction for str and its subclasses.
+        if issubclass(original_type, str):
+            return validated
+        try:
+            return original_type(validated)
+        except (TypeError, ValueError):
+            # If the type cannot be reconstructed, just return the validated list
+            return validated
+
+    @staticmethod
+    def _serialize(v: Iterable[_T]) -> list[_T]:
+        """Always serialize as a list so Pydantic's JSON encoder is happy."""
+        if isinstance(v, list):
+            return v
+        return list(v)
+
+
+EagerIterable: TypeAlias = Annotated[Iterable[_T], _EagerIterable]
+
+
 def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     if value is None:
         return field_get_default(field)

src/openai/_version.py

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

src/openai/auth/_workload.py

@@ -27,10 +27,6 @@ class SubjectTokenProvider(TypedDict):
 
 
 class WorkloadIdentity(TypedDict):
-    """A unique string that identifies the client."""
-
-    client_id: str
-
     """Identity provider resource id in WIFAPI."""
     identity_provider_id: str
 
@@ -253,7 +249,6 @@ def _fetch_token_from_exchange(self) -> dict[str, Any]:
                 self.token_exchange_url,
                 json={
                     "grant_type": TOKEN_EXCHANGE_GRANT_TYPE,
-                    "client_id": self.workload_identity["client_id"],
                     "subject_token": subject_token,
                     "subject_token_type": subject_token_type,
                     "identity_provider_id": self.workload_identity["identity_provider_id"],

src/openai/resources/responses/responses.py

@@ -1704,6 +1704,7 @@ def compact(
         previous_response_id: Optional[str] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         prompt_cache_retention: Optional[Literal["in_memory", "24h"]] | Omit = omit,
+        service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | 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.
         extra_headers: Headers | None = None,
@@ -1743,6 +1744,8 @@ def compact(
 
           prompt_cache_retention: How long to retain a prompt cache entry created by this request.
 
+          service_tier: The service tier to use for this request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1761,6 +1764,7 @@ def compact(
                     "previous_response_id": previous_response_id,
                     "prompt_cache_key": prompt_cache_key,
                     "prompt_cache_retention": prompt_cache_retention,
+                    "service_tier": service_tier,
                 },
                 response_compact_params.ResponseCompactParams,
             ),
@@ -3410,6 +3414,7 @@ async def compact(
         previous_response_id: Optional[str] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         prompt_cache_retention: Optional[Literal["in_memory", "24h"]] | Omit = omit,
+        service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | 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.
         extra_headers: Headers | None = None,
@@ -3449,6 +3454,8 @@ async def compact(
 
           prompt_cache_retention: How long to retain a prompt cache entry created by this request.
 
+          service_tier: The service tier to use for this request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -3467,6 +3474,7 @@ async def compact(
                     "previous_response_id": previous_response_id,
                     "prompt_cache_key": prompt_cache_key,
                     "prompt_cache_retention": prompt_cache_retention,
+                    "service_tier": service_tier,
                 },
                 response_compact_params.ResponseCompactParams,
             ),