Zum Hauptinhalt springen

Wie du eine Aufnahme zur Transkription hochlädst

Du kannst Sally eine Datei geben, die woanders aufgenommen wurde, und bekommst Transkript und Zusammenfassung zurück, genau wie bei einem aufgezeichneten Meeting. Es gibt zwei Wege, je nachdem, wo die Datei liegt.

Vorher lesen

Lies zuerst den Schnellstart und Limits und Fair Usage.

Schnellnavigation

  1. Die Datei ist per URL erreichbar
  2. Du hast die Datei selbst
  3. Formate, Größe und Kontingent

1. Die Datei ist per URL erreichbar​

Ein Aufruf genügt. Sally holt die Datei serverseitig ab und startet Transkription und Zusammenfassung:

POST /v1.0/directories/{directoryId}/recordings/from-url

{ "url": "https://files.example.com/weekly.mp4", "name": "Wochenmeeting" }

Die URL muss https nutzen, darf keine Zugangsdaten enthalten, muss auf einen öffentlichen Host zeigen und darf nicht weiterleiten. Gib also die endgültige Adresse an. Der Aufruf kehrt zurück, sobald die Aufnahme existiert, die Transkription läuft danach im Hintergrund.

Referenz: POST/v1.0/directories/{directoryId}/recordings/from-url

2. Du hast die Datei selbst​

  1. Upload anfragen. Du bekommst eine uploadId, eine uploadUrl und die requiredHeaders, die dazugehören. Das Transkriptionskontingent wird schon hier geprüft, eine Ablehnung kostet dich also nichts.
POST /v1.0/directories/{directoryId}/recordings/uploads

{ "fileName": "weekly.mp4", "mimeType": "video/mp4", "sizeBytes": 184320000 }
  1. Datei hochladen, per PUT direkt an die uploadUrl und mit den Headern, die du bekommen hast. Diese Anfrage läuft nicht über die Sally API.
  2. Upload abschließen. Erst jetzt entsteht die Aufnahme und die Transkription startet. Optional gibst du languageCode, speakerCount oder eine appointmentId mit.
POST /v1.0/directories/{directoryId}/recordings/uploads/{uploadId}/finalize
Wichtig

Schritt 3 zu überspringen ist der klassische Fehler. Die Datei liegt dann zwar da, aber es entsteht keine Aufnahme. Also taucht in Sally nichts auf und es wird nichts transkribiert.

3. Formate, Größe und Kontingent​

Unterstützt werden Videodateien (mp4, mkv, avi, mov, webm) und Audiodateien (mp3, wav, flac, ogg, amr, m4a, opus, aac) bis jeweils 5 GB. Für die Transkription gilt außerdem eine Fair-Usage-Regel:

  • Ist das Kontingent aufgebraucht, antwortet schon die Upload-Anfrage mit 429 und code gleich FUP_LIMIT_EXCEEDED.
  • Laufen zu viele Transkriptionen deines Unternehmenskontos gleichzeitig, antworten das Abschließen oder der URL-Import mit 429 und code gleich TOO_MANY_CONCURRENT_TRANSCRIPTIONS.
Empfehlung

Behandle diese beiden Codes getrennt von einem gewöhnlichen Rate-Limit. Kurz zu warten hilft beim Rate-Limit und bei gleichzeitigen Transkriptionen, beim aufgebrauchten Kontingent aber nicht.

Um zu erfahren, wann das Transkript fertig ist, fragst du die Aufnahme regelmäßig ab oder registrierst einen Webhook.