machined.
Search
K

Configuring OpenAI API Keys

How to configure your API keys
Machined is a bring-your-own-key service, so you will need an OpenAI Platform account with billing enabled and a sufficient rate limit to create content.

Configuration

It's super easy to get up and running:
  1. 1.
    Sign up for an OpenAI Platform account
  2. 2.
    Upgrade your OpenAI Platform account to at least Tier 2
  3. 3.
    Create and copy an api key into Machined and start creating content

OpenAI Platform account

Machined requires you to have an OpenAI Platform account - you cannot use your ChatGPT or ChatGPT Plus account.
The Platform account is a standalone service which is billed using a credit based system and is paid separately to ChatGPT Plus. Essentially, you add credits to your account which get consumed when you use the API services.
Machined cannot use ChatGPT Plus - you must have an OpenAI Platform account.
If you don't already have an account, sign up here.

OpenAI Usage Tiers

Machined requires your OpenAI Platform account to be on Tier 2 or above
OpenAI imposes rate limits on all accounts in order to preserve fair usage and protect their platform from abuse. Rate limits restrict how many tokens an account is allowed to generate over a period of time, and it's usually a different limit for each model.
In November 2023, OpenAI introduced the concept of Usage Tiers, which are essentially predefined usage levels with a specific set of rate limits, shown below:
OpenAI API usage tiers
Users can progress and upgrade from one tier to the next by following the qualification steps outlined for each tier.
You can see the tier and limits for your organisation in your account limits page.

Requirements

The below tables outlines how each of the usage tiers is supported and behaves.
Tier
Support
Limitations
Free
None
Will not work
Tier 1
Partial
Can write articles one at a time - useful for evaluation purposes
Tier 2
Full
Can write articles in bulk but might experience errors and timeouts
Tier 3+
Full
No restrictions or limitations
Machined will allow you to connect an account that is on Tier 1 - but we allow this only for evaluation purposes as it allows you to play with the platform while waiting to qualify for the next tier.

Setup Guide

Generate an api key

Go to your OpenAI Platform account's api keys page and generate a new api key
When the key has been generated, click the Copy button

Add the api key

Go to the Machined Configuration popup and click on the OpenAI Configuration section
Paste you api key and click on the Verify button - this will verify and validate your account
If your account and key are valid, you will see success with a summary of your rate limits
If on the other hand you see an error or warning, please check the troubleshooting guide below

Troubleshooting

If you receive an error when setting your key, this usually means that there is a problem with either your OpenAI account or API key. Common reasons for invalid keys:
  • Typos - mistyped or incorrectly copied key
    • Copy the key again, ensuring it is correct
  • Throttling - an intermittent error with your api account
    • Wait a few minutes and try again
  • Revoked key - you are using an old key that has been revoked
    • Create a new key in your account and try again
  • You are on a Free OpenAI account - free accounts are not supported
    • Add a payment method and enable billing on your OpenAI Platform account
  • You have an insufficient Rate Limit - you need an account with sufficient rate limits
    • Double check your rate limits and ensure they are sufficient
    • You could reach out to OpenAI and ask for a rate limit increase