Skip to content

Get a music track

Return a single track the caller may access (they created it or saved it) plus freshly-minted short-TTL signed playback URLs for the master and any stems.

GEThttps://api.aitronos.com/v1/music/{organization_id}/tracks/{track_id}

URLs are minted on each request and expire quickly. Returns 404 if the track does not exist or the caller has no access to it (IDOR-safe — the same response for both cases).

Path parameters

organization_id string required

The organization the track is scoped to. The caller must belong to it.

track_id string required

Id of the track (mtrack_-prefixed).

Returns

A track object with freshly-minted signed playback URL(s).

id string · Track id (mtrack_-prefixed).

title string · Track title, if one was provided.

engine string · Internal engine key the track was generated with.

mode string · Generation mode the track was produced in.

measured_duration_seconds number · Measured master duration in seconds, if known.

instrumental boolean · Whether the track is instrumental-only.

licence_class string · Neutral licence tier: commercial_cleared, commercial_enterprise, personal_only, or unclear.

created_at string · When the track was created (UTC).

playback_url string · Short-TTL signed URL for the master audio. Expires quickly; re-fetch to mint a new one.

stem_urls object · Per-stem signed URLs (stem name → URL), when the track has stems. Present only on this single-track fetch.

cURL
curl "https://api.aitronos.com/v1/music/org_abc123/tracks/mtrack_7c1a9e2f4b8d" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

200 OK
{
  "id": "mtrack_7c1a9e2f4b8d",
  "title": "Late Night Study",
  "engine": "studio",
  "mode": "creation",
  "measured_duration_seconds": 119.4,
  "instrumental": true,
  "licence_class": "personal_only",
  "created_at": "2026-06-28T10:31:00Z",
  "playback_url": "https://storage.aitronos.com/music/mtrack_7c1a9e2f4b8d.mp3?sig=...",
  "stem_urls": {
    "drums": "https://storage.aitronos.com/music/mtrack_7c1a9e2f4b8d_drums.mp3?sig=...",
    "bass": "https://storage.aitronos.com/music/mtrack_7c1a9e2f4b8d_bass.mp3?sig=..."
  }
}