- Introduction
- Credits Usage Guide
- Music API FAQ & Troubleshooting
- Common Scenarios
- Error handling
- sonic
- studio
- lyrics generation
- nuro
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