v5

OpenAPI 3.1.02026-08-043621,4011.8 MB

music-finetunes

Update Music Finetune

Update a music finetune.

patch/v1/music/finetunes/{finetune_id}

Path parameters

finetune_idstring required

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

namestring nullable

Updated name for the finetune.

tagsstring[] nullable

Replacement set of tags.

primary_genrestring nullable

Updated primary musical genre.

visibility'private' | 'workspace' nullable

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

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"
}