Zum Inhalt springen

Das ist glieks fertig.

Ihre Daten. Klar geschützt.

  • Server in Deutschland
    Unsere Server stehen in Deutschland.
  • Sprachmodelle in Europa
    Die Sprachmodelle werden in Europa betrieben.
  • DSGVO-konform
    Wir verarbeiten Ihre Daten nach den Vorgaben der DSGVO.
  • Ihre Daten arbeiten nur für Sie
    Ihre Eingaben und Dateien dienen ausschließlich Ihren Aufträgen.
  • Glieks arbeitet bei uns
    Ihre Aufträge laufen abgeschottet in Deutschland; Sie nutzen den Browser.
Mehr zum Datenschutz ↗
Entwicklerkonto Zum Bildschirm

API für Entwickler.

Daten, fertige Skills, Sprache und Sprachmodelle über eine Schnittstelle. Ein Schlüssel, eine Fehlerform, Abrechnung nach Verbrauch.

  • Server in Deutschland
  • Sprachmodelle in Europa
  • Ihre Daten arbeiten nur für Sie
  • Abgeschottete Laufräume
  • Keine Grundgebühr
  • 5 Euro Startguthaben zum Testen
Ein Programmfenster verbindet sich über ein Kabel mit Diagramm und Dokument - die Glieks-API.

Was Sie bekommen

Datenendpunkte

Amtliche Statistik, Wetter, Energie, Recht, Register und mehr - typisierte Eingaben, Antwort mit Quellenvermerk und Lizenz. Ohne Sprachmodell.

Skills

Fertige Ergebnisse als Aufruf: Rechnung, Angebot, Brief, Präsentation, Auswertung. Festpreis je Ergebnis.

Sprache

Spracherkennung, Sprachausgabe und der Sprachlauf: Audio rein, Antwort als Text und Ton zurück - mit unserem oder Ihrem eigenen Modell.

Sprachmodelle und Läufe

Modell frei wählbar aus dem Katalog. Läufe im eigenen, abgeschotteten Laufraum mit Office-Werkzeugen.

In drei Schritten

  1. Konto anlegen und E-Mail-Adresse bestätigen - Sie erhalten 5 Euro Startguthaben.
  2. Schlüssel erzeugen - ein Testschlüssel kostet nichts.
  3. Ersten Aufruf senden und Guthaben aufladen.
# Datenkatalog: alle abrufbaren Fähigkeiten mit Eingaben, Quellen und Lizenz
curl https://BASIS/api/v1/daten -H "Authorization: Bearer $GLIEKS_SCHLUESSEL"

# Ein Abruf (Antwort mit Quellenvermerk und Lizenz)
curl https://BASIS/api/v1/daten/FAEHIGKEIT \
  -H "Authorization: Bearer $GLIEKS_SCHLUESSEL" -H "Content-Type: application/json" \
  -d '{"angaben": {"ort": "Lüneburg"}}'

# Sprachausgabe als mp3
curl https://BASIS/v1/audio/speech -H "Authorization: Bearer $GLIEKS_SCHLUESSEL" \
  -H "Content-Type: application/json" -d '{"input": "Guten Tag.", "voice": "thorsten"}' -o gruss.mp3

Endpunkte

Vollständige Beschreibung aller Wege: OpenAPI-Spezifikation (YAML).

WegWozu
GET /api/v1/daten
POST /api/v1/daten/{faehigkeit}
Datenkatalog und Abruf, Antwort mit Quellenvermerk und Lizenz. Jede Fähigkeit steht mit ihren Feldern in der OpenAPI.
GET /api/v1/skills
POST /api/v1/skills/{kennung}
Skills mit Eingaben; der Aufruf startet einen Auftrag.
POST /api/v1/aufgaben
GET /api/v1/aufgaben/{id}/strom
GET /api/v1/aufgaben/{id}/ergebnisse
Läufe starten, Fortschritt als Ereignisstrom, Ergebnisse als Dateien. Feld model wählt das Modell.
POST /api/v1/laufraum/ausfuehren
GET /api/v1/laufraum/{id}
Code ausführen: Python-Code und Dateien rein, Ausgabe, Exitcode und erzeugte Dateien zurück. Läuft abgeschottet im Laufraum, berechnet wird jede angefangene Sekunde.
GET /v1/modelsModellkatalog. Er nennt je Modell Anbieter, Standort, Kontextlänge, den Preis je 1 Mio Token, der für Sie gilt, und Latenzklasse. Das Modell wählen Sie im Auftrag mit dem Feld model.
POST /v1/audio/transcriptions
POST /api/v1/transkription
Spracherkennung (Whisper large), bis 25 MiB je Datei.
POST /v1/audio/speech
POST /api/v1/sprachausgabe
Sprachausgabe mit der Stimme „thorsten“, mp3 oder wav, bis 4 096 Zeichen.
POST /api/v1/sprachlaufAudio oder Text rein, Erkennung, Antwort und Sprachausgabe in einem Aufruf, wahlweise als Strom mit Teilantworten.
PUT /api/v1/wissen/{name}Kleine Wissensablage je Schlüssel für den Sprachlauf.
GET /api/v1/verbrauchVerbrauch des Kontos.

