How to create a Clarifai API key to use in Ozeki AI Gateway

This guide demonstrates how to create a Clarifai personal access token and configure it in Ozeki AI Gateway. You will learn how to access the Clarifai console, generate a new access token with the appropriate permissions, and set up Clarifai as a provider in your gateway. 

API URL: https://api.clarifai.com/v2/ext/openai/v1
Example API Key: abcd1234...
Default model: gpt-oss:120b

What is Clarifai?

Clarifai is an AI platform that provides access to a wide range of large language models and computer vision models through a unified API. Clarifai's API follows the OpenAI-compatible format, making it straightforward to integrate with existing applications. When configured with Ozeki AI Gateway, it gives your users access to Clarifai's hosted AI models while maintaining centralized access control and monitoring.

Overview
Overview

Steps to follow

We assume Ozeki AI Gateway is already installed on your system. You can install it on Linux, Windows or Mac.

  1. Open the Clarifai website and log in
  2. Navigate to Access Credentials
  3. Create a new personal access token
  4. Copy the access token
  5. Open Providers page in Ozeki AI Gateway
  6. Create provider

How to create a Clarifai API key video

The following video shows how to create a Clarifai personal access token and configure it in Ozeki AI Gateway step-by-step.

Step 1 - Open the Clarifai website and log in

Navigate to clarifai.com and log in to your account. If you do not have an account yet, create one by clicking the sign-up or Start for free button on the website (Figure 1).

Open Clarifai website and log in
Figure 1 - Open the Clarifai website and log in

Step 2 - Navigate to Access Credentials

Once logged in, navigate to the Access Credentials section of your account. This is where you can manage your personal access tokens, which are used to authenticate API requests to Clarifai's services (Figure 2).

Navigate to Access Credentials
Figure 2 - Navigate to Access Credentials

Step 3 - Create a new personal access token

Click the button to create a new personal access token. This will open a form where you can configure the token's name and permissions (Figure 3).

Create new personal access token
Figure 3 - Create a new personal access token

Enter a descriptive name for the token, such as "Ozeki AI Gateway", and select the appropriate permission scope. After entering the required details, click the Create Personal Access Token button to create it (Figure 4).

Enter token name, permission and generate token
Figure 4 - Enter the token name and permission, then generate

Step 4 - Copy the access token

After the token is generated, it will be displayed on the screen. Click the Copy button to copy it to your clipboard and store it securely - you will need it when configuring the provider in Ozeki AI Gateway (Figure 5).

The access token is shown only once for security reasons. Make sure to copy and securely store the token before closing this window. If you lose it, you will need to generate a new one.

Copy token
Figure 5 - Copy your Clarifai personal access token

Step 5 - Open Providers page in Ozeki AI Gateway

Open the Ozeki AI Gateway web interface and navigate to the Providers page. This is where you will configure Clarifai as a new provider using the access token you just generated (Figure 6).

Open Providers page in Ozeki AI Gateway
Figure 6 - Open Providers page in Ozeki AI Gateway

Step 6 - Create provider

Click the New button to begin the provider creation process. This opens a form where you will enter the connection details for Clarifai (Figure 7).

Add new provider
Figure 7 - Click to add a new provider

Fill in the provider configuration form with Clarifai's details. Enter a descriptive provider name, select OpenAI compatible as the provider type, specify the API endpoint URL, and paste the access token you copied earlier. Select your preferred model from the dropdown list, then click Create to save the configuration (Figure 8). 

https://api.clarifai.com/v2/ext/openai/v1

Enter provider details and create
Figure 8 - Enter Clarifai provider details and create

The Clarifai provider now appears in the providers list, confirming that your gateway can route requests to Clarifai's services. You can now create routes that allow users to access Clarifai's AI models through your gateway (Figure 9).

Provider created successfully
Figure 9 - Clarifai provider created successfully

Final thoughts

You have successfully created a Clarifai personal access token and configured it as a provider in Ozeki AI Gateway. Your gateway can now communicate with Clarifai's services and access their hosted AI models through a unified interface. This setup allows you to manage access to Clarifai's models for multiple users and applications from a single point, while maintaining centralized control over API usage and costs.

More information