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.025

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

You can set lyrics to "", or "[Instrumental]".

{
  "lyrics": "",
  "tags": "jazz"
}

Lyrics

{
	"lyrics": "[Verse 1]\nIn waves of starlit magic\n.....",
	"tags": "pop, dream pop, female vocals"
}

Extend

not available now 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

Here is response data struction

[
  {
    "status":"processing","task_id":"e1f21982-5191-4ca5-91d6-82929348ce71",
    "gen_params":
      {
        "tags":"Bachata,Upbeat,Synthesizer,Escape,Slow rhythm","lyrics":"lyrics"
      },
    "data":null,
    "created_at":"2026-02-24T13:50:53.000Z"
  }
]

queued

[
  {
    "status": "queued",
    "task_id": "0196bd6d-57a4-7000-96c6-f74ee7998e5f",
    "gen_params":
      {
        "tags":"Bachata,Upbeat,Synthesizer,Escape,Slow rhythm","lyrics":"lyrics"
      },
    "data": [
      "c1f6747a-49ba-4f16-9e51-08cae7bd134e",
      "0c7dcdb2-0a2a-4eb3-aaf2-dec1bf77b655"
    ],
    "created_at": "2025-05-11T03:39:41.000Z"
  } 
]

completed

Once the status = completed, you can find the result in the data field.

you can open the following url in the brower and view it clearly.

https://cdn2.foxai.me/producer-ai/019c8fec-a072-7000-bcd3-829eb9ef3617.json

Response

failed

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": {
     "reason": "moderation"
   },
   "created_at": "2025-05-11T04:50:51.000Z"
 }
]

field

• status, enum type, pending, processing, queued, completed, failed