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
| Aufruf | Was er liefert |
|---|---|
| POST /api/v1/transkription | Audio rein, Text raus (optional geglättet) |
| GET /api/v1/kontingent | Fair-Use-Stand, Glättungs-Freischaltung, Guthaben, Preise |
| GET /api/v1/glossar | das Fachwörter-Verzeichnis, das jede Erkennung als Kontext bekommt |
| GET /api/v1/ich | zu welchem Konto der Schlüssel gehört |
| GET /api/anbindung/ich | zu welcher Anbindung ein dka_…-Schlüssel gehört |
Fehlercodes
| HTTP | Code | Was er bedeutet |
|---|---|---|
| 401 | anbindung-widerrufen / — | Der Schlüssel fehlt, ist falsch oder wurde widerrufen. Im Konto einen neuen Schlüssel erzeugen. |
| 402 | guthaben_zu_gering | Das Guthaben reicht für das Glätten nicht. Der Rohtext kommt trotzdem mit. |
| 403 | anbindung-pausiert / konto-nicht-freigeschaltet | Die Anbindung ist pausiert oder das Konto wartet auf die Freischaltung. |
| 429 | anbindung-deckel / fairuse | Tagesdeckel oder Fair-Use-Grenze erreicht. Zurückgesetzt wird um 00:00 UTC. |
Stand: