music-finetunes

Get Music Finetunes

Changed on

List music finetunes accessible to you (your own, workspace-shared, and ElevenLabs-curated), with optional filtering, sorting, and cursor pagination.

get/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

Query parameters

cursorstring nullable

Used for fetching the next page. Cursor is returned in the response.

page_sizeinteger

How many finetunes to return. Max 150, default 50.

visibility'private' | 'workspace' | 'public'

Filter by visibility. 'private' returns private finetunes; 'workspace' returns workspace-shared finetunes; 'public' returns public finetunes, which are currently ElevenLabs curated finetunes. Omit to return all accessible finetunes.

created_by'self' | 'workspace' | 'elevenlabs'

Filter by creator. 'self' returns finetunes you created; 'workspace' returns finetunes created by workspace teammates; 'elevenlabs' returns ElevenLabs curated finetunes. Omit to return finetunes from all creators.

sort'created_at' | 'name'

Sort by field (created_at or name)

sort_direction'asc' | 'desc'

Sort direction (asc or desc)

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.

Response

Successful Response

next_cursorstring nullable required

Cursor to pass as cursor to fetch the next page; null when there are no more results.

has_moreboolean required

Whether more finetunes are available beyond this page.

Example response

{
  "finetunes": [
    {
      "model_id": "music_v1"
    }
  ]
}

Changes