> This page is for version Latest (default).
> 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.

# OpenAI Chat Completions Guard Contract

> Request, response, and stream policies exported from the bound native OpenAI operation.

[API reference](/nemo/guardrails/reference/gateway-api/chat-completions) · [Field-policy meanings](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)

Operation: `createChatCompletion`. Payload profile: `single_text.v1`. Contract format: `1.0.0-alpha.1`.

[Request](#request) · [Response](#response) · [Stream](#stream) · [Exact contract](#exact-contract)

These declarations describe the native binding's guard boundary, not a complete provider schema. Rails configuration selects the checks that run. See [supported content](/nemo/guardrails/run-guardrailed-inference/using-gateway/providers-and-streaming#coverage-of-the-shipped-profiles).

Response and stream inspection declarations apply when output inspection is enabled. Guarded request validation still applies when checks are disabled. See [disabled checks and pass-through](/nemo/guardrails/run-guardrailed-inference/using-gateway/providers-and-streaming#disabled-checks-and-pass-through).

Required presence is local to each containing object and schema branch. Nested accordions preserve those scopes; branch labels identify schema alternatives, not payload members. Hover a field name for its exact schema pointer. Defaults are not inserted into forwarded traffic.

## Request

| Field                                                                                                   | Type              | Presence | Policy                                                                                        | Rules                                                                                           |
| ------------------------------------------------------------------------------------------------------- | ----------------- | -------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| `audio`                                                                                                 | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| <code title="#/request/properties/frequency_penalty">frequency\_<wbr />penalty</code>                   | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| <code title="#/request/properties/function_call">function\_<wbr />call</code>                           | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| `functions`                                                                                             | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| <code title="#/request/properties/logit_bias">logit\_<wbr />bias</code>                                 | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `logprobs`                                                                                              | `boolean or null` | Optional | [Constrained](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | If non-null, must be `false`.                                                                   |
| <code title="#/request/properties/max_completion_tokens">max\_<wbr />completion\_<wbr />tokens</code>   | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| <code title="#/request/properties/max_tokens">max\_<wbr />tokens</code>                                 | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `messages`                                                                                              | `array`           | Required | [Guarded](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)     | Exactly 1 item. See nested fields.                                                              |
| `metadata`                                                                                              | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `modalities`                                                                                            | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| `model`                                                                                                 | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `moderation`                                                                                            | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `n`                                                                                                     | `integer`         | Optional | [Constrained](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | Must be `1`.                                                                                    |
| <code title="#/request/properties/parallel_tool_calls">parallel\_<wbr />tool\_<wbr />calls</code>       | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| `prediction`                                                                                            | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| <code title="#/request/properties/presence_penalty">presence\_<wbr />penalty</code>                     | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| <code title="#/request/properties/prompt_cache_key">prompt\_<wbr />cache\_<wbr />key</code>             | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| <code title="#/request/properties/prompt_cache_options">prompt\_<wbr />cache\_<wbr />options</code>     | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| <code title="#/request/properties/prompt_cache_retention">prompt\_<wbr />cache\_<wbr />retention</code> | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| <code title="#/request/properties/reasoning_effort">reasoning\_<wbr />effort</code>                     | `string or null`  | Optional | [Constrained](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | If non-null, allowed: `"none"`, `"minimal"`, `"low"`, `"medium"`, `"high"`, `"xhigh"`, `"max"`. |
| <code title="#/request/properties/response_format">response\_<wbr />format</code>                       | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| <code title="#/request/properties/safety_identifier">safety\_<wbr />identifier</code>                   | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `seed`                                                                                                  | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| <code title="#/request/properties/service_tier">service\_<wbr />tier</code>                             | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `stop`                                                                                                  | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `store`                                                                                                 | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `stream`                                                                                                | `boolean or null` | Optional | [Constrained](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | If non-null, see exact contract.                                                                |
| <code title="#/request/properties/stream_options">stream\_<wbr />options</code>                         | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `temperature`                                                                                           | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| <code title="#/request/properties/tool_choice">tool\_<wbr />choice</code>                               | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| `tools`                                                                                                 | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| <code title="#/request/properties/top_logprobs">top\_<wbr />logprobs</code>                             | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |
| <code title="#/request/properties/top_p">top\_<wbr />p</code>                                           | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `user`                                                                                                  | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| `verbosity`                                                                                             | `any`             | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)      | Provider requirements apply.                                                                    |
| <code title="#/request/properties/web_search_options">web\_<wbr />search\_<wbr />options</code>         | `null`            | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                                                                   |

#### Object policy

```yaml
model: ChatCompletionsGuardedRequest
reject_case_aliases: true
stream_selector_field: stream
unknown_fields: forbid
```

#### \$.messages\[]

| Field     | Type     | Presence | Policy                                                                                        | Rules                 |
| --------- | -------- | -------- | --------------------------------------------------------------------------------------------- | --------------------- |
| `content` | `string` | Required | [Guarded](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)     | At least 1 character. |
| `name`    | `null`   | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.         |
| `role`    | `string` | Required | [Constrained](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | Must be `"user"`.     |

#### Object policy

```yaml
reject_case_aliases: true
source: '#/components/schemas/ChatCompletionRequestUserMessage'
unknown_fields: configurable
```

## Response

| Field                                                                                    | Type    | Presence | Policy                                                                                    | Rules                              |
| ---------------------------------------------------------------------------------------- | ------- | -------- | ----------------------------------------------------------------------------------------- | ---------------------------------- |
| `choices`                                                                                | `array` | Required | [Guarded](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | Exactly 1 item. See nested fields. |
| `created`                                                                                | `any`   | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | Provider requirements apply.       |
| `id`                                                                                     | `any`   | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | Provider requirements apply.       |
| `metadata`                                                                               | `any`   | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | Provider requirements apply.       |
| `model`                                                                                  | `any`   | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | Provider requirements apply.       |
| `moderation`                                                                             | `any`   | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | Provider requirements apply.       |
| `object`                                                                                 | `any`   | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | Provider requirements apply.       |
| <code title="#/response/properties/service_tier">service\_<wbr />tier</code>             | `any`   | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | Provider requirements apply.       |
| <code title="#/response/properties/system_fingerprint">system\_<wbr />fingerprint</code> | `any`   | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | Provider requirements apply.       |
| `usage`                                                                                  | `any`   | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | Provider requirements apply.       |

#### Object policy

```yaml
model: ChatCompletionsGuardedResponse
reject_case_aliases: true
unknown_fields: forbid
```

#### \$.choices\[]

| Field                                                                                                   | Type     | Presence | Policy                                                                                     | Rules                        |
| ------------------------------------------------------------------------------------------------------- | -------- | -------- | ------------------------------------------------------------------------------------------ | ---------------------------- |
| <code title="#/response/properties/choices/items/properties/finish_reason">finish\_<wbr />reason</code> | `any`    | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)   | Provider requirements apply. |
| `index`                                                                                                 | `any`    | Optional | [Opaque](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)   | Provider requirements apply. |
| `logprobs`                                                                                              | `null`   | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | Omit or null.                |
| `message`                                                                                               | `object` | Required | [Guarded](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)  | See nested fields.           |

#### Object policy

```yaml
reject_case_aliases: true
unknown_fields: configurable
```

#### \$.choices\[].message

| Field                                                                                                                              | Type             | Presence | Policy                                                                                        | Rules                                            |
| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------- | -------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| `annotations`                                                                                                                      | `array or null`  | Optional | [Constrained](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | If non-null, at most 0 items. See nested fields. |
| `audio`                                                                                                                            | `null`           | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                    |
| `content`                                                                                                                          | `string or null` | Required | [Guarded](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)     | If non-null, see exact contract.                 |
| <code title="#/response/properties/choices/items/properties/message/properties/function_call">function\_<wbr />call</code>         | `null`           | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                    |
| <code title="#/response/properties/choices/items/properties/message/properties/reasoning_content">reasoning\_<wbr />content</code> | `null`           | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                    |
| `refusal`                                                                                                                          | `null`           | Optional | [Disabled](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy)    | Omit or null.                                    |
| `role`                                                                                                                             | `string`         | Required | [Constrained](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | Must be `"assistant"`.                           |
| <code title="#/response/properties/choices/items/properties/message/properties/tool_calls">tool\_<wbr />calls</code>               | `array or null`  | Optional | [Constrained](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-the-field-policy) | If non-null, at most 0 items. See nested fields. |

#### Object policy

```yaml
classification: guarded
reject_case_aliases: true
source: '#/components/schemas/ChatCompletionResponseMessage'
unknown_fields: configurable
```

## Stream

Event roles and missing-text rules come from the bound classifier. See [stream declaration meanings](/nemo/guardrails/run-guardrailed-inference/using-gateway/guard-contracts#read-stream-declarations) and [runtime completion and errors](/nemo/guardrails/run-guardrailed-inference/using-gateway/providers-and-streaming#completion-and-errors).

| Shape                           | Role             | Text subjects               | Missing text                                                                         | Selection                                                                                               |
| ------------------------------- | ---------------- | --------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
| `chat.completion.chunk:content` | `guarded_delta`  | `$.choices[].delta.content` | `{"missing_text": "opaque", "missing_text_shape": "chat.completion.chunk:metadata"}` | `{"match": {"object": "chat.completion.chunk"}, "source_schema": "CreateChatCompletionStreamResponse"}` |
| `error`                         | `provider_error` | —                           | —                                                                                    | `{"required_fields": ["error"], "source_schema": "ErrorResponse"}`                                      |

### Transport declarations

```yaml
transport:
  non_data_shape: keepalive
  require_sse_event: false
  sentinels:
    '[DONE]': '[DONE]'
```

## Exact contract

This is the unmodified export from the bound Python endpoint. Stateful stream hooks, enabled Rails checks, and arbitrary Python validation are not serialized.

#### Exact exported contract

```yaml
integration:
  endpoint:
    operation_label: OpenAI Chat Completions
    route_path: /v1/chat/completions
    unsupported_request_code: unsupported_chat_completions_shape
    unsupported_response_code: unsupported_chat_completions_response_shape
  name: chat_completions
operationId: createChatCompletion
profile: single_text.v1
request:
  additionalProperties: false
  description: Bind the handwritten projection to its guarded runtime semantics.
  properties:
    audio:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: core_capability.audio_content
    frequency_penalty:
      x-nemo-guardrails:
        classification: opaque
    function_call:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: core_capability.tool_content
    functions:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: core_capability.tool_content
    logit_bias:
      x-nemo-guardrails:
        classification: opaque
    logprobs:
      default: null
      oneOf:
      - const: false
        type: boolean
      - type: 'null'
      x-nemo-guardrails:
        classification: constrained
        reason: provider_integrity.token_logprobs
    max_completion_tokens:
      x-nemo-guardrails:
        classification: opaque
    max_tokens:
      x-nemo-guardrails:
        classification: opaque
    messages:
      items:
        additionalProperties: false
        description: Accept one user text message with reviewed optional provider metadata.
        properties:
          content:
            minLength: 1
            type: string
            x-nemo-guardrails:
              classification: guarded
              subject:
                kind: text
                replaceable: true
                role: user
          name:
            default: null
            type: 'null'
            x-nemo-guardrails:
              classification: constrained
              gate: disabled
              reason: core_capability.participant_name
          role:
            const: user
            type: string
            x-nemo-guardrails:
              classification: constrained
        required:
        - content
        - role
        title: ChatCompletionsUserMessageProjection
        type: object
        x-nemo-guardrails:
          reject_case_aliases: true
          source: '#/components/schemas/ChatCompletionRequestUserMessage'
          unknown_fields: configurable
      maxItems: 1
      minItems: 1
      type: array
      x-nemo-guardrails:
        classification: guarded
    metadata:
      x-nemo-guardrails:
        classification: opaque
    modalities:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: core_capability.multimodal_content
    model:
      x-nemo-guardrails:
        classification: opaque
    moderation:
      x-nemo-guardrails:
        classification: opaque
    n:
      const: 1
      default: 1
      type: integer
      x-nemo-guardrails:
        classification: constrained
        reason: core_capability.single_text_target
    parallel_tool_calls:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: core_capability.tool_content
    prediction:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: core_capability.predicted_content
    presence_penalty:
      x-nemo-guardrails:
        classification: opaque
    prompt_cache_key:
      x-nemo-guardrails:
        classification: opaque
    prompt_cache_options:
      x-nemo-guardrails:
        classification: opaque
    prompt_cache_retention:
      x-nemo-guardrails:
        classification: opaque
    reasoning_effort:
      default: null
      oneOf:
      - enum:
        - none
        - minimal
        - low
        - medium
        - high
        - xhigh
        - max
        type: string
      - type: 'null'
      x-nemo-guardrails:
        classification: constrained
    response_format:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: projection_policy.plain_text_output
    safety_identifier:
      x-nemo-guardrails:
        classification: opaque
    seed:
      x-nemo-guardrails:
        classification: opaque
    service_tier:
      x-nemo-guardrails:
        classification: opaque
    stop:
      x-nemo-guardrails:
        classification: opaque
    store:
      x-nemo-guardrails:
        classification: opaque
    stream:
      default: false
      oneOf:
      - type: boolean
      - type: 'null'
      x-nemo-guardrails:
        classification: constrained
    stream_options:
      x-nemo-guardrails:
        classification: opaque
    temperature:
      x-nemo-guardrails:
        classification: opaque
    tool_choice:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: core_capability.tool_content
    tools:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: core_capability.tool_content
    top_logprobs:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: provider_integrity.token_logprobs
    top_p:
      x-nemo-guardrails:
        classification: opaque
    user:
      x-nemo-guardrails:
        classification: opaque
    verbosity:
      x-nemo-guardrails:
        classification: opaque
    web_search_options:
      default: null
      type: 'null'
      x-nemo-guardrails:
        classification: constrained
        gate: disabled
        reason: core_capability.tool_content
  required:
  - messages
  title: openai.chat_completions.request.text.v1
  type: object
  x-nemo-guardrails:
    model: ChatCompletionsGuardedRequest
    reject_case_aliases: true
    stream_selector_field: stream
    unknown_fields: forbid
response:
  additionalProperties: false
  description: Bind the handwritten projection to its guarded runtime semantics.
  properties:
    choices:
      items:
        additionalProperties: false
        description: Expose the guarded message while preserving opaque choice metadata.
        properties:
          finish_reason:
            default: null
            x-nemo-guardrails:
              classification: opaque
          index:
            default: null
            x-nemo-guardrails:
              classification: opaque
          logprobs:
            default: null
            type: 'null'
            x-nemo-guardrails:
              classification: constrained
              gate: disabled
              reason: provider_integrity.token_logprobs
          message:
            additionalProperties: false
            description: Accept assistant text while preventing replacement of annotated content.
            properties:
              annotations:
                default: null
                oneOf:
                - items: {}
                  maxItems: 0
                  type: array
                - type: 'null'
                x-nemo-guardrails:
                  classification: constrained
                  reason: core_capability.citation_content
              audio:
                default: null
                type: 'null'
                x-nemo-guardrails:
                  classification: constrained
                  gate: disabled
                  reason: core_capability.audio_content
              content:
                oneOf:
                - type: string
                - type: 'null'
                x-nemo-guardrails:
                  classification: guarded
                  subject:
                    kind: text
                    replaceable: true
                    replacement_blocked_by: annotations
                    replacement_reason: provider_integrity.annotated_text
                    role: assistant
              function_call:
                default: null
                type: 'null'
                x-nemo-guardrails:
                  classification: constrained
                  gate: disabled
                  reason: core_capability.tool_content
              reasoning_content:
                default: null
                type: 'null'
                x-nemo-guardrails:
                  classification: constrained
                  extension: true
                  gate: disabled
                  reason: core_capability.reasoning_content
              refusal:
                default: null
                type: 'null'
                x-nemo-guardrails:
                  classification: constrained
                  gate: disabled
                  reason: core_capability.refusal_content
              role:
                const: assistant
                type: string
                x-nemo-guardrails:
                  classification: constrained
              tool_calls:
                default: null
                oneOf:
                - items: {}
                  maxItems: 0
                  type: array
                - type: 'null'
                x-nemo-guardrails:
                  classification: constrained
                  reason: core_capability.tool_content
            required:
            - content
            - role
            title: ChatCompletionsAssistantMessageProjection
            type: object
            x-nemo-guardrails:
              classification: guarded
              reject_case_aliases: true
              source: '#/components/schemas/ChatCompletionResponseMessage'
              unknown_fields: configurable
        required:
        - message
        title: ChatCompletionsChoiceProjection
        type: object
        x-nemo-guardrails:
          reject_case_aliases: true
          unknown_fields: configurable
      maxItems: 1
      minItems: 1
      type: array
      x-nemo-guardrails:
        classification: guarded
    created:
      x-nemo-guardrails:
        classification: opaque
    id:
      x-nemo-guardrails:
        classification: opaque
    metadata:
      x-nemo-guardrails:
        classification: opaque
    model:
      x-nemo-guardrails:
        classification: opaque
    moderation:
      x-nemo-guardrails:
        classification: opaque
    object:
      x-nemo-guardrails:
        classification: opaque
    service_tier:
      x-nemo-guardrails:
        classification: opaque
    system_fingerprint:
      x-nemo-guardrails:
        classification: opaque
    usage:
      x-nemo-guardrails:
        classification: opaque
  required:
  - choices
  title: openai.chat_completions.response.text.v1
  type: object
  x-nemo-guardrails:
    model: ChatCompletionsGuardedResponse
    reject_case_aliases: true
    unknown_fields: forbid
stream:
  oneOf:
  - additionalProperties: false
    description: Allow one text choice or an empty usage chunk, preserving root metadata.
    properties:
      choices:
        items:
          additionalProperties: false
          description: Require integer choice zero and reject unreviewed choice-level content.
          properties:
            delta:
              additionalProperties: false
              description: Accept assistant text or metadata-only deltas within a closed boundary.
              properties:
                audio:
                  default: null
                  type: 'null'
                  x-nemo-guardrails:
                    classification: constrained
                    gate: disabled
                    reason: core_capability.audio_content
                content:
                  default: null
                  oneOf:
                  - type: string
                  - type: 'null'
                  x-nemo-guardrails:
                    classification: guarded
                    subject:
                      kind: text
                      role: assistant
                function_call:
                  default: null
                  type: 'null'
                  x-nemo-guardrails:
                    classification: constrained
                    gate: disabled
                    reason: core_capability.tool_content
                reasoning_content:
                  default: null
                  type: 'null'
                  x-nemo-guardrails:
                    classification: constrained
                    extension: true
                    gate: disabled
                    reason: core_capability.reasoning_content
                refusal:
                  default: null
                  type: 'null'
                  x-nemo-guardrails:
                    classification: constrained
                    gate: disabled
                    reason: core_capability.refusal_content
                role:
                  default: null
                  oneOf:
                  - const: assistant
                    type: string
                  - type: 'null'
                  x-nemo-guardrails:
                    classification: constrained
                tool_calls:
                  default: null
                  oneOf:
                  - items: {}
                    maxItems: 0
                    type: array
                  - type: 'null'
                  x-nemo-guardrails:
                    classification: constrained
                    reason: core_capability.tool_content
              title: ChatCompletionsStreamDeltaProjection
              type: object
              x-nemo-guardrails:
                classification: guarded
                reject_case_aliases: true
                source: '#/components/schemas/ChatCompletionStreamResponseDelta'
                unknown_fields: forbid
            finish_reason:
              default: null
              x-nemo-guardrails:
                classification: opaque
            index:
              maximum: 0
              minimum: 0
              type: integer
              x-nemo-guardrails:
                classification: constrained
            logprobs:
              default: null
              type: 'null'
              x-nemo-guardrails:
                classification: constrained
                gate: disabled
                reason: provider_integrity.token_logprobs
          required:
          - delta
          - index
          title: ChatCompletionsStreamChoiceProjection
          type: object
          x-nemo-guardrails:
            reject_case_aliases: true
            unknown_fields: forbid
        maxItems: 1
        type: array
        x-nemo-guardrails:
          classification: guarded
      created:
        x-nemo-guardrails:
          classification: opaque
      id:
        x-nemo-guardrails:
          classification: opaque
      model:
        x-nemo-guardrails:
          classification: opaque
      moderation:
        x-nemo-guardrails:
          classification: opaque
      obfuscation:
        x-nemo-guardrails:
          classification: opaque
      object:
        const: chat.completion.chunk
        type: string
        x-nemo-guardrails:
          classification: constrained
      service_tier:
        x-nemo-guardrails:
          classification: opaque
      system_fingerprint:
        x-nemo-guardrails:
          classification: opaque
      usage:
        x-nemo-guardrails:
          classification: opaque
    required:
    - choices
    - object
    title: ChatCompletionsStreamPayloadProjection
    type: object
    x-nemo-guardrails:
      event:
        classification: guarded_delta
        missing_text: opaque
        missing_text_shape: chat.completion.chunk:metadata
        variants:
        - match:
            object: chat.completion.chunk
          shape: chat.completion.chunk:content
          source_schema: CreateChatCompletionStreamResponse
      model: ChatCompletionsStreamPayloadProjection
      reject_case_aliases: true
      source: '#/components/schemas/CreateChatCompletionStreamResponse'
      unknown_fields: forbid
  - additionalProperties: false
    description: Accept only an error envelope, never an error mixed with generated content.
    properties:
      error:
        additionalProperties: false
        description: Validate the native error message without treating it as guarded text.
        properties:
          code:
            default: null
            x-nemo-guardrails:
              classification: opaque
          message:
            type: string
            x-nemo-guardrails:
              classification: constrained
          misalignment:
            default: null
            x-nemo-guardrails:
              classification: opaque
          param:
            default: null
            x-nemo-guardrails:
              classification: opaque
          type:
            default: null
            x-nemo-guardrails:
              classification: opaque
        required:
        - message
        title: ChatCompletionsStreamErrorDetailsProjection
        type: object
        x-nemo-guardrails:
          classification: constrained
          reject_case_aliases: true
          source: '#/components/schemas/Error'
          unknown_fields: configurable
    required:
    - error
    title: ChatCompletionsStreamErrorProjection
    type: object
    x-nemo-guardrails:
      event:
        classification: provider_error
        variants:
        - required_fields:
          - error
          shape: error
          source_schema: ErrorResponse
      model: ChatCompletionsStreamErrorProjection
      reject_case_aliases: true
      source: '#/components/schemas/ErrorResponse'
      unknown_fields: forbid
  title: openai.chat_completions.stream.text.v1
  x-nemo-guardrails:
    transport:
      non_data_shape: keepalive
      require_sse_event: false
      sentinels:
        '[DONE]': '[DONE]'
version: 1.0.0-alpha.1
```