API DocsTranskription
Transkription
Audio-Dateien transkribieren, Job-Status abfragen und Dokumente exportieren.
Audio-Dateien transkribieren, Job-Status abfragen und Dokumente exportieren.
Wandle Audio- und Videodateien in Text um — mit optionaler Sprechererkennung.
/api/transcribeMP3, MP4, WAV, M4A, WEBM, OGG — bis zu 100 MB pro Datei.
Upload per multipart/form-data mit optionalen Konfigurationsparametern.
| Parameter | Type | Description |
|---|---|---|
filerequired | File | Die Audio- oder Videodatei zum Transkribieren. |
language | string | Sprache der Aufnahme für bessere Erkennung. |
speaker_detection | boolean | Sprechererkennung aktivieren (true/false). |
anonymize | boolean | Transkript nach der Verarbeitung automatisch anonymisieren |
Die initiale Antwort enthält die Job-ID und den Status 'processing'.
{
"job_id": "job_abc123def456",
"status": "processing",
"created_at": "2025-01-15T10: 30: 00Z"
}Rufe den Status-Endpunkt ab, um die fertige Transkription zu erhalten.
{
"job_id": "job_abc123def456",
"status": "completed",
"result": {
"text": "Good morning, welcome to the meeting. Let us begin with the quarterly review...",
"duration_seconds": 342,
"language": "en",
"segments": [
{
"speaker": "Speaker 1",
"start": 0,
"end": 3.2,
"text": "Good morning, welcome to the meeting."
},
{
"speaker": "Speaker 2",
"start": 3.5,
"end": 7.1,
"text": "Let us begin with the quarterly review."
}
]
}
}Sprechererkennung
Mit dem anonymize-Parameter wird das Transkript nach der Verarbeitung automatisch durch die Anonymisierungs-Pipeline geschickt. Personennamen, Orte und andere sensible Daten werden erkannt und durch Platzhalter ersetzt.
1curl -X POST https://app.anymize.ai/api/transcribe \2 -H #86efac">"Authorization: Bearer YOUR_API_KEY" \3 -F #86efac">"file=@meeting.mp3" \4 -F #86efac">"language=de" \5 -F #86efac">"speaker_detection=true" \6 -F #86efac">"anonymize=true"Anonymisierung + Transkription
1curl -X POST https://app.anymize.ai/api/transcribe \2 -H #86efac">"Authorization: Bearer YOUR_API_KEY" \3 -F #86efac">"file=@meeting-recording.mp3" \4 -F #86efac">"language=en" \5 -F #86efac">"speaker_detection=true"Frage den aktuellen Status eines asynchronen Jobs ab.
/api/status/{jobId}| Parameter | Type | Description |
|---|---|---|
jobIdrequired | string | Die Job-ID, die du beim Erstellen des Jobs erhalten hast. |
Ein Job durchläuft folgende Zustände:
{
"job_id": "job_abc123def456",
"status": "processing",
"progress": 45,
"created_at": "2025-01-15T10: 30: 00Z"
}Bei abgeschlossenem Job enthält die Antwort das Ergebnis.
{
"job_id": "job_abc123def456",
"status": "completed",
"result": {
"text": "The anonymized document content...",
"entities_found": 12,
"processing_time_ms": 2340
},
"created_at": "2025-01-15T10: 30: 00Z",
"completed_at": "2025-01-15T10: 30: 04Z"
}{
"job_id": "job_abc123def456",
"status": "failed",
"error": {
"message": "Unsupported file format",
"code": "invalid_format"
},
"created_at": "2025-01-15T10: 30: 00Z"
}Frage den Status in regelmäßigen Abständen ab, bis der Job fertig ist.
Tipp
1# Poll every 3 seconds until completed2while true; do3 RESULT=$(curl -s https://app.anymize.ai/api/status/job_abc123def456 \4 -H #86efac">"Authorization: Bearer YOUR_API_KEY")5 STATUS=$(echo $RESULT | jq -r #86efac">'.status')6 echo #86efac">"Status: $STATUS"7 if [ #86efac">"$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then8 echo $RESULT | jq .9 break10 fi11 sleep 312doneExportiere abgeschlossene Transkriptionen in verschiedenen Formaten.
/api/v1/jobs/{jobId}/exportGib Job-ID, Format und optional eine Variante an.
| Parameter | Type | Description |
|---|---|---|
jobIdrequired | string | Die Job-ID der abgeschlossenen Transkription. |
format | string | Ausgabeformat: pdf, docx oder txt. |
textType | string | Variante des Exports (z.B. anonymisiert oder original). |
pdfPDF — Formatiertes Dokument mit Layout und Metadaten.docxDOCX — Bearbeitbares Word-Dokument.txtTXT — Reiner Text ohne Formatierung.Der Download enthält passende Content-Type- und Content-Disposition-Header.
Content-Type: application/pdf
Content-Disposition: attachment; filename="document_anonymized.pdf"
Content-Length: 245832Wähle zwischen der originalen und der anonymisierten Version.
Tipp
1curl -OJ https://app.anymize.ai/api/v1/jobs/job_abc123def456/export?format=pdf \2 -H #86efac">"Authorization: Bearer YOUR_API_KEY"1curl -OJ #86efac">"https://app.anymize.ai/api/v1/jobs/job_abc123def456/export?format=docx&textType=original" \2 -H #86efac">"Authorization: Bearer YOUR_API_KEY"Typische Fehler beim Export und deren Ursachen.
{
"error": {
"message": "Job not found or not yet completed",
"type": "not_found",
"code": "job_not_found"
}
}