Prerequisites
Before you begin, ensure you have:- A SambaCloud API key. Get one by creating a SambaCloud account and navigating to the API keys tab.
- Python 3.9 or newer installed on your machine.
Installation and setup
1
Install the package
2
Set your API key
3
Make a request
Prefix any SambaNova model name with
sambanova: in your code (e.g., sambanova:Llama-4-Maverick-17B-128E-Instruct). See the Example code section below and the full list of supported models.Example code
openai:gpt-4o alongside other models in your list.
For more information, see the AI Suite README on GitHub.
Troubleshooting
AuthenticationError or missing API key
AuthenticationError or missing API key
- Confirm
SAMBANOVA_API_KEYis exported:echo $SAMBANOVA_API_KEY - Re-export and restart your terminal or script
Model not found or invalid prefix
Model not found or invalid prefix
- Ensure model name uses the
sambanova:prefix (e.g.,sambanova:Llama-4-Maverick-17B-128E-Instruct) - Check available models on the SambaCloud models page
Python version error
Python version error
- AI Suite requires Python 3.9+. Check with
python --version

