> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enconvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI

> Configure OpenAI models in EnConvo

## Overview

OpenAI provides powerful language models including GPT-4o, GPT-4, and the o-series reasoning models.

## Supported Models

| Model           | Description             | Best For          |
| --------------- | ----------------------- | ----------------- |
| **GPT-4o**      | Most capable multimodal | General use       |
| **GPT-4o mini** | Fast and affordable     | Daily tasks       |
| **o1**          | Advanced reasoning      | Complex problems  |
| **o1-mini**     | Fast reasoning          | Quick analysis    |
| **o1-pro**      | Professional reasoning  | Deep analysis     |
| **o3**          | Latest reasoning        | Complex reasoning |
| **o3-mini**     | Fast o3 variant         | Quick reasoning   |
| **o4-mini**     | Newest mini model       | Efficient tasks   |
| **GPT-5**       | Next generation         | Coming soon       |
| **GPT-5-mini**  | Mini variant            | Coming soon       |
| **GPT-5-codex** | Code specialized        | Development       |

## Setup

<Steps>
  <Step title="Get API Key">
    1. Go to [OpenAI Platform](https://platform.openai.com)
    2. Sign in or create an account
    3. Navigate to **API Keys**
    4. Create a new API key
  </Step>

  <Step title="Configure in EnConvo">
    1. Open **Settings** → **AI Provider**
    2. Select **OpenAI**
    3. Go to **Credentials** module
    4. Enter your API key
  </Step>

  <Step title="Select Model">
    Choose your preferred model from the dropdown
  </Step>
</Steps>

## Configuration

| Setting         | Description           | Default    |
| --------------- | --------------------- | ---------- |
| **Credentials** | API key configuration | Required   |
| **Model Name**  | Model to use          | GPT-4o     |
| **Temperature** | Creativity (0-2)      | Medium (1) |

## Validate and Use

<Steps>
  <Step title="Validate credentials">
    Click **Validate** in the OpenAI credential settings. If validation fails, confirm the key is active and billing is enabled in the OpenAI Platform dashboard.
  </Step>

  <Step title="Refresh models">
    Reopen the model dropdown after validation. EnConvo loads available OpenAI models from your account and falls back to defaults when the model API cannot be reached.
  </Step>

  <Step title="Send a short test">
    Use a simple prompt such as `Say hello in one sentence` before running long chats, agents, or automation workflows.
  </Step>
</Steps>

<Note>
  OpenAI API billing is separate from a ChatGPT Plus or Pro subscription. Use the OpenAI subscription provider if you want to connect an existing ChatGPT plan instead.
</Note>

## Reasoning Models

For o-series and GPT-5 models, configure reasoning effort:

### o1, o3, o4 Series

| Level      | Description                     |
| ---------- | ------------------------------- |
| **Low**    | Fast, economical token usage    |
| **Medium** | Balanced speed and accuracy     |
| **High**   | Thorough reasoning, more tokens |

### GPT-5 Series

| Level       | Description                |
| ----------- | -------------------------- |
| **Minimal** | Fastest, minimal reasoning |
| **Low**     | Quick reasoning            |
| **Medium**  | Balanced                   |
| **High**    | Deep reasoning             |

## Pricing

Check [OpenAI Pricing](https://openai.com/pricing) for current rates.

| Model       | Input     | Output    |
| ----------- | --------- | --------- |
| GPT-4o      | \$2.50/1M | \$10/1M   |
| GPT-4o mini | \$0.15/1M | \$0.60/1M |
| o1          | \$15/1M   | \$60/1M   |
| o1-mini     | \$3/1M    | \$12/1M   |

## Best Practices

<AccordionGroup>
  <Accordion title="Model Selection">
    * **GPT-4o**: Complex tasks, analysis, coding
    * **GPT-4o mini**: Quick tasks, chat
    * **o1/o3**: Math, logic, complex reasoning
  </Accordion>

  <Accordion title="Cost Management">
    * Use GPT-4o mini for simple tasks
    * Set usage limits in OpenAI dashboard
    * Monitor usage in EnConvo settings
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid API key">
    * Verify key is copied correctly
    * Check if key has expired
    * Ensure billing is configured
  </Accordion>

  <Accordion title="Rate limits">
    * Wait and retry
    * Upgrade OpenAI plan
    * Use different model temporarily
  </Accordion>
</AccordionGroup>