---
title: "Translate OpenAI"
slug: "dataflow-nodes-translate-openai"
updated: 2026-02-10T04:36:21Z
published: 2026-02-10T04:36:21Z
canonical: "docs.knovvu.com/dataflow-nodes-translate-openai"
---

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

# Translate OpenAI

A node that translates any input event with a `Text` attribute. Uses OpenAI with a specialized prompt for translation.


## Parameters
|  <div style="width:120px">name</div> | description | <div style="width:220px">default</div> |
|---|---|---|
| Source Language | Language of the source text. | tr-TR |
|Target Language| Language of the target text | en-US |
| Credential | API Key Credential for the OpenAI  service | empty |
| OpenAI Model | OpenAI Model for the request  | gpt-4.1-nano-2025-04-14 |
| Prompt | The specialized prompt with placeholders used for the translation. |You are a professional translation system specialized in ...|
| Role | The role of the speaker you want replaced in the {{role}} placeholder for the prompt | |
| OpenAI Address | OpenAI Address, you can also prefer your Azure OpenAI address |  https://api.openai.com/v1/chat/completions |

## Inputs

### Audio
&emsp;none

### Events
| name | description | known nodes that generate this event |
|---|---|---|
| Any event that has `Data.Text` | Any Text based event. SR Milestone, etc. | SR Http, SR Websocket, Translate etc. |
| [Language Change](/v1/docs/events#language-change) | Language Change events that are tagged with either "Source" or "Target" will set their respective languages. | Language Identifier, Text Language Identifier, Event Tagger |
:::(Info) (Language Change notes)
The language change event from [Language Identifier](/v1/docs/dataflow-nodes-language-identifier) and [Text Language Identifier](/v1/docs/dataflow-nodes-text-language-identifier) should be tagged using the [Event Tagger Node](/v1/docs/dataflow-nodes-event-tagger) in order to effectively change this node's language . 
:::

## Outputs

### Audio
&emsp;none

### Events
|  <div style="width:120px">name</div> | description |
|---|---|
| [Translation](/v1/docs/events#translation) | Contains the translated text in `Data.Text` field.  |


## Remarks 


### Requirements
The node needs an OpenAI Api key to perform. To learn more about getting an API Key and finding it, you can refer to the [OpenAI API page](https://openai.com/api/){target="_blank"} .

After getting your API Key, you can learn about finding and securely using your key following the instructions on [this page](https://help.openai.com/en/articles/4936850-where-do-i-find-my-openai-api-key){target="_blank"} . 

You can also see which models are available through the [OpenAI Models](https://platform.openai.com/docs/models){target="_blank"}  page.

### Project  Structure
The node expects events that have the `Text` field. Which means the node can be used with any and all SR nodes.
A minimum viable project that utilizes Translate node can be built as such:
![image.png](https://cdn.document360.io/9bca2910-6a3b-4224-9470-43f91f9a6d57/Images/Documentation/image%28860%29.png){height="" width=""} 

With this project, one can use both Speech recognition and have the text translated to any desired language simultaneously.

Taking this a step further, we can construct a project such as:
![image.png](https://cdn.document360.io/9bca2910-6a3b-4224-9470-43f91f9a6d57/Images/Documentation/image%28861%29.png){height="" width=""}

Which recognizes a speech, translates the text into another language, and uses TTS to create simultaneous audio outputs. 
:::(Info) (Keep This in Mind)
Keep in mind that the [SR node](/v1/docs/dataflow-nodes-speech-recognition-sr-http) needs a model in `Source Language`, and [TTS node](/v1/docs/dataflow-nodes-tts-http) needs a Voice in the `Target Language` for this particular case. 
:::

Finally, here's a project that manipulates the `Translation` event so that it is `punctuated, filtered, normalized` before returning the output.  
![image.png](https://cdn.document360.io/9bca2910-6a3b-4224-9470-43f91f9a6d57/Images/Documentation/image%28862%29.png){height="" width=""}
:::(Info) (Keep This in Mind)
Also, keep in mind that the [SR node](/v1/docs/dataflow-nodes-speech-recognition-sr-http) needs to support the `Source Language`, and [Punctuation](/v1/docs/dataflow-nodes-punctuation), [Profanity Filter](/v1/docs/dataflow-nodes-profanity-filter), [Normalizer](/v1/docs/dataflow-nodes-normalizer) nodes need to support the `Target Language`.
:::


### Detailed Workflow
Utilizes Http calls to OpenAI Api with the provided `API Key Credential`. Raises a `Translation` event for every response. 


### Supported flow types
Stream, Batch



## Release Notes 

<div style="max-height: 200px; overflow-y: auto; overflow-x: hidden"> 
      <details>
      <summary> <strong> v4.7.0</strong>  </summary>
          <ul>
              <li>Changed default model from "gpt-3.5-turbo" to "gpt-4.1-nano-2025-04-14" </li>
    </details>
    <details>
      <summary> <strong> v4.6.0</strong>  </summary>
          <ul>
              <li>Added Flush Support; </li>
    </details>
    <details>
      <summary> <strong> v4.5.0</strong>  </summary>
          <ul>
              <li> Introduced Node. </li>
          </ul>
</details>
</div>