MusicAPI
HomeDocs
HomeDocs
  1. studio(Unavailable)
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Special Scenarios
  • Error handling
  • sonic
    • Sonic Instructions
    • create music
      POST
    • extend music
      POST
    • concat music
      POST
    • cover music
      POST
    • create persona
      POST
    • create music with persona
      POST
    • upload music
      POST
    • get music
      GET
  • riffusion
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
      POST
    • extend mode (Use case2)
      POST
    • custom mode (Use case3)
      POST
    • instrumental mode (Use case4)
      POST
    • get music
      GET
  • lyrics generation
    • Make Lyrics
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
    • create instrument music
    • get music
  • get-credits
    GET
  1. studio(Unavailable)

get music

GET
https://api.musicapi.ai/api/v1/studio/task/{task_id}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
task_id
string 
required
Example:
c29531f3-97eb-41b9-b563-a6e222d5a1b2

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.musicapi.ai/api/v1/studio/task/c29531f3-97eb-41b9-b563-a6e222d5a1b2'

Responses

🟢200success
application/json
Body
code
string 
required
message
string 
required
data
object 
required
task_id
string 
required
notify_hook
string 
required
action
string 
required
status
string 
required
fail_reason
string 
required
submit_time
integer 
required
start_time
integer 
required
finish_time
integer 
required
progress
string 
required
data
object 
required
Example
{
    "code": "success",
    "message": "",
    "data": {
        "task_id": "1938c07e-be59-4cfe-af63-55c22201e10b",
        "notify_hook": "",
        "action": "studio-generate",
        "status": "SUCCESS",
        "fail_reason": "",
        "submit_time": 1732240123,
        "start_time": 1732240139,
        "finish_time": 1732240189,
        "progress": "100%",
        "data": {
            "songs": [
                {
                    "id": "6b021760-9c10-413b-b2df-b379496cb37c",
                    "tags": [
                        "jazz",
                        "bossa nova",
                        "mpb",
                        "vocal jazz",
                        "spy",
                        "2010s"
                    ],
                    "liked": false,
                    "likes": 0,
                    "plays": 0,
                    "title": "Moonlit Caper ext v1.2.1",
                    "artist": "ErraticTrombone9223",
                    "lyrics": "\n[Bridge]\nSilent nods, and the team aligns\nHearts beat in sync like smooth tunned chimes\nA signal to go, align with the stars\nFollowing the path to the midnight bazaar\n\n[Verse]\nThey train under the city's glow (practiced)\nLeaping over hurdles, swift and low (agile)\nThe moon keeps their secret, like a friend (faithful)\nAs they perfect their heist to its end\n[Verse]\nSly paws all crept in the night, (tiptoe)\nIn the shadows, whiskers tight, (go, go)\nA heist under the moonlight, (silent)\nCats in black suits, oh what a sight!\n[Chorus]\nJazz tunes play, as they sway,\nIn the night they steal away,\nSamba moves while skies are gray,\nBossa beats lead the way.\n[Verse]\nWhispers follow through the alley (echo)\nClaws tapping to a secret melody (soft tread)\nTail sync in perfect harmony (unseen)\nNimble shadows with a crafty strategy\n\n[Chorus]\nSneaky jazz, their secret call\nRhythm tight, in the silent thrall\nAs the moon oversees it all\nNight's the stage, and they're the ball\n[Verse]\nAcross rooftops, softly they glide, (swift)\nEach move precise as they bide, (shift)\nWith eyes like emeralds, they guide, (keen)\nMasters of stealth, in darkness they hide\n\n[Chorus]\nJazz whispers float on the breeze\nStep by step, with practiced ease\nTheir daring caper, nights like these\nMischief weaving through the trees",
                    "prompt": "A heist planned and executed by a group of cats, spy jazz, bossa nova",
                    "user_id": "9b8c7d62-2f02-44d4-a72d-8d08a1e8a36e",
                    "disliked": false,
                    "duration": 130.794666666667,
                    "error_id": null,
                    "finished": true,
                    "song_path": "https://storage.googleapis.com/studio-artifacts-c33fe3ba-3ffe-471f-92c8-5dfef90b3ea3/samples/d1e9e15b04c6434495187c6d8b1648dc/1/Moonlit%2520Caper%2520ext%2520v1.2.1.mp3",
                    "user_tags": [],
                    "created_at": "2024-11-22T01:48:41.839599+00:00",
                    "error_code": null,
                    "error_type": null,
                    "image_path": "https://imagedelivery.net/C9yUr1FL21Q6JwfYYh2ozQ/b61df523-8f4e-4f5b-961c-e667ce2a9a00/public",
                    "video_path": null,
                    "attribution": "",
                    "description": "",
                    "publishable": true,
                    "artist_image": "https://lh3.googleusercontent.com/a/ACg8ocIORKAHmHyclVkNM-Qt8tOjZpX7VPD5oE5aJ87BN4tYAncpjg=s96-c",
                    "error_detail": null,
                    "published_at": null,
                    "generation_id": "1938c07e-be59-4cfe-af63-55c22201e10b",
                    "replaced_tags": {
                        "jazz, bossa nova, spy": {
                            "tags": [
                                "jazz",
                                "vocal jazz",
                                "bossa nova",
                                "mpb",
                                "samba-jazz",
                                "2010s"
                            ],
                            "type": "tags"
                        },
                        "jazz, vocal jazz, bossa nova, mpb, samba-jazz, 2010s": {
                            "tags": [
                                "jazz",
                                "bossa nova",
                                "mpb",
                                "vocal jazz",
                                "spy",
                                "2010s"
                            ],
                            "type": "tags"
                        }
                    },
                    "original_song_path": null,
                    "audio_conditioning_type": "precede"
                },
                {
                    "id": "9016648c-7bf7-4bdb-81de-95da35e58822",
                    "tags": [
                        "bossa nova",
                        "mpb",
                        "jazz",
                        "vocal jazz",
                        "spy jazz",
                        "2010s"
                    ],
                    "liked": false,
                    "likes": 0,
                    "plays": 0,
                    "title": "Moonlit Caper ext v1.2.2",
                    "artist": "ErraticTrombone9223",
                    "lyrics": "[Intro]\nAs the city sleeps in its cloak of night (shhh)\nPlans are laid under the dim streetlight (hush)\nTailor suiting for feline might (prepared)\nChampions of stealth, poised for flight\n\n[Verse]\nMaps unfurled on the alleyway ground (focus)\nPaws trace routes, no trace to be found (plan)\nEyes meet, nods exchange without sound (ready)\nMysterious figures in the night unbound\n[Verse]\nSly paws all crept in the night, (tiptoe)\nIn the shadows, whiskers tight, (go, go)\nA heist under the moonlight, (silent)\nCats in black suits, oh what a sight!\n[Chorus]\nJazz tunes play, as they sway,\nIn the night they steal away,\nSamba moves while skies are gray,\nBossa beats lead the way.\n[Verse]\nWhispers follow through the alley (echo)\nClaws tapping to a secret melody (soft tread)\nTail sync in perfect harmony (unseen)\nNimble shadows with a crafty strategy\n\n[Chorus]\nSneaky jazz, their secret call\nRhythm tight, in the silent thrall\nAs the moon oversees it all\nNight's the stage, and they're the ball\n[Verse]\nAcross rooftops, softly they glide, (swift)\nEach move precise as they bide, (shift)\nWith eyes like emeralds, they guide, (keen)\nMasters of stealth, in darkness they hide\n\n[Chorus]\nJazz whispers float on the breeze\nStep by step, with practiced ease\nTheir daring caper, nights like these\nMischief weaving through the trees",
                    "prompt": "A heist planned and executed by a group of cats, spy jazz, bossa nova",
                    "user_id": "9b8c7d62-2f02-44d4-a72d-8d08a1e8a36e",
                    "disliked": false,
                    "duration": 130.794666666667,
                    "error_id": null,
                    "finished": true,
                    "song_path": "https://storage.googleapis.com/studio-artifacts-c33fe3ba-3ffe-471f-92c8-5dfef90b3ea3/samples/d1e9e15b04c6434495187c6d8b1648dc/2/Moonlit%2520Caper%2520ext%2520v1.2.2.mp3",
                    "user_tags": [],
                    "created_at": "2024-11-22T01:48:41.839599+00:00",
                    "error_code": null,
                    "error_type": null,
                    "image_path": "https://imagedelivery.net/C9yUr1FL21Q6JwfYYh2ozQ/5f52d55e-3df2-47e1-7fba-54422cd1fc00/public",
                    "video_path": null,
                    "attribution": "",
                    "description": "",
                    "publishable": true,
                    "artist_image": "https://lh3.googleusercontent.com/a/ACg8ocIORKAHmHyclVkNM-Qt8tOjZpX7VPD5oE5aJ87BN4tYAncpjg=s96-c",
                    "error_detail": null,
                    "published_at": null,
                    "generation_id": "1938c07e-be59-4cfe-af63-55c22201e10b",
                    "replaced_tags": {
                        "spy jazz, bossa nova": {
                            "tags": [
                                "jazz",
                                "vocal jazz",
                                "bossa nova",
                                "mpb",
                                "samba-jazz",
                                "2010s"
                            ],
                            "type": "tags"
                        },
                        "jazz, vocal jazz, bossa nova, mpb, samba-jazz, 2010s": {
                            "tags": [
                                "bossa nova",
                                "mpb",
                                "jazz",
                                "vocal jazz",
                                "spy jazz",
                                "2010s"
                            ],
                            "type": "tags"
                        }
                    },
                    "original_song_path": null,
                    "audio_conditioning_type": "precede"
                }
            ]
        }
    }
}
Modified at 2024-11-29 05:47:53
Previous
instrumental mode (Use case4)
Next
Make Lyrics
Built with