openai/openai-python · error · ValueError

The `default_query` and `set_default_query` arguments are mu

Error message

The `default_query` and `set_default_query` arguments are mutually exclusive

What it means

Same exclusivity rule as headers but for query parameters: `default_query` merges into the client's existing default query params while `set_default_query` replaces them. Supplying both in the sync Bedrock `copy()` is rejected as ambiguous.

Source

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

        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 `OpenAI`, not on `BedrockOpenAI.with_options()`.")
        if admin_api_key is not None or workload_identity is not None:
            raise OpenAIError("BedrockOpenAI 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

        provider_kwargs, inherited_provider, inherited_state = _copy_configuration(
            self,
            api_key=api_key,
            token_provider=bedrock_token_provider,
            aws_region=aws_region,
            aws_profile=aws_profile,

View on GitHub (pinned to 9917c6e28e)

Solutions

1. Merge the query dicts manually and pass one argument
2. Choose `default_query` (merge) or `set_default_query` (replace) deliberately

Example fix

# before
c = bedrock_client.with_options(default_query={'a':'1'}, set_default_query={'b':'2'})
# after
c = bedrock_client.with_options(set_default_query={'a':'1','b':'2'})

assert not (default_query is not None and set_default_query is not None)

When it happens

Trigger: `bedrock_client.with_options(default_query={'api-version':'v1'}, set_default_query={'beta':'true'})` — both non-None.

Common situations: Chained `with_options` builders each adding query params via different arguments; config layering that mixes merge and replace semantics.

Related errors

• The `default_headers` and `set_default_headers` arguments ar
• `data_residency` is only supported by OpenAI clients
• Configure `provider` on `OpenAI`, not on `BedrockOpenAI.with
• BedrockOpenAI only supports Bedrock bearer token or AWS cred
• Configure `provider` on `AsyncOpenAI`, not on `AsyncBedrockO

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