Python SDK

Das native Python SDK spricht die Ablatic API direkt und bietet Extras, die die Kompatibilitäts-Schnittstellen nicht haben. Es steht unter MIT-Lizenz.

Installation

pip install ablatic

Authentifizierung

Übergeben Sie den Key explizit:

from ablatic import Ablatic

client = Ablatic(api_key="sk-ablatic-...")

Oder setzen Sie ABLATIC_API_KEY in der Umgebung und lassen Sie den Client ihn lesen:

export ABLATIC_API_KEY="sk-ablatic-..."

from ablatic import Ablatic

client = Ablatic()  # reads ABLATIC_API_KEY from the environment

Keys werden in der Konsole erstellt. Siehe Authentifizierung für das Key-Format und die Header-Schemata.

Chat

from ablatic import Ablatic

client = Ablatic(api_key="sk-ablatic-...")

resp = client.chat.completions.create(
    model="talos",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Die Model-ID ist talos. Standardmäßig läuft es im Thinking-Modus. Für die niedrigste Latenz übergeben Sie reasoning_effort="none".

Async

Ein Async-Client spiegelt dieselbe Schnittstelle:

import asyncio
from ablatic import AsyncAblatic

client = AsyncAblatic(api_key="sk-ablatic-...")

async def main():
    resp = await client.chat.completions.create(
        model="talos",
        messages=[{"role": "user", "content": "Hello"}],
    )
    print(resp.choices[0].message.content)

asyncio.run(main())

Native Extras

Diese Felder sind spezifisch für die Ablatic API.

Glassbox Confidence

Aktivieren Sie pro Request, um eine Glassbox Audit-Trace aufzuzeichnen:

resp = client.chat.completions.create(
    model="talos",
    messages=[{"role": "user", "content": "Hello"}],
    glassbox={"confidence": True},
)

Confidence ist opt-in und standardmäßig aus. Der Score ist noch nicht kalibriert, behandeln Sie ihn also als Signal, nicht als Wahrscheinlichkeit. Mit ausgeschaltetem Glassbox ist die Trace-Confidence null.

Refusal-Modus

Setzen Sie refusal_mode="strict", um das Refusal-Verhalten zu verschärfen, und prüfen Sie dann, ob die Antwort eine Refusal war:

resp = client.chat.completions.create(
    model="talos",
    messages=[{"role": "user", "content": "..."}],
    refusal_mode="strict",
)
if resp.was_refused():
    print("request was refused")

Der Standardwert ist soft.

Audit-Records

Requests, die Glassbox aktiviert haben, werden als Audit-Records aufgezeichnet. Sie können einen abrufen oder löschen. Das Löschen eines Audit-Records ist eine DSGVO-Löschung.

record = client.audit.get(request_id)
client.audit.delete(request_id)

Alternative: das openai SDK

Wenn Sie lieber das offizielle openai SDK nutzen, richten Sie es auf unsere Basis-URL. Sie verlieren die nativen Extras von oben, behalten aber einen vertrauten Client.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ablatic.ai/v1",
    api_key="sk-ablatic-...",
)

resp = client.chat.completions.create(
    model="talos",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)