Anmeldung mit Authorization: Bearer glk_... oder X-Glieks-Schluessel: glk_.... Basisadresse für OpenAI-Werkzeuge: https://BASIS/v1.

Code ausführen

Ihr Python-Code läuft in einem eigenen, abgeschotteten Laufraum mit den Bibliotheken für Tabellen, Dokumente und Karten. Dateien rein, Ausgabe und Dateien zurück. Berechnet wird jede angefangene Sekunde, mindestens 5 Sekunden: 0,25 Cent je Minute in Größe S, 0,50 Cent in M, 1 Cent in L.

curl https://BASIS/api/v1/laufraum/ausfuehren \
  -H "Authorization: Bearer glk_..." \
  -F 'anfrage={"abbild":"python","groesse":"S","frist":60}' \
  -F 'code=import pandas as pd
df = pd.read_csv("/mnt/eingaben/umsatz.csv")
df.describe().to_csv("/mnt/ausgabe/auswertung.csv")
print(df["betrag"].sum())' \
  -F dateien=@umsatz.csv

Die Antwort enthält stdout, stderr (je höchstens 64 KiB), exitcode, die Dauer, die abgerechneten Sekunden und alles, was der Code nach /mnt/ausgabe geschrieben hat, als dateien mit Abholadresse (24 Stunden gültig). Bis 60 Sekunden wartet der Aufruf auf das Ergebnis, danach antwortet er mit einer Kennung, die Sie mit GET /api/v1/laufraum/{id}?warten=60 abfragen oder per rueckruf signiert zugestellt bekommen. Die Frist je Ausführung und die Zahl gleichzeitiger Läufe richten sich nach Ihrer Stufe. Mit einem Testschlüssel (glk_test_...) prüft Glieks Ihre Anfrage und antwortet kostenlos mit einer festen Beispielantwort.

Sprachassistent in 20 Zeilen

Audio rein, Antwort als Ton zurück - mit eigener Rolle, eigenem Wissen und den Glieks-Daten als Werkzeug. Der erste Satz klingt schon, während das Modell noch schreibt.

import base64, json, requests

BASIS, SCHLUESSEL = "https://BASIS", "glk_..."
anfrage = {
    "betriebsart": "vollstaendig", "ausgabe": "beides", "format": "mp3",
    "system": "Sie sind die freundliche Auskunft der Stadtbücherei. Antworten Sie in höchstens zwei Sätzen.",
    "kontext": "Öffnungszeiten: Mo-Fr 10-18 Uhr, Sa 10-14 Uhr.",
    "werkzeuge": ["daten"], "gespraech": "kunde-42", "model": "Glieks Flink", "reasoning": "aus",
}
with open("frage.wav", "rb") as f:
    antwort = requests.post(BASIS + "/api/v1/sprachlauf?stream=true", stream=True,
        headers={"Authorization": "Bearer " + SCHLUESSEL},
        files={"audio": f}, data={"anfrage": json.dumps(anfrage)})
ereignis = None
for zeile in antwort.iter_lines(decode_unicode=True):
    if zeile.startswith("event: "):
        ereignis = zeile[7:]
    elif zeile.startswith("data: ") and ereignis == "audio":
        teil = json.loads(zeile[6:])
        open(f"antwort-{teil['nr']}.mp3", "wb").write(base64.b64decode(teil["audio"]))
    elif zeile.startswith("data: ") and ereignis == "fertig":
        print(json.loads(zeile[6:])["timings"])

Mit Ihrem eigenen Modell

Glieks übernimmt nur die Sprachteile: mit "betriebsart": "eigenes_modell" und "rueckruf": "https://ihr-dienst/antwort" geht der erkannte Text signiert an Ihren Endpunkt (Kopfzeilen X-Glieks-Zeit und X-Glieks-Signatur = HMAC-SHA256 über Zeit, Punkt und Rumpf mit dem Signaturgeheimnis des Schlüssels). Ihr Endpunkt antwortet innerhalb von 15 Sekunden mit {"text": "..."}, Glieks spricht die Antwort. Ohne Rückruf: nur Erkennung (Audio, Ausgabe „text“) oder nur Ausgabe (Text, Ausgabe „audio“).

