GET /v1/templates
The curated styles you can use with Reimagine
List the curated styles — the same cards as Simple mode in the app. Pass a style's id as templateId to POST /v1/reimagine. Reimagine sings your lyrics, so it only accepts styles with isInstrumental: false. The prompt behind each style stays on our side.
Request
GET https://pub.finetuning.ai/v1/templatesHeaders
| Header | Type | Required | Description |
|---|---|---|---|
X-API-Key | string | Yes | Your API key |
Example request
curl https://pub.finetuning.ai/v1/templates \
-H "X-API-Key: ft_live_your_key_here"const res = await fetch('https://pub.finetuning.ai/v1/templates', {
headers: { 'X-API-Key': process.env.FINETUNING_API_KEY! },
})
const { data } = await res.json()
const vocalStyles = data.templates.filter((t: { isInstrumental: boolean }) => !t.isInstrumental)Response
{
"data": {
"templates": [
{
"id": "template-open-roads",
"name": "Open Roads",
"description": "Acoustic Folk",
"emoji": null,
"isInstrumental": false
},
{
"id": "template-neon-drive",
"name": "Neon Drive",
"description": "Synthwave / Retrowave",
"emoji": null,
"isInstrumental": true
}
]
}
}Response fields
| Field | Description |
|---|---|
id | Pass as templateId |
name | Shown in the new track's title, e.g. my-song (Open Roads) |
description, emoji | For your own style picker |
isInstrumental | true for styles without singing. Reimagine refuses these with 400 VALIDATION_ERROR |