---
title: "Detect accent in an audio file"
method: POST
path: "/api/velma-2-accent-batch"
---

# Detect accent in an audio file

`POST /api/velma-2-accent-batch`

Analyze an audio file and return a whole-file accent label plus a
per-window accent time series.

## Response `200`

Accent detection completed successfully

- AccentResponse
  - `accent` string, required — The accent label for the whole file. Always present and non-null.
  - `time_series` AccentWindow[], required — Consecutive fixed-length windows over the file, each with its own accent label. Empty when the file is shorter than one window.
    - `start_ms` integer, required — Start of this window in milliseconds from the beginning of the file.
    - `duration_ms` integer, required — Length of this window in milliseconds.
    - `accent` string, required — The accent label for this window.

## Other responses

- `400` — Bad request - The submitted audio was rejected: an unsupported file extension, an empty file, or audio that could not be processed (for example, corrupted data or content that does not match a supported format).
- `403` — Forbidden - the request is not permitted
- `422` — Unprocessable Entity - a required request field is missing or malformed (for example, the `X-API-Key` header or the `upload_file` part).
- `429` — Too many requests - the request could not be completed due to insufficient credits
- `500` — Internal server error
- `502` — Bad gateway - the request could not be validated or completed

---

[API](https://skmtc.dev/modulate/apis/velma-2-accent-batch-api.md) · [All operations](https://skmtc.dev/modulate/apis/velma-2-accent-batch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/modulate/velma-2-accent-batch-api/revisions/b4c9ce648efa/schema)