Transkription

Lade eine Audiodatei hoch, erhalte eine Job-ID und hole dir das Transkript, sobald es fertig ist. Große Dateien laufen asynchron: der Upload antwortet sofort mit 202.

Zwei Modi: transcript liefert nur den Text. meeting erzeugt zusätzlich einen Titel und Zusammenfassungen, wie in der Meeting-Ansicht der App.

POST legt den Auftrag an und antwortet, bevor die Erkennung fertig ist. Frage GET mit der Job-ID ab, bis status completed oder failed ist.

1curl "https://app.anymize.ai/api/v1/transcriptions" \
2  -H "Authorization: Bearer YOUR_API_KEY"

Eine Datei hochladen und die Erkennung starten. Die Antwort ist 202 mit der Job-ID.

Audiodatei hochladen und Transkription starten

multipart/form-data mit der Datei und optionalen Schaltern. Das Transkript holst du später über GET.

Request: multipart/form-data

{
  "id": "11111111-1111-4111-8111-111111111111",
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "processing",
  "mode": "transcript",
  "title": "standup.m4a",
  "filename": "standup.m4a",
  "message": "Audio submitted for transcription. Poll GET /api/v1/transcriptions/:id until status is completed or failed."
}

1curl -X POST "https://app.anymize.ai/api/v1/transcriptions" \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -F "file=@standup.m4a" \
4  -F "mode=transcript" \
5  -F "language=de"

Status, Text, Abschnitte und bei Meetings die Notizen. Audio-Bytes sind nicht enthalten.

Ein Transkriptionsauftrag

Liefert den aktuellen Stand. Poll, bis status completed oder failed ist. text ist null, solange es läuft.

{
  "id": "11111111-1111-4111-8111-111111111111",
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "completed",
  "mode": "transcript",
  "title": "standup.m4a",
  "filename": "standup.m4a",
  "language": "de",
  "words": 12,
  "duration_ms": 18400,
  "has_audio": true,
  "speaker_detection": false,
  "anonymize": false,
  "anonymization_applied": false,
  "text": "Guten Morgen. Lasst uns mit dem Stand-up beginnen.",
  "segments": [
    {
      "start_ms": 0,
      "end_ms": 18400,
      "speaker": "",
      "text": "Guten Morgen. Lasst uns mit dem Stand-up beginnen."
    }
  ],
  "created_at": "2026-09-11T08: 15: 00.000Z"
}

{
  "id": "11111111-1111-4111-8111-111111111111",
  "job_id": "11111111-1111-4111-8111-111111111111",
  "status": "completed",
  "mode": "meeting",
  "title": "Q3 Planung",
  "filename": "meeting.wav",
  "language": "de",
  "words": 842,
  "duration_ms": 3120000,
  "has_audio": true,
  "speaker_detection": true,
  "anonymize": false,
  "anonymization_applied": false,
  "text": "(((Speaker 1))) Guten Morgen. (((Speaker 2))) Danke, dass ihr da seid.",
  "segments": [
    {
      "start_ms": 0,
      "end_ms": 2100,
      "speaker": "Speaker 1",
      "text": "Guten Morgen."
    },
    {
      "start_ms": 2200,
      "end_ms": 5400,
      "speaker": "Speaker 2",
      "text": "Danke, dass ihr da seid."
    }
  ],
  "summaries": [
    {
      "template_key": "general",
      "title": null,
      "content": "Stand-up zur Q3-Planung. Naechster Schritt: Budget bis Freitag.",
      "status": "completed",
      "locale": "de"
    }
  ],
  "created_at": "2026-09-11T08: 15: 00.000Z"
}

1curl "https://app.anymize.ai/api/v1/transcriptions/11111111-1111-4111-8111-111111111111" \
2  -H "Authorization: Bearer YOUR_API_KEY"

Deine Audio-Transkriptionen, ohne den vollen Text. Den holst du per GET auf die einzelne ID.

Transkriptionen auflisten

Nur Audio-Jobs. Filtern nach mode und status. Ohne Text und ohne Segmente, damit die Liste klein bleibt.

{
  "data": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "job_id": "11111111-1111-4111-8111-111111111111",
      "status": "completed",
      "mode": "transcript",
      "title": "standup.m4a",
      "filename": "standup.m4a",
      "language": "de",
      "words": 12,
      "created_at": "2026-09-11T08: 15: 00.000Z"
    }
  ],
  "total": 1
}

1curl "https://app.anymize.ai/api/v1/transcriptions?mode=transcript&limit=20" \
2  -H "Authorization: Bearer YOUR_API_KEY"

Welchen Modus du wählst, entscheidet, was nach der Erkennung passiert, nicht die Qualität des Texts.

transcript speichert nur den Text. Keine automatischen Notizen, kein Meeting-Titel.

meeting erkennt Sprecher standardmäßig, vergibt einen Titel und erzeugt die Standard-Zusammenfassung.

Formate: MP3, WAV, M4A, OGG, WEBM. Transkripte bis 100 MB, Meetings bis 250 MB. Rate Limit: 50 Uploads pro Minute.

1curl -X POST "https://app.anymize.ai/api/v1/transcriptions" \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -F "file=@meeting.wav" \
4  -F "mode=meeting" \
5  -F "speaker_detection=true" \
6  -F "timestamps=true"

Der ältere Endpunkt bleibt. Er startet dieselbe Engine und antwortet mit der historischen 202-Form, damit bestehende Clients weiter /api/status/:id pollen.

Legacy-Upload, gleiche Engine

Nur API-Schlüssel, kein Session-Cookie. Dieselben Formularfelder wie POST /api/v1/transcriptions, inklusive mode.

Request: multipart/form-data

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

1curl -X POST https://app.anymize.ai/api/transcribe \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -F "file=@standup.mp3" \
4  -F "language=de"

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"
}