openai/openai-python · error · OpenAIError

Configure `provider` on `AsyncOpenAI`, not on `AsyncBedrockO

Error message

Configure `provider` on `AsyncOpenAI`, not on `AsyncBedrockOpenAI.with_options()`.

What it means

`AsyncBedrockOpenAI.with_options()` does not accept `provider`; it is an `AsyncOpenAI`-client option. Bedrock auth mode is inferred from which credentials you configure.

Source

Thrown at src/openai/lib/bedrock.py:809

        base_url: str | httpx2.URL | None | NotGiven = NOT_GIVEN,
        data_residency: DataResidency | None = None,
        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
        http_client: httpx2.AsyncClient | None = None,
        max_retries: int | NotGiven = NOT_GIVEN,
        default_headers: Mapping[str, str] | None = None,
        set_default_headers: Mapping[str, str] | None = None,
        default_query: Mapping[str, object] | None = None,
        set_default_query: Mapping[str, object] | None = None,
        _enforce_credentials: bool | None = None,
        _extra_kwargs: Mapping[str, Any] = {},
    ) -> Self:
        if data_residency is not None:
            raise OpenAIError("`data_residency` is only supported by OpenAI clients")
        base_url = None if isinstance(base_url, NotGiven) else base_url
        if callable(api_key):
            raise OpenAIError("Pass refreshable Bedrock credentials via `bedrock_token_provider`, not `api_key`.")
        if not isinstance(provider, NotGiven):
            raise OpenAIError("Configure `provider` on `AsyncOpenAI`, not on `AsyncBedrockOpenAI.with_options()`.")
        if admin_api_key is not None or workload_identity is not None:
            raise OpenAIError("AsyncBedrockOpenAI only supports Bedrock bearer token or AWS credential authentication.")
        if default_headers is not None and set_default_headers is not None:
            raise ValueError("The `default_headers` and `set_default_headers` arguments are mutually exclusive")
        if default_query is not None and set_default_query is not None:
            raise ValueError("The `default_query` and `set_default_query` arguments are mutually exclusive")

        headers = self._custom_headers
        if default_headers is not None:
            headers = {**headers, **default_headers}
        elif set_default_headers is not None:
            headers = set_default_headers
        params = self._custom_query
        if default_query is not None:
            params = {**params, **default_query}
        elif set_default_query is not None:
            params = set_default_query

View on GitHub (pinned to 9917c6e28e)

Solutions

Drop `provider` from Bedrock `with_options` calls
Set `provider` only when constructing `AsyncOpenAI`

Example fix

# before
c = async_bedrock_client.with_options(provider='bedrock')
# after
c = async_bedrock_client.with_options(bedrock_token_provider=get_token)

Defensive patterns

Strategy: validation

Validate before calling

kwargs.pop('provider', None)

Prevention

Set provider only on AsyncOpenAI

When it happens

Trigger: `async_bedrock_client.with_options(provider='bedrock')` — any non-NotGiven `provider` value.

Common situations: Wrapper code forwarding `provider` to all clients; config dicts built for `AsyncOpenAI` reused for Bedrock.

Related errors

AI-assisted analysis of openai/openai-python@9917c6e28e (2026-08-28). Data as JSON: /api/errors/05e180d9240ac300. Report an issue: GitHub.