Your own API keys (BYOK)

BYOK means “bring your own key”. If your org has an account with an AI service, such as OpenAI or Tripo, you can add its API key to tabletop. A node that uses your key costs no tokens. The service bills your account.

Services that take a key

The other nodes that cost tokens, such as Generate Hair, always use tokens.

Add a key

An Owner or an Admin adds the keys of the org.

1. Click your avatar, then Organization settings.
2. Open Provider keys. The tab has one section for each service.
3. In the section of the service, click Add key.
4. Type a Label, such as “Studio Tripo”. Your team sees this name when they pick a key.
5. Paste the API key.
6. Click Save.

An org can have more than one key for a service. For example, use one key for each project.

After you save a key, tabletop shows only its label and its last 4 characters, such as “••••1234”. The list also shows who Added by and when the key was Last used.

Pay with a key on a node

1. Click the node. The inspector opens.
2. In Params, open Pay with. It shows below Provider.
3. Pick your key, such as “Studio Tripo ••••1234”.

Each node has its own choice. A new node uses tokens. To use tokens again, pick Use tokens.

Pay with shows only when the provider of the node takes a key. When you change the provider, Pay with goes back to Use tokens.

Rename or remove a key

In Provider keys, an Owner or an Admin can click Rename or Remove next to a key.

Costs and limits

• A run on your key costs 0 tokens in tabletop. The service bills your account for its use.
• Your key has the limits of your account at the service.

See the steps in Use your own API keys.