---
title: "Extract transcription from voice audio"
method: POST
path: "/v2/tts/voices/extract-transcription"
---

# Extract transcription from voice audio

`POST /v2/tts/voices/extract-transcription`

Extract a text transcription from a voice audio sample.

## Request body

- ExtractTranscriptionRequest
  - `projectId` string, uuid, required
  - `audioUrl` string, uri, required
  - `language` string — Optional language hint for transcription.

## Response `200`

Transcription extracted successfully.

- ExtractTranscriptionResponse
  - `success` boolean
  - `message` string
  - `messageKey` string
  - `data` object
    - `transcription` string

## Other responses

- `400` — Validation error.
- `500` — Internal server error.

---

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