Skip to content

OpenAI

OpenAI is a research organization that aims to develop and direct artificial intelligence (AI) in ways that benefit humanity as a whole.

Categories: artificial-intelligence

Type: openAi/v1


Connections

Version: 1

Bearer Token

Properties

NameLabelTypeDescriptionRequired
tokenTokenSTRINGtrue

Actions

Ask

Name: ask

Ask anything you want.

Properties

NameLabelTypeDescriptionRequired
modelModelSTRING
Options chatgpt-4o-latest, gpt-3.5-turbo, gpt-3.5-turbo-instruct, gpt-4, gpt-4-0125-preview, gpt-4-0314, gpt-4-0613, gpt-4-1106-preview, gpt-4-turbo, gpt-4-turbo-preview, gpt-4o, gpt-4o-audio-preview, gpt-4o-mini, gpt-4o-mini-audio-preview, o1, o1-mini, o1-preview, o3-mini
ID of the model to use.true
messagesMessagesARRAY
Items [{STRING(role), STRING(content), [FILE_ENTRY](attachments)}]
A list of messages comprising the conversation so far.true
responseResponseOBJECT
Properties {STRING(responseFormat), STRING(responseSchema)}
The response from the API.false
maxTokensMax TokensINTEGERThe maximum number of tokens to generate in the chat completion.null
nNumber of Chat Completion ChoicesINTEGERHow many chat completion choices to generate for each input message.null
temperatureTemperatureNUMBERControls randomness: Higher values will make the output more random, while lower values like will make it more focused and deterministic.null
topPTop PNUMBERAn alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top_p probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered.null
frequencyPenaltyFrequency PenaltyNUMBERNumber between -2.0 and 2.0. Positive values penalize new tokens based on their existing frequency in the text so far, decreasing the model’s likelihood to repeat the same line verbatim.null
presencePenaltyPresence PenaltyNUMBERNumber between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far, increasing the model’s likelihood to talk about new topics.null
logitBiasLogit BiasOBJECT
Properties {}
Modify the likelihood of specified tokens appearing in the completion.null
stopStopARRAY
Items [STRING]
Up to 4 sequences where the API will stop generating further tokens.null
userUserSTRINGA unique identifier representing your end-user, which can help admins to monitor and detect abuse.false

Example JSON Structure

{
"label" : "Ask",
"name" : "ask",
"parameters" : {
"model" : "",
"messages" : [ {
"role" : "",
"content" : "",
"attachments" : [ {
"extension" : "",
"mimeType" : "",
"name" : "",
"url" : ""
} ]
} ],
"response" : {
"responseFormat" : "",
"responseSchema" : ""
},
"maxTokens" : 1,
"n" : 1,
"temperature" : 0.0,
"topP" : 0.0,
"frequencyPenalty" : 0.0,
"presencePenalty" : 0.0,
"logitBias" : { },
"stop" : [ "" ],
"user" : ""
},
"type" : "openAi/v1/ask"
}

Output

The output for this action is dynamic and may vary depending on the input parameters. To determine the exact structure of the output, you need to execute the action.

Create Image

Name: createImage

Create an image using text-to-image models

Properties

NameLabelTypeDescriptionRequired
modelModelSTRING
Options dall-e-2, dall-e-3
The model to use for image generation.true
imageMessagesMessagesARRAY
Items [{STRING(content), NUMBER(weight)}]
A list of messages comprising the conversation so far.true
sizeSizeSTRING
Options DALL_E_2_256x256, DALL_E_2_512x512, _1024x1024, DALL_E_3_1792x1024, DALL_E_3_1024x1792
The size of the generated images.true
nNumber of ResponsesINTEGERThe number of images to generate. Must be between 1 and 10. For dall-e-3, only n=1 is supported..null
responseFormatResponse formatSTRING
Options URL, B64_JSON
The format in which the generated images are returned.null
qualityQualitySTRING
Options STANDARD, HD
The quality of the image that will be generated.null
styleStyleSTRING
Options VIVID, NATURAL
The style of the generated images. Must be one of vivid or natural. Vivid causes the model to lean towards generating hyper-real and dramatic images. Natural causes the model to produce more natural, less hyper-real looking images. This parameter is only supported for dall-e-3.null
userUserSTRINGA unique identifier representing your end-user, which can help admins to monitor and detect abuse.false

