Create Music Finetune

POST

/v1/music/finetunes

POST

/v1/music/finetunes

$ curl -X POST https://api.elevenlabs.io/v1/music/finetunes \
>      -H "Content-Type: multipart/form-data" \
>      -F "files[]"=@indie_rock_sample1.wav \
>      -F "files[]"=@indie_rock_sample2.mp3 \
>      -F model_id="music_v1" \
>      -F name="Indie Rock Vibes Finetune" \
>      -F primary_genre="indie rock" \
>      -F tags='[
>   "indie",
>   "rock",
>   "guitar"
> ]' \
>      -F visibility="workspace"

1 {
2   "id": "a3f47b9e-8c2d-4f1a-9b7e-2d5f3c9a7e4b",
3   "name": "Indie Rock Vibes Finetune",
4   "tags": [
5     "indie",
6     "rock",
7     "guitar"
8   ],
9   "model_id": "music_v1",
10   "created_at": "2024-01-15T09:30:00Z",
11   "visibility": "private",
12   "created_by": "self",
13   "status": "pending",
14   "training_progress": 0,
15   "primary_genre": "indie rock",
16   "failure_reason": null
17 }

Create a new music finetune

Request

This endpoint expects a multipart form with multiple files.

namestringRequired5-200 characters

Name for the finetune (5-200 characters).

primary_genrestringRequired

Primary musical genre of the finetune.

filesfilesOptional

Audio files to train on.

tagslist of stringsOptionalDefaults to []

Tags to associate with the finetune.

visibilityenum or nullOptional

Finetune visibility. Only 'private' and 'workspace' can be set.

Allowed values:

model_idenumOptionalDefaults to music_v1

The model to create a finetune for.

Allowed values:

Response

Successful Response

idstring

Unique identifier of the finetune.

namestring

Name of the finetune.

tagslist of strings

Tags associated with the finetune.

model_idstring

The base music model the finetune was trained on.

created_atstringformat: "date-time"

When the finetune was created (UTC).

visibilityenum

Who can access this finetune: private (only you), workspace (members of your workspace), public (ElevenLabs-curated, available to everyone).

created_byenum

Who created the finetune: self, workspace, or elevenlabs.

statusenum

Training lifecycle status: pending, in_progress, completed, failed, and blocked.

training_progressdouble

Training progress from 0.0 to 1.0.

primary_genrestring or null

Primary musical genre of the finetune.

failure_reasonenum or null

Reason the finetune failed or was blocked, if applicable.

Errors

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

Headers

Request

Response

Errors