---
title: "Create Music Finetune"
method: POST
path: "/v1/music/finetunes"
tags: ["music-finetunes"]
---

# Create 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

Create a new music finetune

## Headers

- `xi-api-key` string, 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`

- BodyCreateMusicFinetuneV1MusicFinetunesPost
  - `name` string, required: Name for the finetune (5-200 characters).
  - `primary_genre` string, required: Primary musical genre of the finetune.
  - `files` string[]: Audio files to train on.
  - `tags` string[]: 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 `201`

Successful Response

- MusicFinetuneResponseModel
  - `id` string, required: Unique identifier of the finetune.
  - `name` string, required: Name of the finetune.
  - `tags` string[], required: Tags associated with the finetune.
  - `primary_genre` string, nullable: Primary musical genre of the finetune.
  - `model_id` string, required: The base music model the finetune was trained on.
  - `created_at` string, 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_progress` number, required: Training progress from 0.0 to 1.0.
  - `failure_reason` 'audio_processing_failed' | 'copyright_violation' | 'training_failed'

## Other responses

- `403`: Missing permissions to manage music finetunes.
- `404`: Finetune not found.
- `422`: Validation Error

## Changes

- **2026-09-11** `01782c0621ab`: 1 info
  - added the new `music_v2_5` enum value to the request property `model_id`
- **2026-07-26** `494d96419d15`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/music/finetunes/post.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)