Example JSON Structure

{
"label" : "Create Image",
"name" : "createImage",
"parameters" : {
"model" : "",
"imageMessages" : [ {
"content" : "",
"weight" : 0.0
} ],
"size" : "",
"n" : 1,
"responseFormat" : "",
"quality" : "",
"style" : "",
"user" : ""
},
"type" : "openAi/v1/createImage"
}

Output

Type: OBJECT

Properties

NameTypeDescription
urlSTRING
b64JsonSTRING

Output Example

{
"url" : "",
"b64Json" : ""
}

Text-To-Speech

Name: createSpeech

Generate an audio recording from the input text

Properties

NameLabelTypeDescriptionRequired
modelModelSTRING
Options tts-1, tts-1-hd
Text-to-Speech model which will generate the audio.true
inputInputSTRINGThe text to generate audio for.true
voiceVoiceSTRING
Options ALLOY, ASH, CORAL, ECHO, FABLE, NOVA, ONYX, SAGE, SHIMMER
The voice to use when generating the audio.true
responseFormatResponse formatSTRING
Options AAC, FLAC, MP3, OPUS
The format to audio in.false
speedSpeedNUMBERThe speed of the generated audio.false

Example JSON Structure

{
"label" : "Text-To-Speech",
"name" : "createSpeech",
"parameters" : {
"model" : "",
"input" : "",
"voice" : "",
"responseFormat" : "",
"speed" : 0.0
},
"type" : "openAi/v1/createSpeech"
}

Output

Type: FILE_ENTRY

Properties

NameTypeDescription
extensionSTRING
mimeTypeSTRING
nameSTRING
urlSTRING

Output Example

{
"extension" : "",
"mimeType" : "",
"name" : "",
"url" : ""
}

Create Transcriptions

Name: createTranscription

Transcribes audio into the input language.

Properties

NameLabelTypeDescriptionRequired
fileFileFILE_ENTRYThe audio file object to transcribe, in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.true
modelModelSTRING
Options whisper-1
ID of the model to use.true
languageLanguageSTRING
Options AF, AR, HY, AZ, BE, BS, BG, CA, ZH, HR, CS, DA, NL, EL, ET, EN, FI, FR, GL, DE, HE, HI, HU, IS, ID, IT, JA, KK, KN, KO, LT, LV, MA, MK, MR, MS, NE, NO, FA, PL, PT, RO, RU, SK, SL, SR, ES, SV, SW, TA, TL, TH, TR, UK, UR, VI, CY
The language of the input audio.false
promptPromptSTRINGAn optional text to guide the model’s style or continue a previous audio segment. The prompt should match the audio language.false
responseFormatResponse formatSTRING
Options JSON, SRT, TEXT, VERBOSE_JSON, VTT
The format of the transcript outputtrue
temperatureTemperatureNUMBERThe sampling temperature, between 0 and 1. Higher values like will make the output more random, while lower values will make it more focused and deterministic.false

Example JSON Structure

{
"label" : "Create Transcriptions",
"name" : "createTranscription",
"parameters" : {
"file" : {
"extension" : "",
"mimeType" : "",
"name" : "",
"url" : ""
},
"model" : "",
"language" : "",
"prompt" : "",
"responseFormat" : "",
"temperature" : 0.0
},
"type" : "openAi/v1/createTranscription"
}

Output

The output for this action is dynamic and may vary depending on the input parameters. To determine the exact structure of the output, you need to execute the action.


Additional instructions


Connection Setup

  1. Go to the OpenAI API.
  2. In the left sidebar, click on API Keys.
  3. Click Create new secret key.
  4. Enter a name and select the project for the key and click Create secret key.
  5. Copy the API key and use it to create a connection in ByteChef.