> For the complete documentation index, see [llms.txt](https://developer.doctranslate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.doctranslate.io/document-translation-api/translation-api/api-v3/audio-translation.md).

# Audio Translation

#### HTTP request <a href="#http-request" id="http-request"></a>

POST `/v3/translate/audio`

**Authorization(***Bearer token or API key)*

*OAuth2PasswordBearer*

```
Authorization: OAuth2PasswordBearer
```

Header API Key

```
X-API-Key: <your_api_key>
```

**Request Body schema: multipart/form-data**

| KEY            | TYPE        | VALUE                                                                                                        |
| -------------- | ----------- | ------------------------------------------------------------------------------------------------------------ |
| files          | list\[File] | List of audio files for translation                                                                          |
| source\_lang   | String      | Source language of the audio content.                                                                        |
| dest\_lang     | String      | The target language for translation.                                                                         |
| process\_mode  | String      | Describes how the file should be processed 'replace', 'append', 'append\_reverse'.                           |
| domain         | String      | The new domain or field of the content for audio, which can help in choosing specialized translation models. |
| custom\_prompt | String      | Custom prompt to be used for the translation                                                                 |

**Response**

**200:** Success

Response schema: *application/json*

| KEY          | VALUE                                                                                                                                                                                                                |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| status\_code | 200                                                                                                                                                                                                                  |
| content      | { "data": { "task\_id": "0d05c89e6f2c472ab86b291516e8e466" }, "errors": \[], "error\_description": "", "start\_time": "2024-03-11 13:05:42.080757", "end\_time": "2024-03-11 13:05:42.348086", "status": "success" } |

**400:** Bad Request

| KEY          | VALUE                                                                                                                                                                                                   |   |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| status\_code | 400                                                                                                                                                                                                     |   |
| content      | { "data": {}, "errors": \[ "Error" ], "error\_description": "Error while sending message. Please check server!", "start\_time": "yyyy-mm-dd hh-mm-ss utc+7", "end\_time": "yyyy-mm-dd hh-mm-ss utc+7" } |   |
|              |                                                                                                                                                                                                         |   |

**401: A**uthentication Error

| KEY          | VALUE                             |   |
| ------------ | --------------------------------- | - |
| status\_code | 401                               |   |
| content      | { "detail": "Not authenticated" } |   |
|              |                                   |   |

Response schema: *application/json*

| detail |   |
| ------ | - |