Gecontroleerd door Stephen Hopkins, CTOEén API voor transcriptie, vertaling, ondertitels en analyse
De meeste spraakherkennings-API's houden op bij ruwe tekst, terwijl de Sonix API een transcript teruggeeft dat al gestructureerd is voor alles wat u daarna bouwt.
Elke functie hieronder is een gedocumenteerd endpoint, dus het transcript dat u ophaalt kan ondertitels, een vertaling, een bewerkt audiofragment of een samenvatting worden zonder de API te verlaten.
Batchtranscriptie
POST een bestand naar /v1/media, of geef een file_url mee voor alles boven 100MB, en Sonix transcribeert het asynchroon. Stel de taal in, voeg keywords toe om de herkenning naar namen en vakjargon te sturen, koppel custom_data voor uw eigen ID's en geef een callback_url op, zodat Sonix uw server laat weten zodra de job klaar of mislukt is. Voor opnames waarin elke spreker op een eigen kanaal staat, kunt u het multitrack-endpoint gebruiken voor sprekerdetectie per kanaal.
Vertaling
Is een transcript klaar, POST dan een doeltaalcode naar het translations-endpoint ervan en Sonix levert een vertaald transcript in een van de 54+ talen. De transcript-endpoints accepteren een language-parameter, dus een Spaans SRT-bestand van een Engelstalig interview is één GET-request zodra de vertaling klaar is.
Ondertitels en captions
De SRT- en VTT-endpoints leveren ondertitelbestanden met echte opmaakopties: max_characters en max_duration begrenzen elke ondertitel, subtitle_lines stelt één of twee regels in en speaker_display bepaalt hoe sprekersnamen verschijnen. Het split-endpoint deelt een volledig transcript opnieuw in ondertitels in binnen een leessnelheidslimiet via max_cps, en het burn-in-endpoint brandt de ondertitels in de video zelf, met het lettertype, de grootte, de kleur en de beeldverhouding van uw keuze, inclusief 9:16 en 1:1 voor social media.
Exports en gestructureerde data
Haal elk transcript op als JSON met begin- en eindtijden voor elk woord en sprekerlabels, als platte tekst, als Word-document of PDF om te delen, als SRT of VTT, of als Avid DS-bestand voor video-editors. Het media-export-endpoint gaat nog een stap verder: het knipt de audio of video zelf terug tot uw highlights, of haalt alles weg wat u hebt doorgestreept, als MP3, WAV of MP4.
AI-analyse
Het summarization-endpoint voert analyses uit op een afgerond transcript: een samenvatting met het aantal zinnen dat u kiest, hoofdstukken, sentiment, thema- en onderwerpanalyse, entiteitsextractie of een eigen prompt, zoals "Schrijf 5 promotionele tweets voor deze podcast".
Callbacks en webhooks
Geen polling-loops nodig. Media- en summarization-jobs accepteren een callback_url, en Sonix POST de jobstatus daarnaartoe zodra het werk klaar of mislukt is. Voor teams die op grote schaal automatiseren, voegen de Pro- en Enterprise-abonnementen event-webhooks toe: abonneer u op transcriptie voltooid, vertaling voltooid, wijzigingen in labels en mappen en toegepaste redactie, elk ondertekend met HMAC-SHA256 in een X-Webhook-Signature-header, zodat uw server kan controleren dat elke payload van Sonix komt.
Realtime streaming
Voor live ondertiteling en spraak-naar-tekst met lage latency biedt Sonix een streaming-API via WebSocket, in early access voor enterprise-teams; vraag toegang aan op de pagina over realtime transcriptie. Batchtranscriptie is vandaag al volledig gedocumenteerd en zelf in te richten.
Van audiobestand naar transcript in drie API-calls
Authenticeer met een Bearer-token tegen https://api.sonix.ai/v1, verstuur het bestand en haal het transcript op in het formaat dat u nodig hebt.
Verstuur het bestand
Stuur de media als multipart form data mee met de taal, een naam en optioneel keywords en 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]"}'Controleer de status of wacht op de callback
Poll het media-object tot de status completed is, of sla deze stap over en wacht op uw callback_url:
curl -XGET https://api.sonix.ai/v1/media/qmnY1nD5 -H "Authorization: Bearer <API Key>"Haal het transcript met tijdstempels op
Vraag het JSON-transcript op, of vervang de extensie door .srt, .vtt of platte tekst:
curl -XGET https://api.sonix.ai/v1/media/qmnY1nD5/transcript.json -H "Authorization: Bearer <API Key>"Een meertalige opname? Stel language=multi in en zet de verwachte talen in language_hints. De volledige parameterreferentie, response bodies en foutcodes staan in de API-documentatie.
