---
title: "Create a transcription"
method: POST
path: "/v2/audio/transcriptions"
tags: ["/audio/transcriptions"]
---

# Create a transcription

`POST /v2/audio/transcriptions`

Transcribe an audio file.

## Response `200`

A successful response.

- object
  - `text` string, required — The transcribed text.

## Other responses

- `400` — This error is returned when the request is not well formed. This could be because: - JSON is invalid - The request is missing required fields - The request contains an invalid combination of fields
- `401` — This error indicates that the operation attempted to be performed is not allowed. This could be because: - The api token is invalid - The user does not have the necessary permissions
- `403` — This error indicates that the operation attempted to be performed is not allowed. This could be because: - The api token is invalid - The user does not have the necessary permissions
- `404` — This error is returned when a resource is not found. This could be because: - The endpoint does not exist - The resource does not exist eg model id, dataset id
- `422` — This error is returned when the request is not well formed. This could be because: - JSON is invalid - The request is missing required fields - The request contains an invalid combination of fields
- `429` — Too many requests
- `498` — This error is returned when a request or response contains a deny-listed token.
- `499` — This error is returned when a request is cancelled by the user.
- `500` — This error is returned when an uncategorised internal server error occurs.
- `501` — This error is returned when the requested feature is not implemented.
- `503` — This error is returned when the service is unavailable. This could be due to: - Too many users trying to access the service at the same time
- `504` — This error is returned when a request to the server times out. This could be due to: - An internal services taking too long to respond

## Changes

> 58 revisions in range; 2 could not be searched.

- **2026-03-25** `22a1b91a5c70` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cohere-ai/apis/api-reference/changes/v2/audio/transcriptions/post.md)

---

[API](https://skmtc.dev/cohere-ai/apis/api-reference.md) · [All operations](https://skmtc.dev/cohere-ai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cohere-ai/api-reference/revisions/6f64ec87c66d/schema)