Get Music Finetune

GET 
https://api.knoxstudio.ai/v1/music/finetunes/:finetune_id

Retrieve one finetune. Not billed.

Request

Path Parameters

Name	Type	Required	Description
finetune_id	String	Yes	Finetune ID.

Request Headers

Name	Type	Required	Description
Authorization	String	Yes	Bearer <token> Knox API key. xi-api-key is also accepted.

cURL Example

curl -X GET https://api.knoxstudio.ai/v1/music/finetunes/ftn_123 \
     -H "Authorization: Bearer $KNOXCHAT_API_KEY"

Response

Success Response (200)

| id | string | Finetune ID. | | name | string | Display name (5–200 characters). | | tags | array of strings | Associated tags. | | model_id | string | Base music model. | | created_at | string | UTC timestamp. | | visibility | string | private, workspace, or public. | | created_by | string | self, workspace, or elevenlabs. | | status | string | pending, in_progress, completed, failed, blocked. | | training_progress | number | 0.0–1.0. | | primary_genre | string | Primary genre. | | failure_reason | string | audio_processing_failed, copyright_violation, or training_failed. |

Error Responses

Validation uses HTTP 422:

{
  "detail": [
    {
      "loc": ["body", "field"],
      "msg": "…",
      "type": "value_error"
    }
  ]
}

Other errors use { "detail": "message" }.

Status	When
400	WebSocket path called without Upgrade: websocket.
401	Missing or invalid API key.
402	Insufficient credits.
403	Token is not allowed to use this model.
404	Resource not found.
422	Validation error.
429	Rate limit exceeded.
500	Internal server error.