Transkription

Endpunkt

Wandle Audio- und Videodateien in Text um — mit optionaler Sprechererkennung.

Unterstützte Formate

MP3, MP4, WAV, M4A, WEBM, OGG — bis zu 100 MB pro Datei.

Parameter

Upload per multipart/form-data mit optionalen Konfigurationsparametern.

Antwort

Die initiale Antwort enthält die Job-ID und den Status 'processing'.

{
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "processing",
  "message": "Audio submitted for transcription. Use /api/status/{job_id} to check status."
}

Abgeschlossene Transkription

Rufe den Status-Endpunkt ab, um die fertige Transkription zu erhalten.

{
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "completed",
  "anonymized_text_raw": "Good morning, [[Person-A1B2C3]]. Let us begin with the quarterly review.",
  "original_text": "Good morning, Max Mustermann. Let us begin with the quarterly review.",
  "metadata": {
    "filename": "meeting-recording.mp3",
    "language": "en",
    "words": 11
  }
}

Transkript anonymisieren

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 "Authorization: Bearer YOUR_API_KEY" \
3  -F "file=@meeting.mp3" \
4  -F "language=de" \
5  -F "speaker_detection=true" \
6  -F "anonymize=true"

Beispiel-Request

1curl -X POST https://app.anymize.ai/api/transcribe \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -F "file=@meeting-recording.mp3" \
4  -F "language=en" \
5  -F "speaker_detection=true"

Endpunkt

Frage den aktuellen Status eines asynchronen Jobs ab.

Parameter

Status-Werte

Ein Job durchläuft folgende Zustände:

Status: Verarbeitung

{
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "processing"
}

Status: Abgeschlossen

Bei abgeschlossenem Job enthält die Antwort das Ergebnis.

{
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "completed",
  "anonymized_text_raw": "Max [[Person-A1B2C3]] lives in [[Location-D4E5F6]].",
  "original_text": "Max Mustermann lives in Berlin.",
  "metadata": {
    "filename": "document.pdf",
    "language": "en",
    "words": 6
  }
}

Status: Fehlgeschlagen

{
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "failed"
}

Polling-Strategie

Frage den Status in regelmäßigen Abständen ab, bis der Job fertig ist.

1# Poll every 3 seconds until completed
2while true; do
3  RESULT=$(curl -s https://app.anymize.ai/api/status/11111111-1111-4111-8111-111111111111 \
4    -H "Authorization: Bearer YOUR_API_KEY")
5  STATUS=$(echo $RESULT | jq -r '.status')
6  echo "Status: $STATUS"
7  if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
8    echo $RESULT | jq .
9    break
10  fi
11  sleep 3
12done

Endpunkt

Exportiere abgeschlossene Transkriptionen in verschiedenen Formaten.

Parameter

Gib Job-ID, Format und optional eine Variante an.

Verfügbare Formate

Response-Header

Der Download enthält passende Content-Type- und Content-Disposition-Header.

Content-Type: application/pdf
Content-Disposition: attachment; filename="document_anonymized.pdf"
Content-Length: 245832

Export-Varianten

Wähle zwischen der originalen und der anonymisierten Version.

Beispiel-Requests

1curl -OJ https://app.anymize.ai/api/v1/jobs/11111111-1111-4111-8111-111111111111/export?format=pdf \
2  -H "Authorization: Bearer YOUR_API_KEY"

Fehlerfälle

DOCX liefert 501. Nicht gefundene Jobs liefern 404, nicht abgeschlossene Jobs 400.

{
  "error": "DOCX export not yet implemented"
}

{
  "error": "Job not found"
}