Article outline
This article explains how you can provide your own OpenAI API keys to use with ElementsGPT, providing you with better control over which keys you use to utilise the Elements AI capabilities.
How do the API keys work?
We have provided you the ability to add your own API keys to allow you to access the OpenAI API when using ElementsGPT.
By adding up to 7 of your own keys you can ensure that you have control over the key usage according to your agreement with OpenAI. As well as added security benefits, we have performance benefits where if a key fails or is unavailable temporarily, we can send the request to the next available provided key. This helps to limit API request failures.
Note that in the event you do not provide any API keys, ElementsGPT will revert to using our provided company key as a default. Once you provide at least one key, we will use these and not the ElementsGPT key.
The Elements key uses GPT-3.5-turbo, so one benefit is that you can provide a key for GPT-4 if you want better, quicker responses.
Prerequisites
ElementsGPT activated in your space, or for consultants, an ElementsGPT license active on your user account
Space Admin permissions
Adding a new key
To add a new API key for ElementsGPT use, navigate to Space Management, and open the “Connections” tab.
From the Connections tab, open the “AI External API” tab from along the toolbar, and you will find any existing keys/your key management tools.
To add a new key, click “Add key” in the top right corner. The window will open for you to input the key information.
You should provide the OrgId (available here) and the model that the key is for. It is also strongly recommended to add a description for the key so you can differentiate between multiple keys.
You should then retrieve the key or generate a new key in Open AI, copy this to your clipboard, and paste it into the Elements.cloud window.
Once entered, click “Create”. If you activate the key it will be ready to use immediately.
Manage existing keys
You cannot change a key once it has been added, but you can delete and add new keys as required. There is a limit of 7 keys per space currently, but this is subject to change and you can contact us if you have any issues with this.
You can choose whether to make a key active or inactive by switching the toggle on the key’s right panel. We will use keys in the order of addition, starting with the first active key in the list and working down in the case of API request failure.
Once a key is deleted you cannot restore it.
Limitations and troubleshooting
You can currently add up to 7 keys per space.
If GPT is disabled in your Space, we will delete all the provided keys immediately. If GPT is then reenabled, you will be required to add new key(s).
We only support OpenAI keys for the specified models at this moment, but this is subject to change in the future.
Supported models
GPT 3.5 TURBO
GPT 4
GPT 4 TURBO
GPT 4o
GPT 4o mini