Magisterium AI

Making Your First API Request

Setting Up Your API Key

Configure your API key as an environment variable. This approach streamlines your API usage by eliminating the need to include your API key in each request. Moreover, it enhances security by minimizing the risk of inadvertently including your API key in your codebase.

In your terminal of choice:

export MAGISTERIUM_API_KEY=<your-api-key-here>
bash

Or, in your project’s .env file:

MAGISTERIUM_API_KEY=<your-api-key-here>
bash

Replace <your-api-key-here> with your actual API key obtained from the API Console.

Making Your First Request

Execute this curl command in the terminal of your choice:

curl -X POST https://www.magisterium.com/api/v1/chat/completions \
    -H "Authorization: Bearer $MAGISTERIUM_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
    "model": "magisterium-1",
    "messages": [
        {
        "role": "user",
        "content": "What is the Magisterium?"
        }
    ]
    }'
bash
// npm install magisterium
import Magisterium from "magisterium";

const magisterium = new Magisterium({
  apiKey: process.env.MAGISTERIUM_API_KEY,
});

export async function getMagisteriumAnswer() {
  const results = await magisterium.chat.completions.create({
    model: "magisterium-1",
    messages: [
      {
        role: "user",
        content: "What is the Magisterium?",
      },
    ]
  });

  // Handle the response
  console.log(results.choices[0].message);
}
typescript
import requests
import os

api_key = os.getenv("MAGISTERIUM_API_KEY")
url = "https://www.magisterium.com/api/v1/chat/completions"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json",
}
data = {
    "model": "magisterium-1",
    "messages": [
    {
        "role": "user",
        "content": "What is the Magisterium?",
    }
    ],
    "stream": False
}

chat_completion = requests.post(url, headers=headers, json=data)
print(chat_completion.json()["choices"][0]["message"])
python