Skip to content

API Authentication

1. Get your Lamini API key 🔑

Your API key is at https://app.lamini.ai/account. If it's your first time, create a free account by logging in.

If you're self-managing Lamini Platform on your own GPUs, check out the OIDC authentication docs for setting up user auth.

2. Authenticate

Add your key to your environment variables. In your terminal, run:

export LAMINI_API_KEY="<YOUR-LAMINI-API-KEY>"

Put this line in your ~/.bash_profile or equivalent file, so you don't have to rerun it in a new session. Remember to source ~/.bash_profile after you make the change.

echo "export LAMINI_API_KEY='$LAMINI_API_KEY'" >> ~/.bash_profile
source ~/.bash_profile
echo $LAMINI_API_KEY

You can authenticate by writing the following to a file ~/.lamini/configure.yaml

production:
    key: <YOUR-LAMINI-API-KEY>

For convenience, you can also authenticate directly in a python environment after importing lamini. It's recommended to use the other two methods.

import lamini
lamini.api_key = "<YOUR-LAMINI-API-KEY>"

Advanced Python setup: VPC or on premise

If you are running Lamini in your VPC or on prem, you can change the URL from Lamini's hosted service to your own server URL:

Test that it works: 

llm = Lamini(
    model_name="meta-llama/Meta-Llama-3.1-8B-Instruct",
    api_key="<YOUR-LAMINI-API-KEY>",
    api_url="<YOUR-SERVER-URL-HERE>",
)
response = llm.generate("Tell me a story about llamas.")

print(response)

Add the extra url field:

production:
    key: "<YOUR-LAMINI-API-KEY>"
    url: "<YOUR-SERVER-URL-HERE>"

Google Colab

Here's a Colab notebook you can use to get started: Getting Started with Lamini