How can we help you?

OpenAI

Discover how to effortlessly connect Engini to OpenAI.

Engini’s OpenAI connector enables seamless integration, allowing you to create chat completions, manage moderation tasks, and efficiently handle batch processing directly within your workflows. Enhance your content generation, moderation, and task automation with this powerful integration.

Getting Started with OpenAI #

Prerequisites #

  • An OpenAI account.
  • Active access token.

Retrieve your OpenAI access token #

  1. Create an OpenAI Account:
    • Once you have an account, log in to the OpenAI platform.
  2. Log in to OpenAI:
    • Once you have an account, log in to the OpenAI platform.
  3. Navigate to the API Key Section:
    • After logging in, go to the API Keys section in your OpenAI account. This is typically found under the dashboard or settings menu.
    • You will see an option to create a new API key. Click on it.
  1. Generate an API Key:
    • Once you click to create a new API key, a key will be generated. This key is your access token.
    • Copy the API key. Make sure to store it securely, as it provides access to your OpenAI resources.
  2. Use the Access Token:
    • In your application or script, you’ll use this API key as the Authorization header in your HTTP requests to authenticate with OpenAI’s API.
  3. Managing API Keys:
    • You can manage, regenerate, or delete API keys from the same section in your OpenAI account. If your API key is compromised, regenerate it immediately.

Connecting Engini to OpenAI #

  1. Enter your Engini account at https://app.engini.io.
  2. Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here.
  3. Click on the “Add connection” option located in the top bar.
  1. Choose the OpenAI option from the available applications.
  1. Enter the following details in the “Add Connection” form:
    • Connection name
    • API Key – Enter the access token you obtained from OpenAI.


Triggers #

The trigger is executed automatically in response to a specific event. Every workflow must start with a trigger. You can use the “Check for batches” trigger to initiate your workflow.

Check for batches #

This trigger will check the batch processing logs in OpenAI.

Starting (UTC):

  • Date and Time: Specifies when the trigger should start. In this example, it is set to start on September 8, 2024, at 00:00 UTC.

Recur Every:

  • Interval: Defines how often the trigger should recur. In this case, it is set to recur every 15 minutes.

Add Time Frame:

  • Allows you to specify a time frame for which the logs should be checked.


Actions #

Add File to Vector Store #

This action allows you to upload a file to a specified vector store in OpenAI.

  • Vector Store ID: Enter the unique ID of the vector store where you want to store the file.
  • File ID: Provide the ID of the file you wish to add to the vector store.

Make sure to have the correct vector store and file IDs before executing this action to ensure proper file storage and retrieval.

Analyze Image (Vision) #

This action allows you to analyze an image using OpenAI’s vision model. You can provide specific details about the image, such as its type and source, to generate insights.

  • Model: Select the AI model that will be used for analyzing the image.
  • Prompt: Enter any specific instructions or details for how you want the image to be analyzed.
  • Image Type: Define the type of image (e.g., JPG, PNG, etc.).
  • Image Source: Select the source of the image. Options include:
    • Base64 String: Provide the image data encoded as a Base64 string.
    • Image URL: Provide the URL where the image is located.
  • Image Data: Provide the image data as a URL or a base64-encoded string.
  • Max Tokens: Set the maximum number of tokensthe model can use to generate a response based on the image analysis. The default is set to 300 tokens.

You can add additional fields as needed by selecting Add Field to customize the analysis further.

Append to Object Array #

This action allows you to add a new item to an existing object array within your workflow.

  • Variable: Select the variable that contains the object array you want to append to. The chosen variable should already be defined in your workflow.

This action is useful for dynamically expanding arrays by adding new data points during the execution of your workflow.

Cancel Batch #

This action allows you to cancel an active or pending batch in OpenAI.

  • Batch ID: Enter the unique ID of the batch you want to cancel. This ID should correspond to a batch that is currently active or scheduled.

Use this action when you need to stop a batch process before it completes.

Create Batch #

This action allows you to create a new batch of requests in OpenAI.

  • Input file ID: Enter the ID of an uploaded file that contains the requests for the new batch.
  • Endpoint: Select the endpoint that will be used for all requests in the batch.
  • Completion window: Specify the time window (e.g., 24h) within which the batch should be completed.

You can also click Add Field to include additional parameters for further customization.

Create Chat Completion #

This action allows you to generate a chat completion based on the provided conversation history.

  • Messages: Provide a list of messages comprising the conversation so far. These messages should include both user and assistant inputs to maintain context.
  • Model: Select the ID of the model you want to use to generate the chat completion.

You can also click Add Field to include additional parameters to further customize the chat completion process.

Create Moderation #

This action allows you to classify input text using OpenAI’s moderation tools to determine if the content violates specific policies.

  • Input: Enter the text you want to classify. This text will be analyzed to check if it complies with moderation guidelines.

You can also click Add Field to include additional parameters to further customize the moderation process.

Create Transcription #

