Schnellstart

maKI bietet eine OpenAI-kompatible API. Wenn Sie bereits das OpenAI SDK verwendet haben, kennen Sie sich schon aus — ändern Sie einfach den Endpunkt.

Base-URL & Authentifizierung

Base-URL	https://maki.uni-mannheim.de/v1
Auth	Bearer-Token (API-Schlüssel)

Um einen API-Schlüssel zu erhalten, wenden Sie sich an Ihren maKI-Administrator.

Python (OpenAI SDK)

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://maki.uni-mannheim.de/v1",
    api_key="your-api-key",
)

response = client.chat.completions.create(
    model="gemma4-26b",
    messages=[{"role": "user", "content": "Was ist die Hauptstadt von Frankreich?"}],
)

print(response.choices[0].message.content)

curl

curl https://maki.uni-mannheim.de/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemma4-26b",
    "messages": [{"role": "user", "content": "Was ist die Hauptstadt von Frankreich?"}]
  }'

Streaming

Mit stream=True erhalten Sie Token für Token:

stream = client.chat.completions.create(
    model="gemma4-26b",
    messages=[{"role": "user", "content": "Erkläre Quantencomputing"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Embeddings

response = client.embeddings.create(
    model="jina-embeddings-v2-base-de",
    input="Ein Beispielsatz auf Deutsch",
)

print(response.data[0].embedding[:5])  # Erste 5 Dimensionen

Transkription

Audiodateien (WAV, MP3, FLAC, OGG) transkribieren:

audio_file = open("aufnahme.wav", "rb")

transcription = client.audio.transcriptions.create(
    model="parakeet-v3",
    file=audio_file,
)

print(transcription.text)

curl https://maki.uni-mannheim.de/v1/audio/transcriptions \
  -H "Authorization: Bearer your-api-key" \
  -F model="parakeet-v3" \
  -F file="@aufnahme.wav"

Health Check

curl https://maki.uni-mannheim.de/health
# OK