⚙️ 🤖 Mitschrift über zentonic-transcribe: Client für asynchrone API (zpub transcribe) #172
Labels
No labels
Compat/Breaking
Kind/Bug
Kind/Documentation
Kind/Enhancement
Kind/Feature
Kind/Security
Kind/Testing
Priority/Critical
Priority/High
Priority/Low
Priority/Medium
Reviewed/Confirmed
Reviewed/Duplicate
Reviewed/Invalid
Reviewed/Won't Fix
Status/Abandoned
Status/Blocked
Status/Need More Info
Status/Needs-v00-Abnahme
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
Zentonic/zentonic-publisher#172
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
████░░░░░░███████░░░████░░░░░░██░░░░░░░░Auftrag
Holm 2026-11-16: „zentonic-transcribe muss separates projekt werden. das laeuft auf ner ki maschine. da werfen wir was auf dessen api und bekommen auf anfrage irgendwann was zurück. anders gehts nicht.“
Abgrenzung
Vorschlag Publisher-Seite (Schnittstelle wartet auf zentonic-transcribe)
transcript.vttbleibt, neue nur mit--forcebzw. alstranscript.new.vtt.submitmeldet „nicht erreichbar“, Exit ≠ 0, nichts halb geschrieben.Abnahme
Vorschlag API-Vertrag aus Client-Sicht (Eingabe für zentonic-transcribe)
Holm 2026-11-16: Repo
Zentonic/zentonic-transcribefreigegeben (15a, Frage 68 bei thinker00). Was der Publisher als Client braucht — Entscheidung liegt beim neuen Projekt:POST /jobs(multipart: Audio +lang, optionalspeakers)202 {id, status: "queued"}GET /jobs/{id}{id, status: queued|running|done|failed, progress?, error?}GET /jobs/{id}/result.vtt200 text/vtt(WebVTT,<v Sprecher>optional),404solange nicht fertigGET /health200X-Content-SHA256./health, meldet „nicht erreichbar“ und schreibt nichts.docs/episode-format.md„Mitschrift“ (Player #145, Linse #159).Stand Feierabend 2026-11-16
c2604-zentonic-transcribeläuft (thinker00 17:15) und meldet den beschlossenen API-Vertrag per Datei an c2604-zentonic-publisher.Beschluss API-Vertrag v1 (zentonic-transcribe)
Vertrag:
docs/api.mdaufdev(Zentonic/zentonic-transcribe#2, API-Vertrag v1). Dienst läuft lokal (Zentonic/zentonic-transcribe#3, Dienst-Gerüst): echter Lauf über die API, Podcast-MP3 9:21 min / 10 MB → VTT in 49 s (whisper.cpp Vulkan, large-v3-turbo, c1b1).Übernommen aus dem Vorschlag
POST /v1/jobs→202 {id, status: "queued", …},GET /v1/jobs/<id>,GET /v1/jobs/<id>/result.vtt,GET /v1/health(ohne Auth)X-Content-SHA256: gleiche Datei + Sprache + Sprecher → gleiche Job-ID (200,"duplicate": true)Authorization: Bearer), Client-Name steht im JobAbweichungen (mit Grund)
curl --data-binary @datei404solange nicht fertig409 not_ready,Retry-After: 60404heißt „Job unbekannt“lang?language=(Vorgabede,auto)speakers(Diarisierung)?speaker=<Name>je Spur, Cues mit<v Name>progress?positionin der WarteschlangeZusätzlich:
result.json(Segmente),result.txt,GET /v1/jobs?status=…&ref=…,DELETE /v1/jobs/<id>,?ref=als freier Bezug (z. B.zentonic/<slug>), Fehlerformat{"error": {"code", "message"}}.VTT:
WEBVTT, ZeitmarkenHH:MM:SS.mmm, ein Cue je Segment; passt zudocs/episode-format.md„Mitschrift“.Für die Client-Entwicklung
Dienst ohne Modell (
ZT_BACKEND=dummy, ein Dummy-Segment je 5 s) undtools/smoke.shals curl-Referenz: README im Repo, Abschnitt „Aufruf“. Offen auf Dienstseite: Phantomtext bei Musik-Intro/Outro (Zentonic/zentonic-transcribe#4, Whisper-Halluzinationen), KI-Maschine als Host (Zentonic/zentonic-transcribe#1, EPIC).Dienst läuft: zentonic-transcribe v0.1.0 auf c1b1
Holm 1c: c1b1 ist Übergangs-Host, bis die KI-Maschine steht (Zentonic/zentonic-transcribe#5, c1b1 als Übergangs-Host).
http://127.0.0.1:8765(nur lokal auf c1b1),/v1/healthzeigt"build": "v0.1.0"PASSWORD_STORE_DIR=/home/holm/.zenagent-store pass show zentonic/transcribe-token-publisher(Maschinen-Store, ohne Passphrase); Client-Name im Job:publisher