Diktat

Diktat · von Holdenried Solutions

Programmierschnittstelle: Audio rein, Text raus

Diktat lässt sich in eigene Werkzeuge einbinden. Du erzeugst im Konto einen Schlüssel, schickst Audio an /api/v1/transkription und bekommst Text zurück — auf Wunsch geglättet. Diese Seite ist ohne Konto lesbar.

Anmeldung

Der Schlüssel gehört in den Authorization-Kopf als Bearer. Er beginnt mit dkt_ und wird beim Erzeugen genau einmal angezeigt; gespeichert wird nur sein Hash. Er wird aus der Umgebungsvariable DIKTAT_SCHLUESSEL gelesen, nie fest in den Quelltext geschrieben.

Der Anfragekörper

{
  "audio_base64": "…",
  "mime": "audio/wav",
  "sprache": "de",
  "glaetten": true
}

curl (Linux, macOS)

# 1. Schlüssel in die Umgebung (nicht ins Repo, nicht in den Quelltext)
export DIKTAT_SCHLUESSEL='dka_…'

# 2. Testaufruf: muss "ok": true liefern
curl -fsS -H "Authorization: Bearer $DIKTAT_SCHLUESSEL" https://diktat.h-ried.com/api/anbindung/ich

# 3. Erkennen und glätten (auf macOS: base64 -i aufnahme.wav | tr -d '\n')
curl -fsS -X POST https://diktat.h-ried.com/api/v1/transkription \
  -H "Authorization: Bearer $DIKTAT_SCHLUESSEL" -H 'Content-Type: application/json' \
  -d '{"audio_base64":"'"$(base64 -w0 aufnahme.wav)"'","mime":"audio/wav","sprache":"de","glaetten":true}'

Node

// DIKTAT_SCHLUESSEL steht in der Umgebung: process.env.DIKTAT_SCHLUESSEL
const fs = require('node:fs');
const antwort = await fetch('https://diktat.h-ried.com/api/v1/transkription', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.DIKTAT_SCHLUESSEL}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    audio_base64: fs.readFileSync('aufnahme.wav').toString('base64'),
    mime: 'audio/wav',
    sprache: 'de',
    glaetten: true,
  }),
});
console.log(await antwort.json());

Python

import base64, json, os, urllib.request

schluessel = os.environ['DIKTAT_SCHLUESSEL']
with open('aufnahme.wav', 'rb') as datei:
    audio = base64.b64encode(datei.read()).decode()

koerper = json.dumps({
    'audio_base64': audio,
    'mime': 'audio/wav',
    'sprache': 'de',
    'glaetten': True,
}).encode()
anfrage = urllib.request.Request(
    'https://diktat.h-ried.com/api/v1/transkription',
    data=koerper,
    headers={'Authorization': f'Bearer {schluessel}', 'Content-Type': 'application/json'},
)
print(urllib.request.urlopen(anfrage).read().decode())
# Mit "requests" statt urllib (pip install requests): requests.post(URL, headers={...}, json={...})

Endpunkte

AufrufWas er liefert
POST /api/v1/transkriptionAudio rein, Text raus (optional geglättet)
GET /api/v1/kontingentFair-Use-Stand, Glättungs-Freischaltung, Guthaben, Preise
GET /api/v1/glossardas Fachwörter-Verzeichnis, das jede Erkennung als Kontext bekommt
GET /api/v1/ichzu welchem Konto der Schlüssel gehört
GET /api/anbindung/ichzu welcher Anbindung ein dka_…-Schlüssel gehört

Fehlercodes

HTTPCodeWas er bedeutet
401anbindung-widerrufen / —Der Schlüssel fehlt, ist falsch oder wurde widerrufen. Im Konto einen neuen Schlüssel erzeugen.
402guthaben_zu_geringDas Guthaben reicht für das Glätten nicht. Der Rohtext kommt trotzdem mit.
403anbindung-pausiert / konto-nicht-freigeschaltetDie Anbindung ist pausiert oder das Konto wartet auf die Freischaltung.
429anbindung-deckel / fairuseTagesdeckel oder Fair-Use-Grenze erreicht. Zurückgesetzt wird um 00:00 UTC.

Stand: