For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DASHBOARDPLAYGROUNDDOCSCOMMUNITYLOG IN
Guides and conceptsAPI ReferenceRelease NotesLLMUCookbooks
Guides and conceptsAPI ReferenceRelease NotesLLMUCookbooks
  • Cohere API
    • About
    • Teams and Roles
    • Errors
    • Migrating From API v1 to API v2
    • Using the OpenAI SDK
  • Endpoints
      • POSTCreate a transcription
  • Deprecated
LogoLogodocs
DASHBOARDPLAYGROUNDDOCSCOMMUNITYLOG IN
Endpointsv2/audio/transcriptions

Create a transcription

POST
https://api.cohere.com/v2/audio/transcriptions
POST
/v2/audio/transcriptions
1import cohere
2
3co = cohere.ClientV2()
4
5transcription = co.audio.transcriptions.create(
6    model="cohere-transcribe-03-2026",
7    language="en",
8    file=open("./sample.wav", "rb"),
9)
10
11print(transcription)
1{
2  "text": "Hello, this is a sample transcription of the audio file."
3}
Transcribe an audio file.
Was this page helpful?
Previous

Create a Dataset

Next
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a multipart form containing a file.
modelstringRequired
ID of the model to use.
languagestringRequired
The language of the input audio, supplied in [ISO-639-1](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) format.
temperaturedoubleOptional
The sampling temperature, between 0 and 1. Higher values like 0.8 make the output more random, while lower values like 0.2 make it more focused and deterministic.
filefileRequired
The audio file object to transcribe. Supported file extensions are flac, mp3, mpeg, mpga, ogg, and wav.

Response

A successful response.
textstring
The transcribed text.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
498
Invalid Token Error
499
Client Closed Request Error
500
Internal Server Error
501
Not Implemented Error
503
Service Unavailable Error
504
Gateway Timeout Error

The language of the input audio, supplied in ISO-639-1 format.