FUZZ 2.0
Billing Rules
Each generate requestion returns 1 task id, and each task id can be used to query 2 songs and 2 cover images.
Each generate requestion costs $0.035
Basic Configuration
Base URL: https://api.foxaihub.com/api/v2/fuzz
Headers Parameters
{
"api-key": "Your API Key",
}
Submit the songs generation task
Endpoint: /task
Method: POST
Content-Type: application/json
HTTP Body, you can generate songs via these methods.
- Instrumental
- Lyrics
- Extend
You can set lyrics to "", or "[Instrumental]".
{
"lyrics": "",
"tags": "jazz"
}
{
"lyrics": "[Verse 1]\nIn waves of starlit magic\n.....",
"tags": "pop, dream pop, female vocals"
}
song_id, The song id you want to extend.
start_s, Start time for the extension
extend_duration_s, Extend duration (max 3 minutes from start_s)
lyrics, This part of the lyrics is sung starting from start_s, rather than from the beginning. Therefore, you only need to provide the lyrics for the section that needs to be extended.
{
"lyrics": "put extend lyrics here, OK, OKOK \n",
"tags": "pop, dream pop, female vocals",
"extend": {
"song_id": "9f137820-6e82-4050-a308-2a59bbbfd517",
"extend_duration_s": 30,
"start_s": 125.61822
}
}
if your params is no problem, it always response this
{
"success": true,
"task_id": "0196bd75-edf7-7000-841c-c24752207636"
}
Query Results
Endpoint: /task?ids=
You can query not more than 25 task ids at once, split theme by comma, like this
/task?ids=0196bd6d-57a4-7000-96c6-f74ee7998e5f,0196bd6d-acc0-7000-81ae-a56d8b0631b6
Method: GET
HTTP Response
- struction
- queued
- completed
- failed
Here is response data struction
[
{
"status": "pending",
"task_id": "0196bdae-7fa9-7000-b8d7-987519774a05",
"gen_params": {
"topic": "a good song",
"instrumental": "false"
},
"data": {},
"created_at": "2025-05-11T04:50:51.000Z"
}
]
[
{
"status": "queued",
"task_id": "0196bd6d-57a4-7000-96c6-f74ee7998e5f",
"gen_params": {
"topic": "celtic folk song, timeless soul with deep emotion and powerful vocals, female singer",
"instrumental": "true"
},
"data": [
"c1f6747a-49ba-4f16-9e51-08cae7bd134e",
"0c7dcdb2-0a2a-4eb3-aaf2-dec1bf77b655"
],
"created_at": "2025-05-11T03:39:41.000Z"
},
{
"status": "queued",
"task_id": "0196bd6d-acc0-7000-81ae-a56d8b0631b6",
"gen_params": {
"title": "optional",
"conditions": [
{
"lyrics": "[Verse 1]\nIn waves of starlit magic\nMy heart turns so tragic\nYou say you love another\nWhile my mind turns static\nTell me what you need\nAs thoughts turn sporadic\nThis love fades faster than the titanic\n\n[Chorus]\nI float through endless melodies\nPast echoes of \"I'm sorry\"\nI just want another last chance\n\n[Verse 2]\nIn this ethereal haze, why am I alone?\nI just wanna be loved, drift with someone to hold\nMemories shimmer bright when I called on the phone\nBut now the calls you answer are his and not my own\n\n[Chorus]\nI float through endless melodies\nLost in this sweet romance\nPast echoes of \"I'm sorry\"\nI just want another last chance",
"strength": 0.5,
"condition_end": 1,
"condition_start": 0
},
{
"prompt": "dream,dream pop, pop",
"strength": 0.5,
"condition_end": 1,
"condition_start": 0
}
]
},
"data": [
"1d27b3d1-d3b8-49eb-a267-7c282aa8b4c2",
"71c20fda-aec3-4fca-83d9-f836ce6814eb"
],
"created_at": "2025-05-11T03:40:03.000Z"
}
]
Once the status = completed, you can find the result in the data field.
[
{
"status": "completed",
"task_id": "0196bd6d-57a4-7000-96c6-f74ee7998e5f",
"gen_params": {
"topic": "celtic folk song, timeless soul with deep emotion and powerful vocals, female singer",
"instrumental": "true"
},
"data": [
{
"id": "c1f6747a-49ba-4f16-9e51-08cae7bd134e",
"sound": "Celtic folk, haunting female vocals, acoustic instruments, ethereal harmonies",
"title": "Hidden",
"topic": "celtic folk song, timeless soul with deep emotion and powerful vocals, female singer",
"lyrics": "[Instrumental]",
"can_use": true,
"privacy": "unlisted",
"group_id": "",
"image_id": "c1f6747a-49ba-4f16-9e51-08cae7bd134e",
"audio_b64": null,
"audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/edd3980f-3553-418b-8792-26f37406febd/audio/c1f6747a-49ba-4f16-9e51-08cae7bd134e.m4a",
"author_id": "edd3980f-3553-418b-8792-26f37406febd",
"image_b64": null,
"image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/edd3980f-3553-418b-8792-26f37406febd/image/c1f6747a-49ba-4f16-9e51-08cae7bd134e.jpg",
"transform": null,
"conditions": [
{
"t_end": 0,
"lyrics": "[Instrumental]",
"prompt": null,
"t_start": 1,
"strength": 0.5,
"vibe_input": null,
"condition_end": 1,
"condition_start": 0
},
{
"t_end": 0,
"lyrics": null,
"prompt": "Celtic folk, haunting female vocals, acoustic instruments, ethereal harmonies",
"t_start": 1,
"strength": 0.5,
"vibe_input": null,
"condition_end": 1,
"condition_start": 0
}
],
"created_at": "2025-05-11T03:40:56.837963Z",
"duration_s": 178.19596371882085,
"play_count": 0,
"is_favorite": false,
"favorite_count": 0,
"image_override": null,
"parent_riff_id": null,
"audio_upload_id": null,
"audio_variation": null,
"remix_parent_id": null,
"simple_waveform": null,
"allow_public_use": true,
"lyrics_timestamped": {
"words": [
{
"end": 87.04,
"text": "[Instrumental]",
"start": 0.64,
"line_index": 0,
"index_range": null,
"wav2vec2_format": null
}
]
},
"model_display_name": "FUZZ-1.0"
},
{
"id": "0c7dcdb2-0a2a-4eb3-aaf2-dec1bf77b655",
"sound": "Celtic folk, ethereal female vocals, traditional instruments, haunting melodies",
"title": "Wise Paths",
"topic": "celtic folk song, timeless soul with deep emotion and powerful vocals, female singer",
"lyrics": "[Instrumental]",
"can_use": true,
"privacy": "unlisted",
"group_id": "",
"image_id": "0c7dcdb2-0a2a-4eb3-aaf2-dec1bf77b655",
"audio_b64": null,
"audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/edd3980f-3553-418b-8792-26f37406febd/audio/0c7dcdb2-0a2a-4eb3-aaf2-dec1bf77b655.m4a",
"author_id": "edd3980f-3553-418b-8792-26f37406febd",
"image_b64": null,
"image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/edd3980f-3553-418b-8792-26f37406febd/image/0c7dcdb2-0a2a-4eb3-aaf2-dec1bf77b655.jpg",
"transform": null,
"conditions": [
{
"t_end": 0,
"lyrics": "[Instrumental]",
"prompt": null,
"t_start": 1,
"strength": 0.5,
"vibe_input": null,
"condition_end": 1,
"condition_start": 0
},
{
"t_end": 0,
"lyrics": null,
"prompt": "Celtic folk, ethereal female vocals, traditional instruments, haunting melodies",
"t_start": 1,
"strength": 0.5,
"vibe_input": null,
"condition_end": 1,
"condition_start": 0
}
],
"created_at": "2025-05-11T03:40:55.580164Z",
"duration_s": 223.78607709750568,
"play_count": 0,
"is_favorite": false,
"favorite_count": 0,
"image_override": null,
"parent_riff_id": null,
"audio_upload_id": null,
"audio_variation": null,
"remix_parent_id": null,
"simple_waveform": null,
"allow_public_use": true,
"lyrics_timestamped": {
"words": [
{
"end": 79.36,
"text": "[Instrumental]",
"start": 0.64,
"line_index": 0,
"index_range": null,
"wav2vec2_format": null
}
]
},
"model_display_name": "FUZZ-1.0"
}
],
"created_at": "2025-05-11T03:39:41.000Z"
}
]
if task failed, the status = failed and ['data']['reason'] will give a reason of failure.
[
{
"status": "failed",
"task_id": "0196bdae-7fa9-7000-b8d7-987519774a05",
"gen_params": {
"topic": "fuck you , shit.",
"instrumental": "false"
},
"data": {
"data": {},
"reason": "moderation",
"is_flagged": true,
"musician_replacement_data": null
},
"created_at": "2025-05-11T04:50:51.000Z"
}
]
field
status, enum type,pending,processing,queued,completed,failed