> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revocalize.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Convert Audio File

> This endpoint takes a WAV vocal audio file and returns a URL string with the converted vocals audio file.

### Request

<ParamField body="audio_file" type="file" required>
  The input vocal audio file. The maximum allowed file size is 100MB. The recommended audio format is WAV. Other audio formats may be supported, but the results may be less accurate.
</ParamField>

<ParamField body="model" type="string" required>
  The ID of the AI voice model used for conversion. Fetch the available models for your organization from the [/models](/api-reference/models/get) API endpoint. The available demo models are:

  <ol>
    <li>`andra`</li>
    <li>`nicole_cherry`</li>
    <li>`marius_moga`</li>
    <li>`sebastian_dobrincu`</li>
  </ol>
</ParamField>

<ParamField body="transpose" type="integer" optional default="0">
  The number of semitones to transpose the vocals. The default value is 0. The allowed range is -12 to 12.
</ParamField>

<ParamField body="generations_count" type="integer" optional default="1">
  The number of generations to create. The default value is 1. The allowed range is 1 to 10.
</ParamField>

### Response

<ResponseField name="task_id" type="string">
  ID of the conversion task. Use it to check the status of the conversion task.
</ResponseField>

<RequestExample>
  ```bash Example Request theme={null}
  curl --location --request POST 'https://api.revocalize.ai/convert' \
  --header 'Content-Type: multipart/form-data' \
  --header 'Authorization: Bearer <token>' \
  --form 'audio=@/path_to_audio_file.wav'
  --form 'model=andra'
  --form 'transpose=0'
  --form 'generations_count=4'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "task_id": "123456"
  }
  ```
</ResponseExample>