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