{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/api-reference/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"API Reference","searchWeight":120,"type":"markdown"},"seo":{"title":"Music Studio","description":"Complete API reference and documentation for Freddy AI-powered backend system by Aitronos","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"music-studio","__idx":0},"children":["Music Studio"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Music Studio API generates AI music, organizes it into a personal library, groups tracks into collections, drives continuous focus sessions, and shares tracks or collections through public links."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All generation runs on the Aitronos music engine. Call ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/engines"},"children":["List available music engines"]}," to discover the enabled engines and their capabilities (maximum duration, vocals, stems, supported languages, and licence class) before submitting a job."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"concepts","__idx":1},"children":["Concepts"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Engine"]}," — an Aitronos-branded music engine identified by an internal ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["engine_key"]},". Each engine advertises its own capabilities and licence class."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Generation job"]}," — an asynchronous request to produce a track. Submit it, then poll for status until it succeeds, fails, is cancelled, or is refused."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Track"]}," — a produced piece of audio (id prefixed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mtrack_"]},"). Tracks expose freshly-minted, short-TTL signed playback URLs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Library"]}," — your saved tracks. Saving adds a library edge (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mlib_"]},"); it never modifies the track."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Collection"]}," — a user-owned, ordered grouping of tracks (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcoll_"]},"). A track may belong to many collections."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Focus session"]}," — a continuously generated stream of crossfade-able segments (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mfocus_"]},") toward a target length."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Share link"]}," — a public, token-based link (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mslink_"]},") to a track or collection. The raw token is shown once."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication--scope","__idx":2},"children":["Authentication & scope"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every Music Studio endpoint (except the public share resolve) requires authentication via Bearer token or API key, and is scoped to an organization passed in the path as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{organization_id}"]},". The caller may only act within an organization they belong to."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"licence-honesty","__idx":3},"children":["Licence honesty"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each engine and track carries a truthful ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["licence_class"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commercial_cleared"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commercial_enterprise"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personal_only"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unclear"]},"), a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commercial_use"]}," boolean, and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requires_attribution"]}," boolean. These are never overstated — always check them before using generated audio commercially."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoints","__idx":4},"children":["Endpoints"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Group"},"children":["Group"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Engines"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/engines"},"children":["List available music engines"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Generation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/create-generation"},"children":["Create a generation job"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/list-generations"},"children":["List generation jobs"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/get-generation"},"children":["Get a generation job"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/cancel-generation"},"children":["Cancel a generation job"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tracks"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/list-tracks"},"children":["List saved tracks"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/get-track"},"children":["Get a track"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/save-track"},"children":["Save a track"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/unsave-track"},"children":["Remove a saved track"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/delete-track"},"children":["Delete a track"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Collections"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/create-collection"},"children":["Create a collection"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/list-collections"},"children":["List collections"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/get-collection"},"children":["Get a collection"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/update-collection"},"children":["Update a collection"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/delete-collection"},"children":["Delete a collection"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/add-collection-track"},"children":["Add a track to a collection"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/remove-collection-track"},"children":["Remove a track from a collection"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/list-collection-tracks"},"children":["List a collection's tracks"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/reorder-collection"},"children":["Reorder a collection"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Focus"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/start-focus-session"},"children":["Start a focus session"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/get-focus-session"},"children":["Get a focus session"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/end-focus-session"},"children":["End a focus session"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/promote-focus-segment"},"children":["Promote a focus segment"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sharing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/share-track"},"children":["Share a track"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/share-collection"},"children":["Share a collection"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/revoke-share"},"children":["Revoke a share link"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/resolve-share"},"children":["Open a shared link"]}," · ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/save-shared-track"},"children":["Save a shared track"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usage"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/music/get-usage"},"children":["Get music usage"]}]}]}]}]}]}]},"headings":[{"value":"Music Studio","id":"music-studio","depth":1},{"value":"Concepts","id":"concepts","depth":2},{"value":"Authentication & scope","id":"authentication--scope","depth":2},{"value":"Licence honesty","id":"licence-honesty","depth":2},{"value":"Endpoints","id":"endpoints","depth":2}],"frontmatter":{"title":"Music Studio","keywords":["music","ai music","music generation","music studio","focus sessions","tracks","collections"],"seo":{"title":"Music Studio"}},"lastModified":"2026-06-28T21:42:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/music/introduction","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}