Eine API für Transkription, Übersetzung, Untertitel und Analyse
Die meisten Spracherkennungs-APIs liefern nur Rohtext. Die Sonix API gibt ein Transkript zurück, das bereits für alles strukturiert ist, was Sie als Nächstes bauen.
Jede der folgenden Funktionen ist ein dokumentierter Endpunkt. Das abgerufene Transkript wird so zu Untertiteln, einer Übersetzung, einem geschnittenen Audioclip oder einer Zusammenfassung, ohne dass Sie die API verlassen.
Batch-Transkription
Senden Sie eine Datei per POST an /v1/media oder übergeben Sie bei mehr als 100MB eine file_url, und Sonix transkribiert sie asynchron. Legen Sie die Sprache fest, geben Sie keywords mit, um die Erkennung auf Namen und Fachbegriffe auszurichten, hängen Sie custom_data für Ihre eigenen IDs an und setzen Sie eine callback_url, damit Sonix Ihrem Server sofort meldet, wenn der Job abgeschlossen oder fehlgeschlagen ist. Aufnahmen, bei denen jeder Sprecher auf einem eigenen Kanal liegt, können den Multitrack-Endpunkt für die kanalbasierte Sprechererkennung nutzen.
Übersetzung
Sobald ein Transkript fertig ist, senden Sie per POST einen Zielsprachcode an den translations-Endpunkt, und Sonix liefert ein übersetztes Transkript in einer von 54+ Sprachen. Die Transkript-Endpunkte akzeptieren einen language-Parameter: Eine spanische SRT-Datei eines englischen Interviews ist nach Abschluss der Übersetzung also ein einziger GET-Request.
Untertitel und Captions
Die SRT- und VTT-Endpunkte liefern Untertiteldateien mit echten Darstellungsoptionen: max_characters und max_duration begrenzen jeden Untertitel, subtitle_lines legt eine oder zwei Zeilen fest, und speaker_display bestimmt, wie Sprechernamen erscheinen. Der split-Endpunkt bricht ein ganzes Transkript unter einem max_cps-Limit für die Lesegeschwindigkeit in Untertitel um, und der burn-in-Endpunkt rendert die Untertitel direkt ins Video, mit frei wählbarer Schrift, Größe, Farbe und Seitenverhältnis, auch 9:16 und 1:1 für Social-Media-Formate.
Exporte und strukturierte Daten
Rufen Sie jedes Transkript als JSON mit Start- und Endzeit für jedes Wort und Sprecherkennzeichnung ab, als Klartext, als Word-Dokument oder PDF zum Weitergeben, als SRT oder VTT oder als Avid-DS-Datei für den Videoschnitt. Der Medienexport-Endpunkt geht noch einen Schritt weiter: Er schneidet das Audio oder Video selbst auf Ihre Highlights zusammen oder entfernt alles, was Sie durchgestrichen haben, als MP3, WAV oder MP4.
KI-Analyse
Der summarization-Endpunkt analysiert ein fertiges Transkript: eine Zusammenfassung mit der gewünschten Anzahl Sätze, Kapitel, Stimmung, Themen- und Topic-Analyse, Entitätsextraktion oder ein eigener Prompt wie „Schreibe 5 Werbe-Tweets für diesen Podcast“.
Callbacks und Webhooks
Polling-Schleifen sind überflüssig. Medien- und Zusammenfassungsjobs akzeptieren eine callback_url, und Sonix sendet den Jobstatus per POST dorthin, sobald die Arbeit abgeschlossen oder fehlgeschlagen ist. Für Teams, die in großem Umfang automatisieren, bieten die Tarife Pro und Enterprise zusätzlich Event-Webhooks: Abonnieren Sie abgeschlossene Transkriptionen und Übersetzungen, Änderungen an Labels und Ordnern sowie angewendete Schwärzungen. Jedes Event ist mit HMAC-SHA256 in einem X-Webhook-Signature-Header signiert, sodass Ihr Server prüfen kann, dass jeder Payload von Sonix stammt.
Echtzeit-Streaming
Für Live-Untertitel und Speech-to-Text mit geringer Latenz bietet Sonix eine Streaming-API über WebSocket, im Early Access für Enterprise-Teams. Den Zugang beantragen Sie auf der Seite zur Echtzeit-Transkription. Die Batch-Transkription ist heute vollständig dokumentiert und im Self-Service nutzbar.
In drei API-Aufrufen von der Audiodatei zum Transkript
Authentifizieren Sie sich mit einem Bearer-Token gegenüber https://api.sonix.ai/v1, übermitteln Sie die Datei und rufen Sie das Transkript im gewünschten Format ab.
Datei übermitteln
Senden Sie die Mediendatei als Multipart-Formulardaten mit Sprache, Namen und optional keywords und custom_data:
curl -XPOST https://api.sonix.ai/v1/media -H "Authorization: Bearer <API Key>" \
-F file=@my_audio.mp3 \
-F language=en \
-F name='Podcast Episode 45' \
-F keywords='Sonix, Bergamasco, Kairos, Chewbacca' \
-F custom_data='{"internal_id": "123412", "customer_email": "[email protected]"}'Status abfragen oder auf den Callback warten
Fragen Sie das Media-Objekt ab, bis sein Status completed ist, oder überspringen Sie diesen Schritt und warten Sie auf Ihre callback_url:
curl -XGET https://api.sonix.ai/v1/media/qmnY1nD5 -H "Authorization: Bearer <API Key>"Transkript mit Zeitstempeln abrufen
Fordern Sie das JSON-Transkript an oder tauschen Sie die Endung gegen .srt, .vtt oder Klartext:
curl -XGET https://api.sonix.ai/v1/media/qmnY1nD5/transcript.json -H "Authorization: Bearer <API Key>"Mehrsprachige Aufnahme? Setzen Sie language=multi und listen Sie die erwarteten Sprachen in language_hints auf. Die vollständige Parameterreferenz, Response-Bodies und Fehlercodes finden Sie in der API-Dokumentation.