> This page is for version v0.25.0.
> For other versions, use one of these documentation indexes:
> - Latest (default): https://docs.nvidia.com/nemo/guardrails/latest/llms.txt
> - v0.25.0: https://docs.nvidia.com/nemo/guardrails/v0.25.0/llms.txt
> - v0.24.1: https://docs.nvidia.com/nemo/guardrails/v0.24.1/llms.txt
> - v0.24.0: https://docs.nvidia.com/nemo/guardrails/v0.24.0/llms.txt
> - v0.23.0: https://docs.nvidia.com/nemo/guardrails/v0.23.0/llms.txt
> - v0.22.0: https://docs.nvidia.com/nemo/guardrails/v0.22.0/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/guardrails/llms.txt.

# nemoguardrails.server.experimental.providers.openai.chat_completions.request_projection

Field policies for guarded OpenAI Chat Completions requests.

## Module Contents

### Classes

| Name                                                                                                                                                                          | Description                                                                 |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| [`ChatCompletionsGuardedRequestProjection`](#nemoguardrails-server-experimental-providers-openai-chat_completions-request_projection-ChatCompletionsGuardedRequestProjection) | Declare the single-message request shape and explicit feature restrictions. |
| [`ChatCompletionsUserMessageProjection`](#nemoguardrails-server-experimental-providers-openai-chat_completions-request_projection-ChatCompletionsUserMessageProjection)       | Accept one user text message with reviewed optional provider metadata.      |

### Functions

| Name                                                                                                                    | Description                                                              |
| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [`_require_int`](#nemoguardrails-server-experimental-providers-openai-chat_completions-request_projection-_require_int) | Reject booleans, strings, and floats before Literal\[1] can coerce them. |

### API

```python
class nemoguardrails.server.experimental.providers.openai.chat_completions.request_projection.ChatCompletionsGuardedRequestProjection()
```

**Bases:** [PolicyModel](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/provider/projection_policy#nemoguardrails-server-experimental-provider-projection_policy-PolicyModel), [GuardedRequestModel](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/provider/payload#nemoguardrails-server-experimental-provider-payload-GuardedRequestModel)

Declare the single-message request shape and explicit feature restrictions.

The request binding attaches extraction, coverage, and response-mode metadata.
Recognizing the stream flag does not imply that an endpoint supports streaming.
The request is closed to OpenAI's fields: compatible servers render some
other fields, such as chat_template_kwargs or documents, into the prompt.

**`audio`** `Annotated[None, disabled(core_capability.audio_content)] = None`

---

**`function_call`** `Annotated[None, disabled(core_capability.tool_content)] = None`

---

**`functions`** `Annotated[None, disabled(core_capability.tool_content)] = None`

---

**`logprobs`** `Annotated[StrictFalse | None, constrained(reason=(provider_integrity.token_logprobs))] = None`

---

**`messages`** `Annotated[list[ChatCompletionsUserMessageProjection], guarded(min_length=1, max_length=1)]`

---

**`modalities`** `Annotated[None, disabled(core_capability.multimodal_content)] = None`

---

**`n`** `Annotated[Literal[1], BeforeValidator(_require_int), constrained(reason=(core_capability.single_text_target))] = 1`

---

**`parallel_tool_calls`** `Annotated[None, disabled(core_capability.tool_content)] = None`

---

**`policy`** `ObjectPolicy`

---

**`prediction`** `Annotated[None, disabled(core_capability.predicted_content)] = None`

---

**`reasoning_effort`** `Annotated[Literal['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'] | None, constrained()] = None`

---

**`response_format`** `Annotated[None, disabled(projection_policy.plain_text_output)] = None`

---

**`stream`** `Annotated[StrictBool | None, constrained()] = False`

---

**`tool_choice`** `Annotated[None, disabled(core_capability.tool_content)] = None`

---

**`tools`** `Annotated[None, disabled(core_capability.tool_content)] = None`

---

**`top_logprobs`** `Annotated[None, disabled(provider_integrity.token_logprobs)] = None`

---

**`web_search_options`** `Annotated[None, disabled(core_capability.tool_content)] = None`

---

```python
class nemoguardrails.server.experimental.providers.openai.chat_completions.request_projection.ChatCompletionsUserMessageProjection()
```

**Bases:** [PolicyModel](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/provider/projection_policy#nemoguardrails-server-experimental-provider-projection_policy-PolicyModel), [GuardedContentModel](/nemo/guardrails/v0.25.0/guardrails-python-sdk/nemoguardrails/server/experimental/provider/payload#nemoguardrails-server-experimental-provider-payload-GuardedContentModel)

Accept one user text message with reviewed optional provider metadata.

**`content`** `Annotated[str, guarded(user, replaceable=True, min_length=1)]`

---

**`name`** `Annotated[None, disabled(core_capability.participant_name)] = None`

---

**`policy`** `ObjectPolicy`

---

**`role`** `Annotated[Literal['user'], constrained()]`

---

```python
nemoguardrails.server.experimental.providers.openai.chat_completions.request_projection._require_int(
    value: object
) -> object
```

Reject booleans, strings, and floats before Literal\[1] can coerce them.