Kalima REST API v1
Authentifizieren Sie sich mit einem API-Schlüssel, lesen Sie Sitzungen und Transkripte und reichen Sie Audiodateien zur Transkription ein.
Die Kalima REST API ist in Pro, Team und Enterprise verfügbar. Eine Integration kann damit gespeicherte Sitzungen und Transkripte lesen oder eine Audiodatei zur Transkription im Hintergrund einreichen.
API-Schlüssel können derzeit noch nicht selbst in den Kontoeinstellungen erstellt werden. Wenden Sie sich an den Support, um einen Schlüssel für ein berechtigtes Konto anzufordern. Bewahren Sie ihn sicher auf, denn das Geheimnis wird nur einmal angezeigt.
Authentifizierung und Berechtigungen
Senden Sie den Schlüssel bei jeder Anfrage als Bearer-Token:
Authorization: Bearer kal_xxxxxxxxxxxxxxxxxxxx
Mit read können Sie Sitzungen auflisten und Transkripte abrufen. Ergänzen Sie write nur, wenn die Integration Audiodateien einreichen muss. Schlüssel sind an das erstellende Konto gebunden. Antworten enthalten nur Sitzungen, die diesem Konto gehören.
Endpunkte
Basis-URL: https://meetkalima.com/api/v1
| Methode und Pfad | Zweck |
|---|---|
GET /sessions | Gespeicherte Sitzungen mit Seitennavigation auflisten |
GET /sessions/{id} | Eine Sitzung lesen |
GET /sessions/{id}/transcript | Transkriptsegmente lesen |
POST /transcriptions | Audio hochladen und Transkription einreihen |
GET /openapi.json | Maschinenlesbaren OpenAPI-Vertrag laden |
Audio einreichen
Senden Sie multipart/form-data mit einem Feld namens file. Optional können Sie durationMs ergänzen.
curl -X POST "https://meetkalima.com/api/v1/transcriptions" \
-H "Authorization: Bearer kal_xxx" \
-F "file=@meeting.mp3"
Die Antwort enthält sessionId, jobId und den Status queued. Fragen Sie GET /sessions/{id}/transcript ab, bis Transkriptsegmente erscheinen. Die transkribierte Dauer wird vom Transkriptionsguthaben des Schlüsselinhabers abgezogen.
Fehler und Limits
Ein fehlender oder ungültiger Schlüssel führt zu 401. Eine fehlende Berechtigung oder ein ungeeigneter Tarif führt zu 403. Wird das API-Anfragelimit des Tarifs überschritten, folgt 429. Widerrufen Sie einen Schlüssel sofort, falls er offengelegt worden sein könnte.