6 Min. Lesezeit Integrations

Transkriptions-API: Überblick, Authentifizierung und Limits

Q: Kann ich die Datei direkt statt per URL senden?

Der Hauptweg ist audio_url . Wenn deine Audiodateien keine öffentliche URL haben, wende dich an den Support, um den besten Ablauf für deinen Fall zu prüfen.

Q: Gibt es eine OpenAPI-Dokumentation?

Die öffentliche Spezifikation unter /.well-known/openapi.json deckt derzeit nur die öffentlichen Endpunkte ab (Statistiken und geteilte Transkriptionen). Für den Rest nutze dieses Helpcenter und den Support.

So verwendest du die VoxScriber-REST-API: wer Zugriff hat, wie vpt_live_-Schlüssel funktionieren, Bearer-Authentifizierung, Anfragelimits und Abrechnung in Zyklen.

Die REST-API von VoxScriber ermöglicht es dir, Audiodateien per URL zu senden und die fertige Transkription direkt in deinem System zu erhalten – ohne Umweg über die Website. Sie nutzt dieselben Engines und berechnet dieselben Zyklen wie Transkriptionen im Dashboard.

Wer sie nutzen kann

Die API ist ab dem Plan Profissional (R$ 39,90/Monat) freigeschaltet. Zugriff haben: Profissional, Premium, alle Enterprise-Pläne (monatlich und jährlich) sowie die entsprechenden Legacy-Pläne. Wenn dein Konto nicht berechtigt ist, geben die Schlüssel-Routen den Fehler 403 PLAN_NOT_ELIGIBLE zurück.

API-Schlüssel

Schlüssel erstellen

Pro Konto können bis zu 20 aktive Schlüssel existieren, jeder mit einem Identifikationsnamen.

Kopiere das Secret sofort

Der Schlüssel hat das Format vpt_live_... und wird nur einmal angezeigt, direkt bei der Erstellung. Wir speichern nur einen Hash davon – eine spätere Wiederherstellung ist nicht möglich.

Bewahre ihn sicher auf

Speichere ihn in einer Umgebungsvariable oder einem Secret-Manager. Gib den Schlüssel niemals in Versionskontrolle.

Schlüssel verloren? Es gibt keine Möglichkeit, ihn erneut anzuzeigen. Widerrufe den alten Schlüssel und erstelle einen neuen. Kompromittierte Schlüssel müssen sofort widerrufen werden.

Für die Erstellung persönlicher Schlüssel gibt es noch keinen eigenen Bereich im Dashboard. Wenn dein Plan berechtigt ist und du die API nutzen möchtest, eröffne ein Ticket – das Team aktiviert den Zugang mit dir zusammen.

Authentifizierung

Jede Anfrage enthält den Schlüssel im Authorization-Header:

Authorization: Bearer vpt_live_SUA_CHAVE

Eine Anfrage ohne diesen Header gibt 401 MISSING_API_KEY zurück.

Ein Audio zur Transkription senden

Der Transkriptions-Endpoint liegt auf dem Gateway api.voxscriber.com:

curl -X POST https://api.voxscriber.com/v1/transcriptions \
  -H "Authorization: Bearer vpt_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://exemplo.com/gravacoes/reuniao.mp3",
    "webhook_url": "https://seusistema.com/webhooks/vozparatexto",
    "formats": ["txt", "srt"]
  }'

Akzeptierte Felder im Body: audio_url, webhook_url, engine (ASSEMBLYAI, WHISPER oder ELEVENLABS), language, formats (txt, json, srt, vtt, docx, pdf), metadata und idempotency_key. Das Ergebnis wird an deine webhook_url gesendet – siehe Webhooks und Benachrichtigungen.

Verwende idempotency_key mit einer eigenen Kennung (z. B. der ID der Aufnahme in deinem System). Wenn dieselbe Anfrage versehentlich erneut gesendet wird, wird das Audio nicht doppelt verarbeitet – und auch nicht doppelt abgerechnet.

Limits

Limit	Wert
Anfragen pro Schlüssel	60 pro Minute
Per URL heruntergeladenes Audio	bis zu 500 MB (Timeout 60 s)
Audio per Passthrough (Premium-Engine liest die URL direkt)	bis zu 5 GB
Aktive Schlüssel pro Konto	20

Sicherheitsregeln für URLs: nur https, keine Weiterleitungen, und interne/private Adressen sind blockiert. Die Audio-URL muss öffentlich erreichbar sein.

Die verfügbaren Exportformate folgen der Freischaltung deines Plans – genau wie auf der Website. Formate außerhalb deines Plans werden in exports_skipped aufgeführt.

Abrechnung

Die API belastet die gleichen Zyklen wie eine Transkription auf der Website, abhängig von der gewählten Engine (Standard/Whisper: 1 Zyklus/min; Premium: 4 Zyklen/min; Ultra: 10 Zyklen/min). Es gibt derzeit weder ein monatliches Anfragenkontingent noch ein Ausgabenlimit pro Schlüssel – kontrolliere den Verbrauch über dein Zyklusguthaben. Siehe Zyklussystem.

FAQ

Ich habe meinen API-Schlüssel verloren. Wie kann ich ihn wiederherstellen?

Er kann nicht wiederhergestellt werden – in der Datenbank liegt nur der Hash. Widerrufe den verlorenen Schlüssel und erstelle einen neuen.

Kostet die API mehr als die Website?

Nein. Der Zykluspreis ist identisch und richtet sich nach der Engine und der Audiodauer.

Kann ich die Datei direkt statt per URL senden?

Der Hauptweg ist audio_url. Wenn deine Audiodateien keine öffentliche URL haben, wende dich an den Support, um den besten Ablauf für deinen Fall zu prüfen.

Gibt es eine OpenAPI-Dokumentation?

Die öffentliche Spezifikation unter /.well-known/openapi.json deckt derzeit nur die öffentlichen Endpunkte ab (Statistiken und geteilte Transkriptionen). Für den Rest nutze dieses Helpcenter und den Support.