Retrieve a track · Docs

GEThttps://api.vaelor.chat/v1/music/{id}

Returns a single track, including its configuration and lyrics.

Path parameters#

idstringRequired

The track ID.

Response#

idstring

Unique track ID.

requestIduuid

The idempotency key the track was created with.

statusenum

pending, ready or failed.

titlestring

Track title.

configurationobject

The configuration sent to Create a track.

lyricsstring

The lyrics that were sung. Empty for instrumentals.

durationSecondsinteger

Actual length of the rendered audio.

seedstring

The seed used. Send it back to reproduce the result.

creditCostinteger

Credits charged.

errorstring | null

Why rendering failed, if it did.

createdAtstring

Creation time, in ISO 8601.

Example#

curl https://api.vaelor.chat/v1/music/5f0c2d1e-7a39-4b8e-9e61-2d4f8a0b3c77 \
  -H "Authorization: Bearer $VAELOR_API_KEY"

const track = await fetch(`https://api.vaelor.chat/v1/music/${trackId}`, {
  headers: { Authorization: `Bearer ${process.env.VAELOR_API_KEY}` }
}).then((response) => response.json())

track = requests.get(
    f"https://api.vaelor.chat/v1/music/{track_id}",
    headers={"Authorization": f"Bearer {os.environ['VAELOR_API_KEY']}"},
).json()

Response200

JSON

{
  "id": "5f0c2d1e-7a39-4b8e-9e61-2d4f8a0b3c77",
  "requestId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "status": "ready",
  "title": "Harbor Lights",
  "configuration": {
    "mode": "custom",
    "description": "A late-night synthwave drive along the coast",
    "genre": "synthwave",
    "duration": 180,
    "language": "en",
    "instrumental": true,
    "bpm": 96
  },
  "lyrics": "",
  "durationSeconds": 180,
  "seed": "2841907733",
  "creditCost": 180,
  "error": null,
  "createdAt": "2026-10-20T09:12:44.000Z"
}

Errors#

Status	When
`404`	No track with this ID exists in your library.