> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-poc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# openai_chat_complete_with_raw_response()

> Generate chat completions and get the raw HTTP response

Generate chat completions and receive the raw HTTP response. Use this when you need access to HTTP headers,
status codes, or other low-level response details.

## Arguments

| Name                | Type      | Default | Required | Description                                                              |
| ------------------- | --------- | ------- | -------- | ------------------------------------------------------------------------ |
| `model`             | `TEXT`    | -       | ✔        | The OpenAI model to use (e.g., `gpt-4o`, `gpt-4o-mini`, `gpt-3.5-turbo`) |
| `messages`          | `JSONB`   | -       | ✔        | Array of message objects with `role` and `content` fields                |
| `api_key`           | `TEXT`    | `NULL`  | ✖        | OpenAI API key. If not provided, uses `ai.openai_api_key` setting        |
| `api_key_name`      | `TEXT`    | `NULL`  | ✖        | Name of the secret containing the API key                                |
| `frequency_penalty` | `FLOAT`   | `NULL`  | ✖        | Penalize new tokens based on their frequency (-2.0 to 2.0)               |
| `logit_bias`        | `JSONB`   | `NULL`  | ✖        | Modify the likelihood of specified tokens appearing                      |
| `logprobs`          | `BOOLEAN` | `NULL`  | ✖        | Return log probabilities of output tokens                                |
| `top_logprobs`      | `INT`     | `NULL`  | ✖        | Number of most likely tokens to return at each position                  |
| `max_tokens`        | `INT`     | `NULL`  | ✖        | Maximum number of tokens to generate                                     |
| `n`                 | `INT`     | `NULL`  | ✖        | Number of chat completion choices to generate                            |
| `presence_penalty`  | `FLOAT`   | `NULL`  | ✖        | Penalize new tokens based on their presence (-2.0 to 2.0)                |
| `response_format`   | `JSONB`   | `NULL`  | ✖        | Format of the response (e.g., `{"type": "json_object"}`)                 |
| `seed`              | `INT`     | `NULL`  | ✖        | Random seed for deterministic sampling                                   |
| `stop`              | `TEXT`    | `NULL`  | ✖        | Up to 4 sequences where the API will stop generating                     |
| `temperature`       | `FLOAT`   | `NULL`  | ✖        | Sampling temperature (0 to 2). Higher = more random                      |
| `top_p`             | `FLOAT`   | `NULL`  | ✖        | Nucleus sampling parameter (0 to 1)                                      |
| `tools`             | `JSONB`   | `NULL`  | ✖        | List of tools the model may call                                         |
| `tool_choice`       | `JSONB`   | `NULL`  | ✖        | Controls which tool is called                                            |
| `openai_user`       | `TEXT`    | `NULL`  | ✖        | Unique identifier for the end-user                                       |
| `extra_headers`     | `JSONB`   | `NULL`  | ✖        | Additional HTTP headers                                                  |
| `extra_query`       | `JSONB`   | `NULL`  | ✖        | Additional query parameters                                              |
| `verbose`           | `BOOLEAN` | `FALSE` | ✖        | Enable verbose logging                                                   |
| `client_config`     | `JSONB`   | `NULL`  | ✖        | Advanced client configuration                                            |

## Returns

`JSONB`: The complete HTTP response including headers and body.

## Related functions

* [`openai_chat_complete()`][openai_chat_complete]: standard chat completion function

[openai_chat_complete]: /api-reference/pgai/model-calling/openai/openai_chat_complete