MusicAPI
HomeDocs
HomeDocs
  1. studio(Unavailable)
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Common 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
  • 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
      POST
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
      POST
    • create instrument music
      POST
    • get music
      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"
        }
      ]
    }
  }
}
Previous
instrumental mode (Use case4)
Next
Make Lyrics
Built with