QuickStart

This QuickStart guide is designed to assist you in making your first API call. If you are an experienced AI applications developer, you may find it more beneficial to go directly to the API reference documentation.

If you would like to interact with the models using Cerebras’ Inference solution before making an API call, please visit the developer playground.

This guide will walk you through:

• Setting up your developer environment
• Installing the Cerebras Inference library
• Making your first request to the Cerebras API

​

Prerequisites

To complete this guide, you will need:

• A Cerebras account
• A Cerebras Inference API key
• Python 3.7+ or TypeScript 4.5+

​

Step 1: Set up your API key

The first thing you will need is a valid API key. Please visit this link and navigate to “API Keys” on the left nav bar.

For security reasons and to avoid configuring your API key each time, it is recommended to set your API key as an environment variable. You can do this by running the following command in your terminal:

export CEREBRAS_API_KEY="your-api-key-here"

​

Step 2: Install the Cerebras Inference library

The Cerebras Inference library is available for download and installation through the Python Package Index (PyPI) and the npm package manager. To install the library run either of the following commands in your terminal, based on your language of choice:

​

Step 3: Making an API request

Once you have configured your API key, you are ready to send your first API request.

The following code snippets demonstrate how to make an API request to the Cerebras API to perform a chat completion.

​

Next Steps

• Visit our repositories for our Python and Node.js libraries
• Check out our API Reference to learn about the details of our available endpoints and request parameters.
• Learn how to stream responses.
• Learn about tool use.