diarization-ui/doc/interfaces.md

Externe Schnittstellen

Transcription-API (API_BASE)

Wird für Audio-/Videotranskription mit Diarisierung verwendet.

Standard-URL: http://gx10.aquantico.lan:8093

POST /transcribe-diarize

Upload der Mediendatei als multipart/form-data.

Request:

Content-Type: multipart/form-data
field: file  (binary, application/octet-stream)

Unterstützte Formate: alle gängigen Audio- und Videoformate (MP3, WAV, M4A, OGG, MP4, MKV, MOV, …). Die API extrahiert den Audiotrack selbst.

Response (JSON):

{
  "formatted_text": "Speaker 1: Hallo...\nSpeaker 2: ...",
  ...
}

Das Feld formatted_text wird als Markdown-Inhalt des transcript-Dokuments gespeichert. Die vollständige JSON-Antwort landet in documents.raw_json.

Timeout: 1800 s (30 Minuten, für lange Aufnahmen)

---

Ollama (OLLAMA_BASE_URL)

Wird für die LLM-Analyse von Transkripten verwendet.

Standard-URL: http://gx10.aquantico.lan:11434

POST /api/generate

Request (JSON):

{
  "model": "qwen3.5:9b",
  "prompt": "...",
  "stream": true,
  "think": true,
  "options": {
    "num_ctx": 16384,
    "num_predict": 16384,
    "repeat_penalty": 1.15,
    "repeat_last_n": 128
  }
}

• stream: true — Antwort wird zeilenweise als JSON-Objekte gestreamt
• think — aktiviert Extended Thinking / Chain-of-Thought (modellabhängig)
• num_ctx — wird dynamisch berechnet (_estimate_num_ctx) oder aus den Einstellungen gelesen
• Alle options-Parameter sind über die Einstellungsseite oder pro Prompt konfigurierbar

Response (NDJSON-Stream):

{"response": "Teil der Antwort", "thinking": "...", "done": false}
...
{"response": "", "done": true, "total_duration": ...}

Chunks werden in _JOB_STREAMS[job_id] gepuffert für die Live-Anzeige auf der Jobs-Seite.

Timeout: 1200 s

GET /api/tags

Wird von GET /settings/models aufgerufen, um verfügbare Modelle zu listen.

Response (JSON):

{
  "models": [
    { "name": "qwen3.5:9b", ... },
    ...
  ]
}

Timeout: 5 s

---

KI-Einstellungen (Prioritäten)

Beim Analyse-Job gelten folgende Prioritäten für die LLM-Parameter:

Prompt-spezifische Einstellungen (llm_use_default=0)
  → Werte aus prompts.llm_* Spalten
Globale Einstellungen (llm_use_default=1, Standard)
  → Werte aus der settings-Tabelle
Fallback
  → Umgebungsvariablen (OLLAMA_MODEL, OLLAMA_THINK, …)