FUZZ 2.0 Primitive (return 1 song)
Billing Rules
Each generate requestion returns 1 task id, and each task id can be used to 1 song. Each generate requestion costs $0.013
Basic Configuration
Base URL: https://api.foxaihub.com/api/v2/fuzz-primitive
Headers Parameters
{
"api-key": "Your API Key",
}
Submit the song 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-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": [
"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": "019bc1a6-a026-7000-b9ef-f4b4ccf9e72f",
"gen_params": {
"tags": "jazz, female vocals",
"extend": {
"song_id": "5b2e5624-87d7-4356-987b-5c63e508f22d",
"start_s": 125.61822,
"extend_duration_s": 30
},
"lyrics": "OK, OKOK, OKOKOKOKOKOKOKOK \n OKOKOKOKOKOKOKOKO KOKOKOKOKOK OKOKOKOKOKOKOKOK"
},
"data": [
{
"id": "b030690a-aa6b-4fd9-b7bb-ee0c9d422aac",
"group_id": "",
"author_id": "6b41042a-8f70-41db-adcb-3b585f237e19",
"created_at": "2026-01-15T12:35:06.800210Z",
"audio_variation": null,
"lyrics": "OK, OKOK, OKOKOKOKOKOKOKOK\nOKOKOKOKOKOKOKOKO KOKOKOKOKOK OKOKOKOKOKOKOKOK",
"title": "OK, OKOK, OKOKOKOKOKOKOKOK",
"image_override": null,
"sound": "jazz, female vocals",
"topic": null,
"image_id": "b030690a-aa6b-4fd9-b7bb-ee0c9d422aac",
"simple_waveform": null,
"remix_parent_id": null,
"duration_s": 153.80897959183673,
"privacy": "unlisted",
"transform": "extend",
"parent_riff_id": "5b2e5624-87d7-4356-987b-5c63e508f22d",
"audio_upload_id": null,
"model_display_name": "FUZZ-2.0",
"is_favorite": false,
"favorite_count": 0,
"play_count": 0,
"allow_public_use": true,
"can_use": true,
"audio_b64": null,
"image_b64": null,
"video_id": null,
"seed": null,
"conditions": [
{
"prompt": null,
"lyrics": "OK, OKOK, OKOKOKOKOKOKOKOK \n OKOKOKOKOKOKOKOKO KOKOKOKOKOK OKOKOKOKOKOKOKOK",
"vibe_input": null,
"voice_input": null,
"strength": 0.7,
"condition_start": 0,
"condition_end": 1,
"t_start": 1,
"t_end": 0
},
{
"prompt": "jazz, female vocals",
"lyrics": null,
"vibe_input": null,
"voice_input": null,
"strength": 0.7,
"condition_start": 0,
"condition_end": 1,
"t_start": 1,
"t_end": 0
}
],
"lyrics_timestamped": {
"words": [
{
"text": "OK,",
"start": 4.458219999999991,
"end": 4.458231292517007,
"line_index": 0,
"index_range": null,
"wav2vec2_format": null,
"space_after": true
},
{
"text": "OKOK,",
"start": 4.458219999999991,
"end": 5.201269841269841,
"line_index": 0,
"index_range": null,
"wav2vec2_format": null,
"space_after": true
},
{
"text": "OKOKOKOKOKOKOKOK",
"start": 5.201258548752826,
"end": 28.978503401360545,
"line_index": 0,
"index_range": null,
"wav2vec2_format": null,
"space_after": true
},
{
"text": "OKOKOKOKOKOKOKOKO",
"start": 28.97849210884353,
"end": 28.978503401360545,
"line_index": 1,
"index_range": null,
"wav2vec2_format": null,
"space_after": true
},
{
"text": "KOKOKOKOKOK",
"start": 28.97849210884353,
"end": 129.2887074829932,
"line_index": 1,
"index_range": null,
"wav2vec2_format": null,
"space_after": true
},
{
"text": "OKOKOKOKOKOKOKOK",
"start": 129.28869619047617,
"end": 145.63555555555556,
"line_index": 1,
"index_range": null,
"wav2vec2_format": null,
"space_after": true
}
]
},
"audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/6b41042a-8f70-41db-adcb-3b585f237e19/audio/b030690a-aa6b-4fd9-b7bb-ee0c9d422aac.m4a",
"image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/6b41042a-8f70-41db-adcb-3b585f237e19/image/b030690a-aa6b-4fd9-b7bb-ee0c9d422aac.jpg",
"video_url": null
}
],
"created_at": "2026-01-15T12:34: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