---
title: "Create Forced Alignment"
method: POST
path: "/v1/forced-alignment"
tags: ["forced-alignment"]
---

# Create Forced Alignment

`POST /v1/forced-alignment`

Force align an audio file to text. Use this endpoint to get the timing information for each character and word in an audio file based on a provided text transcript.

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- ForcedAlignmentResponseModel — Model representing the response from the aligner service.
  - `characters` ForcedAlignmentCharacterResponseModel[], required — List of characters with their timing information.
    - `text` string, required — The character that was transcribed.
    - `start` number, required — The start time of the character in seconds.
    - `end` number, required — The end time of the character in seconds.
  - `words` ForcedAlignmentWordResponseModel[], required — List of words with their timing information.
    - `text` string, required — The word that was transcribed.
    - `start` number, required — The start time of the word in seconds.
    - `end` number, required — The end time of the word in seconds.
    - `loss` number, required — The average alignment loss/confidence score for this word, calculated from its constituent characters.
  - `loss` number, required — The average alignment loss/confidence score for the entire transcript, calculated from all characters.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/versions/e77a0a530a82/schema)