import hashlib, hmac
from flask import Flask, request

app, GEHEIMNIS = Flask(__name__), bytes.fromhex("SIGNATURGEHEIMNIS")

@app.post("/antwort")
def antwort():
    erwartet = hmac.new(GEHEIMNIS, request.headers["X-Glieks-Zeit"].encode() + b"." + request.get_data(), hashlib.sha256).hexdigest()
    if not hmac.compare_digest(erwartet, request.headers["X-Glieks-Signatur"]):
        return "", 401
    return {"text": mein_modell(request.json["text"])}

Modelle und Antwortzeit

Im Feld model wählen Sie aus dem Katalog (Glieks-Name oder Basismodell). reasoning steuert das Nachdenken: aus für die schnellste Antwort, niedrig, hoch für schwierige Fragen. Ohne Angabe nimmt der Sprachlauf ein schnelles Modell, Läufe nehmen das Glieks-Standardmodell. Jede Sprachlauf-Antwort nennt die Zeiten je Stufe in timings (Erkennung, erstes Zeichen des Modells, erstes Audio, gesamt).

Preise

Keine Grundgebühr. Zum Testen schenken wir Ihnen 5 Euro Startguthaben, einmalig je bestätigtem Konto und für alle Endpunkte nutzbar (mindestens 12 Monate gültig, keine Auszahlung). Danach laden Sie Guthaben vorab auf (ab 5 Euro, per Stripe) und zahlen nur, was Sie nutzen. Guthaben gilt 1:1, die Umsatzsteuer kommt beim Aufladen dazu: 5 Euro Guthaben kosten 5,95 Euro inkl. 19 % USt, die Rechnung kommt per E-Mail. Auf Wunsch lädt Glieks automatisch nach, sobald das Guthaben unter Ihre Schwelle fällt - höchstens bis zu Ihrer Monatsgrenze.

5 Centje Datenabruf, für jede Fähigkeit gleich
0,25 Centje Laufraum-Minute
0,9 Centje Audiominute Spracherkennung
0,5 Centje 1 000 Zeichen Sprachausgabe
Festpreisje Skill-Ergebnis

Sprachmodelle: den Preis je Modell, der für Sie gilt, nennt der Katalog GET /v1/models.

Größere Mengen - nach AbspracheViele gleichzeitige Läufe oder höhere Beträge: Schreiben Sie uns an support@glieks.ai.

Testmodus und Fehler

Ein Testschlüssel (glk_test_...) ist kostenlos und antwortet auf jeden schreibenden Aufruf mit einer festen Beispielantwort - ideal für Ihre Tests. Fehler kommen immer in derselben Form: {"code": "...", "grund": "...", "weg": "POST /api/v1/aufgaben"}, zum Beispiel ungueltiger_schluessel (401), guthaben_leer (402), nicht_gefunden (404), rate_begrenzt und ausgelastet (429, mit Retry-After), modell_unbekannt (400, mit der Liste der Modelle).

Ihr KI-Mitarbeiter als Schnittstelle für Ihre Anwendung

Mit der Glieks-API binden Sie Aufträge und Ergebnisse in Ihre eigenen Programme ein. Ihre Anwendung kann Aufgaben starten, den Fortschritt verfolgen und die erzeugten Dateien abrufen.

Aufträge und fertige Ergebnisse

Über die Aufgabenschnittstelle übergeben Sie eine Beschreibung und bei Bedarf Dateien. Der Skill-Katalog bietet definierte Eingaben für wiederkehrende Ergebnisarten, zum Beispiel Dokumente und Auswertungen.

Daten mit Quellenvermerk

Der Datenkatalog beschreibt die abrufbaren Fähigkeiten und ihre Eingabefelder. Datenantworten enthalten Quellenvermerk und Lizenzinformationen. Der jeweilige Katalogeintrag zeigt, welche Daten Sie abrufen können.

Sprache und Sprachmodelle

Nutzen Sie Spracherkennung, Sprachausgabe oder den kombinierten Sprachlauf. Die verfügbaren Modelle finden Sie im Modellkatalog.

Integration nachvollziehbar aufbauen

Die Entwicklerseite zeigt Endpunkte und Aufrufbeispiele. Mit einem Testschlüssel erhalten Sie bei schreibenden Aufrufen feste Beispielantworten, um Ihre Integration vorzubereiten.

Glieks kennenlernen

Sie bauen ein Produkt? Glieks arbeitet auch hinter Ihrer Anwendung - ich zeige Ihnen den Einstieg weiter unten.