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

# Create Music Finetune

`POST /v1/music/finetunes`

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.

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

[Change 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/4a6716242c9e?raw)