This action allows you to transcribe an audio file using OpenAI’s transcription model.

  • Filename: Enter the name of the audio file (in formats such as flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm).
  • Content: Provide the content of the audio file as a base64-encoded string.

Properties:

  • Model: Select the transcription model to be used (e.g., whisper-1).
  • Request Format: Choose the format for the transcription result (e.g., text).

You can also click Add Field to include additional parameters for further customization.

Create Translation #

This action allows you to translate an audio file into English using OpenAI’s translation model.

  • Filename: Enter the name of the audio file (in formats such as flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm).
  • Content: Provide the content of the audio file as a base64-encoded string.

Properties:

  • Model: Select the translation model to be used (e.g., whisper-1).
  • Response Format: Choose the format for the translation result (e.g., JSON).

Please note, the translation can only be performed into English.

You can also click Add Field to include additional parameters for further customization.

Generate Audio from Text #

This action allows you to convert text into audio using OpenAI’s text-to-speech capabilities.

  • Model: Select the model used to generate the audio from the input text.
  • Input: Enter the text you want to convert into audio.
  • Voice: Select the voice to be used when generating the audio.

You can also click Add Field to include additional parameters to further customize the audio generation process.

Delete File #

This action allows you to delete a file from OpenAI’s system.

  • File ID: Enter the unique ID of the file you want to delete. Make sure you have the correct file ID, as this action will permanently remove the file from the system.

Delete Vector Store File #

This action allows you to delete a file from a specific vector store in OpenAI.

  • Vector Store ID: Enter the unique ID of the vector store from which you want to delete the file.
  • File ID: Enter the unique ID of the file you want to delete from the vector store.

Ensure that both the Vector Store ID and File ID are correct, as this action will permanently remove the file from the specified vector store.

Download File Content #

This action allows you to download the content of a file from OpenAI’s system.

  • File ID: Enter the unique ID of the file you want to download. The file’s content will be retrieved based on this ID.

Ensure that the correct File ID is provided to successfully download the file content.

Edit Image #

This action allows you to edit an image using OpenAI’s image editing capabilities.

  • Prompt: Enter a description of the changes you want to apply to the image.

Image:

  • Filename: Provide the name of the image you want to edit.
  • Content: Enter the content of the image as a base64-encoded string.

You can also click Add Mask Image to include a mask that specifies which parts of the image should be edited.

Generate Image #

This action allows you to create an image using OpenAI’s image generation capabilities.

  • Prompt: Enter a detailed text description of the desired image(s). The AI will use this prompt to generate an image based on the provided description.

You can also click Add Field to include additional parameters to further customize the image generation process.

Get Batch Info #

This action allows you to retrieve information about a specific batch in OpenAI.

  • Batch ID: Enter the unique ID of the batch for which you want to retrieve information. The details of the batch will be fetched based on this ID.

Ensure the correct Batch ID is provided to successfully retrieve the batch information.

Get Batches #

This action allows you to retrieve a list of batches stored in OpenAI’s system. You can use this to view all the batches that have been created and track their status.

Initialize Object Array #

This action allows you to create and initialize a new object array in OpenAI.

  • Variable name: Enter the name of the variable that will store the initialized object array.
  • Object Element Type: Select the type of elements that will be stored in the object array. Options include:
    • Assistant Message: Store messages generated by the assistant.
    • Attachments: Store file attachments or other media.
    • Chat Message: Store messages from a chat conversation.

This action is useful for setting up an array to store multiple objects for use later in your workflow.

List Files #

This action allows you to retrieve a list of files stored in OpenAI’s system.

You can click Add Filter to apply filters such as purpose (e.g., assistants, batch, embedding, fine-tune, vision) to refine the list of files.

List Vector Store Files #

This action allows you to retrieve a list of files stored in a specific vector store in OpenAI.

  • Vector Store ID: Enter the unique ID of the vector store from which you want to list the files.
  • Order By Created At: Select whether you want to order the files by the date they were created in ascending or descending order.

You can also click Add Filter to include additional filters for refining the file list, such as file types or specific date ranges.

Message an Assistant #

This action allows you to send a message to an assistant in OpenAI.

  • Assistant ID: Enter the unique ID of the assistant to which you want to send the message.
  • Message: Provide the content of the message you want to send.
  • Tools: Select any tools the assistant should use when processing the message.

You can also click Add Field to include additional parameters to customize the interaction further.

Upload File #

This action allows you to upload a file to OpenAI’s system.

  • Filename: Enter the name of the file you want to upload.
  • Content: Provide the content of the file as a base64-encoded string.
  • Purpose: Select the purpose of the uploaded file from the list Purpose (e.g., assistants, batch, embedding, fine-tune, vision).

Make sure to select the appropriate purpose to ensure the file is used correctly within OpenAI’s system.

What are your Feelings

Powered by BetterDocs

LET’S ENGINE WORK PROCESS

Over 500+ people trusted

© Engini.io 2024 All rights reserved