4 Min. Lesezeit Uploading Files

Audio per URL und über die API senden

So importierst du Audio per direkter URL in der Oberfläche und sendest Transkriptionen programmatisch über die API: berechtigte Tarife, Schlüssel, Authentifizierung, Limits und Webhooks.

Neben dem Datei-Upload gibt es zwei Wege „ohne Datei in der Hand“: eine Medien-URL in der Oberfläche einfügen (für alle Nutzer) und über die API senden (für Profissional-Tarife und höher) – ideal, um die Transkription in Systeme, PABX und Automatisierungen zu integrieren.

1. Per URL in der Oberfläche importieren

Auf dem Bildschirm Neue Transkription akzeptiert dieselbe Option, die YouTube akzeptiert, auch direkte URLs von Audio-/Videodateien (https). Der Server lädt die Medien herunter und folgt dem normalen Ablauf: Sprachwahl (oder automatische Erkennung), Motor des Tarifs und Kosten in Zyklen nach Dauer. Die Dauer- und Größenbegrenzungen deines Tarifs gelten gleichermaßen.

2. Transkriptions-API

Wer kann sie nutzen?

Die API ist ab dem Tarif Profissional (R$ 39,90/Monat) verfügbar – einschließlich Premium, Business- und gleichwertigen Legacy-Tarifen. Bei anderen Tarifen gibt die Schlüsselerstellung zurück, dass der Tarif nicht berechtigt ist.

API-Schlüssel

Token-Format: vpt_live_...;
Das Secret wird nur einmal bei der Erstellung angezeigt – bewahre es in einem Tresor auf. Wir speichern das Secret nicht, nur einen Fingerabdruck davon;
Bis zu 20 aktive Schlüssel pro Konto; du kannst jeden jederzeit widerrufen;
Die persönliche Schlüsselverwaltung in der Oberfläche befindet sich im Aufbau – falls du die Option in deinem Konto nicht findest, öffne ein Ticket und wir aktivieren sie für dich.

Wie ein Aufruf funktioniert

Authentifizierung über den Header Authorization: Bearer vpt_live_.... Im Body gibst du die Audio-URL (audio_url, nur https), die URL deines Webhooks zum Empfangen des Ergebnisses und optional Motor, Sprache, Exportformate und Idempotenz-Schlüssel an.

Rate-Limit: 60 Anfragen pro Minute pro Schlüssel;
Größe: Audio per URL bis zu 500 MB für den Download auf dem Server; mit dem Premium-Motor können URLs bis zu 5 GB direkt vom Motor gelesen werden, ohne Zwischendownload;
Kosten: dieselben Zyklen wie auf der Website, je nach Dauer und Motor.

Ergebnis empfangen (Webhooks)

Das Ergebnis wird per Webhook gesendet, signiert mit HMAC-SHA256 (Header X-VPT-Signature und X-VPT-Event) – validiere die Signatur, bevor du dem Payload vertraust. Falls dein Endpoint nicht erreichbar ist, senden wir mit progressivem Backoff erneut: bis zu 6 Versuche über ~24 Stunden.

Wir akzeptieren nur https-URLs und blockieren aus Sicherheitsgründen interne/private Adressen. Wenn dein Audio hinter einer Authentifizierung liegt, erstelle vor dem API-Aufruf eine temporär signierte URL in deinem Storage.

Keine öffentliche URL für die Datei (z. B. PABX-Aufnahmen)? Die Enterprise-Audit-API bietet einen Upload-Endpoint, der eine temporäre Upload-URL zurückgibt (1 Stunde gültig) – sprich mit dem Vertrieb, wenn du Anrufaudit in großem Umfang brauchst.

Häufig gestellte Fragen

Ich habe das Schlüssel-Secret verloren. Wie kann ich es wiederherstellen?

Es ist nicht wiederherstellbar – widerrufe den Schlüssel und erstelle einen neuen. Das Secret existiert nur im Moment der Erstellung.

Gibt es eine Dokumentation für die API?

Die vollständige Integrationsreferenz wird zusammen mit der Aktivierung des Zugriffs bereitgestellt. Öffne ein Ticket und nenne deinen Anwendungsfall.

Kann ich Motor und Sprache beim Aufruf wählen?

Ja, beide sind optionale Parameter – ohne sie gelten der Standard-Motor des Tarifs und die Spracherkennung.

Kostet die API anders als die Website?

Nein. Dieselben Zyklen, dieselben Regeln (einschließlich Rabatt nur nach Erfolg).

Wie widerrufe ich einen kompromittierten Schlüssel?

Widerrufe ihn sofort in der Schlüsselverwaltung (oder über den Support). Der Widerruf unterbricht den Zugang sofort.