# Workflow Application: OPENAITRANSCRIPTION usage
**URL:** https://discuss.workflowgen.com/t/workflow-application-openaitranscription-usage/2225
**Category:** Workflow Applications
**Created:** [July 26, 2024, 5:51pm UTC](https://discuss.workflowgen.com/t/workflow-application-openaitranscription-usage/2225 "2024-07-26T17:51:29Z")
**Posts on this page:** 2
**Page:** 1
### Author:  [@wfg-admin](https://discuss.workflowgen.com/u/wfg-admin)
#### Post date: [July 26, 2024, 5:51pm UTC](https://discuss.workflowgen.com/t/workflow-application-openaitranscription-usage/2225/1 "2024-07-26T17:51:29Z")
## Overview
The **OPENAITRANSCRIPTION** workflow application lets you interact with an OpenAI audio model to transcribe an audio file.
## Required parameter
| Parameter | Type | Direction | Description |
| --- | --- | --- | --- |
| `FILE` | FILE | IN | The audio file to transcribe |
## Optional parameters
| Parameter | Type | Direction | Description |
| --- | --- | --- | --- |
| `API_KEY` | TEXT | IN | OpenAI API key
By default, this value comes from the `OpenAiApiKey` parameter in the `web.config` file. |
| `URL` | TEXT | IN | API endpoint
**Default:** `https://api.openai.com/v1/audio/transcriptions` |
| `MODEL` | TEXT | IN | ID of the model to use
**Default:** `whisper-1` |
| `TEMPERATURE` | NUMERIC | IN | Sampling temperature, between `0` and `1`
**Default:** `1`
Higher values (e.g. `0.8` ) will make the output more random, while lower values (e.g. `0.2` ) will make it more focused and deterministic. |
| `LANGUAGE` | TEXT | IN | The language of the input audio
Supplying the input language in ISO-639-1 format will improve accuracy and latency. |
| `PROMPT` | TEXT | IN | Optional text to guide the model’s style or continue a previous audio segment; the prompt should match the audio language |
| `VERBOSE_OUTPUT` | TEXT | IN | Specifies (`Y` or `N`) if the output should be verbose
**Default:** `N` |
| `WORDS_OUTPUT` | TEXT | IN | Specifies (`Y` or `N`) if the verbose output should include detailed words
**Default:** `N` |
| `RESULT_WORDS_SEPARATOR` | TEXT | IN | Separator used to separate the word list
**Default:** `,` (comma) |
| `APP_RESPONSE_IGNORE_ERROR` | TEXT | IN | Specifies (`Y` or `N`) if errors should be ignored
**Default:** `N`
In case of error, if the parameter has `Y` as its value, the error will be ignored and defined OUT parameters (`APP_RESPONSE_STATUS` or `APP_RESPONSE_CONTENT` ) will be mapped. Otherwise, an exception will be thrown. |
| `TEXT` | TEXT | OUT | The transcription text |
| `RESULT` | TEXT | OUT | The transcription result call |
| `RESULT_DURATION` | TEXT | OUT | Audio duration (only if verbose) |
| `RESULT_WORDS` | TEXT | OUT | Transcription words separated by `RESULT_WORDS_SEPARATOR` (only if word output and verbose enabled) |
| `RESULT_WORDS_COUNT` | NUMERIC | OUT | Transcription word count (only if word output and verbose enabled) |
| `RESULT_LANGUAGE` | TEXT | OUT | Transcription language (only if verbose) |
| `APP_RESPONSE_STATUS` | TEXT | OUT | Response status code |
| `APP_RESPONSE_CONTENT` | TEXT | OUT | Response payload or error message |
---
### Author:  [@pnicoll](https://discuss.workflowgen.com/u/pnicoll)
#### Post date: [December 5, 2024, 7:10pm UTC](https://discuss.workflowgen.com/t/workflow-application-openaitranscription-usage/2225/3 "2024-12-05T19:10:57Z")