music-finetunes

Create Music Finetune

Changed on

Create a new music finetune

post/v1/music/finetunes

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/music/finetunes
  • Auth
    none declared

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Request body multipart/form-data

namestring required

Name for the finetune (5-200 characters).

primary_genrestring required

Primary musical genre of the finetune.

filesstring[]

Audio files to train on.

tagsstring[]

Tags to associate with the finetune.

visibility'private' | 'workspace' nullable

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

model_id'music_v1' | 'music_v2' | 'music_v2_5'

Response

Successful Response

idstring required

Unique identifier of the finetune.

namestring required

Name of the finetune.

tagsstring[] required

Tags associated with the finetune.

primary_genrestring nullable

Primary musical genre of the finetune.

model_idstring required

The base music model the finetune was trained on.

created_atstring date-time required

When the finetune was created (UTC).

visibility'private' | 'workspace' | 'public' required
created_by'self' | 'workspace' | 'elevenlabs' required
status'pending' | 'in_progress' | 'completed' | 'failed' | 'blocked' required
training_progressnumber required

Training progress from 0.0 to 1.0.

failure_reason'audio_processing_failed' | 'copyright_violation' | 'training_failed'

Example response

{
  "model_id": "music_v1"
}

Changes