Generate Music

Music Generation Modes

Price per generation 0.10$

API Endpoint for Music Generation

To generate music using our service, send a POST request to the following endpoint:

https://api.unifically.com/suno/generate

1. Inspiration Mode

Utilize the "Inspiration Mode" for generating purely instrumental music tracks or for receiving song prompts. This mode allows the creation of inspirational content using a specified prompt.

Example JSON:

{
    "gpt_description_prompt": "A cheerful magnetic voice song"
}

2. Custom Mode

"Custom Mode" enables the crafting of songs with specific lyrics, titles, and genre tags. This mode provides the flexibility to create tailored musical pieces.

Example JSON:

{
    "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest... (continue with lyrics)",
    "tags": "emotional punk",
    "mv": "chirp-v3-0",
    "title": "City Lights"
}

3. Continuation

The "Continuation" feature is designed to extend an existing song by adding more duration or elaborating further on the music creation process.

Example JSON:

{
  "prompt": "[Verse 1]\nCruel flames of war engulf this land\nBattlefields filled with death and dread\nInnocent souls in darkness, they rest\nMy heart trembles in this silent test\n\n[Verse 2]\nPeople weep for loved ones lost\nBattered bodies bear the cost\nSeeking peace and hope once known\nOur grief transforms to hearts of stone\n\n[Chorus]\nSilent battlegrounds, no birds' song\nShadows of war, where we don't belong\nMay flowers of peace bloom in this place\nLet's guard this precious dream with grace\n\n[Bridge]\nThrough the ashes, we will rise\nHand in hand, towards peaceful skies\nNo more sorrow, no more pain\nTogether, we'll break these chains\n\n[Chorus]\nSilent battlegrounds, no birds' song\nShadows of war, where we don't belong\nMay flowers of peace bloom in this place\nLet's guard this precious dream with grace\n\n[Outro]\nIn unity, our strength will grow\nA brighter future, we'll soon know\nFrom the ruins, hope will spring\nA new dawn, we'll together bring",
  "tags": "pop metal male melancholic",
  "negative_tags": "female edm techno",
  "title": "Silent Battlefield",
  "make_instrumental": false,
  "model": "chirp-v3-5|chirp-v3-0|chirp-bluejay|chirp-auk",  //auk(4.5)  bluejay(4.5+)
}

The response example provides a typical JSON response format that indicates the success of an operation along with a unique identifier. Here’s a breakdown of the fields:

  • success: A boolean indicating whether the operation was completed successfully. true signifies success.

  • id: A unique identifier, typically a UUID, associated with the operation outcome, useful for tracking or referencing purposes.

  • {
        "success": true,
        "id": "62fe70fa-c8a3-4117-80e5-037803d6825c"
    }

    Use this structure when handling responses to ensure consistent error handling and logging.

Parameter
Overview

make_instrumental

Purely instrumental music in inspiration mode.

gpt_desc_prompt

Song prompts for inspiration mode.

mv

Model version, e.g., chirp-v3-0, chirp-v3-5, chirp-auk (v4.5), chirp-bluejay (v4.5+)

prompt

Lyrics in custom mode; empty string for instrumental music.

title

Song title in custom mode.

tags

Style or genre tags in custom mode.

task_id

ID to perform actions on a previous task.

continue_at

Extend song duration by specified seconds.

continue_clip_id

ID of the song to continue or extend.

notify_hook

Callback notification URL.

Last updated