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

# OpenAI

> Configure PipesHub to use OpenAI speech-to-text models

# OpenAI Speech to Text Configuration

<img src="https://mintcdn.com/pipeshub/xDYTCu7XyGABzJ1N/images/ai-models/stt/OpenAI_STTConfig.png?fit=max&auto=format&n=xDYTCu7XyGABzJ1N&q=85&s=8775f94fd6daea1132ae35f1abe41c99" alt="OpenAI STT Configuration Interface" width="668" height="1005" data-path="images/ai-models/stt/OpenAI_STTConfig.png" />

*The OpenAI STT configuration screen in PipesHub where you'll enter your API Key and Model Name*

PipesHub integrates with OpenAI's speech-to-text models to enable voice input in AI workflows and agents. Once configured, PipesHub can transcribe spoken audio into text using OpenAI's Whisper and GPT-4o transcription models.

## Required Fields

### API Key \*

The API Key is required to authenticate your requests to OpenAI's transcription services.

**How to obtain an API Key:**

1. Log in to your [OpenAI account](https://platform.openai.com/api-keys)
2. Navigate to the API Keys section
3. Create a new secret key
4. Copy the key immediately (it will only be shown once)

**Security Note:** Your API key should be kept secure and never shared publicly. PipesHub securely stores your API key and uses it only for authenticating requests to OpenAI.

### Model Name \*

The Model Name field defines which OpenAI transcription model you want to use.

**Available OpenAI STT models:**

* `whisper-1` — OpenAI's Whisper model, supports 50+ languages
* `gpt-4o-transcribe` — GPT-4o powered transcription, highest accuracy
* `gpt-4o-mini-transcribe` — GPT-4o Mini powered transcription, faster and more cost-effective

**How to choose a model:**

* For broad language support and general-purpose transcription, use `whisper-1`
* For the highest transcription accuracy, use `gpt-4o-transcribe`
* For a balance of speed and accuracy at lower cost, use `gpt-4o-mini-transcribe`
* Check OpenAI's [speech-to-text documentation](https://platform.openai.com/docs/guides/speech-to-text) for the most up-to-date model options

## Optional Fields

### Model Friendly Name

A human-readable label for this configuration, shown in the PipesHub UI instead of the raw model name. Useful when you have multiple configurations of the same provider.

## Configuration Steps

As shown in the image above:

1. Click **Configure** on the OpenAI provider card in the STT tab
2. Enter your OpenAI API Key in the designated field (marked with \*)
3. Enter the Model Name (marked with \*), for example `whisper-1`
4. (Optional) Set a **Model Friendly Name**
5. Click **Add Model** to save and validate your credentials

> Both the API Key and Model Name are required fields to successfully configure OpenAI STT integration.

## Usage Considerations

* Each transcription request counts against your OpenAI API quota and billing
* `whisper-1` is priced per minute of audio transcribed
* GPT-4o transcription models may be priced differently — check OpenAI's pricing page
* Audio files are sent to OpenAI's API servers for processing

## Troubleshooting

* If you encounter authentication errors, verify your API key is correct and has not expired
* Ensure your OpenAI account has billing enabled
* Check that the model name is spelled exactly as shown (e.g. `whisper-1`, not `Whisper-1`)
* Verify your account has access to the audio transcription API

For additional support, refer to the [OpenAI speech-to-text documentation](https://platform.openai.com/docs/guides/speech-to-text) or contact PipesHub support.
