Song API Task Creation Examples

This document provides examples and descriptions for tasks supported by the Song API. Below are the available modes and configurations for music-u.

Music-u (Udio API)

Currently, the music-u model supports only the generate_music task. Below are the task examples for different use cases:

Request Body Example of Udio Simple Prompt

This mode generates music based on a textual description prompt. It is similar to Suno's description mode.

{
    "model": "music-u",
    "task_type": "generate_music",
    "input": {
        "gpt_description_prompt": "night breeze, piano",
        "negative_tags": "",
        "lyrics_type": "generate",
        "seed": -1
    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    }
}

Request Body Example of Udio Instrumental

This mode generates instrumental music.

{
    "model": "music-u",
    "task_type": "generate_music",
    "input": {
        "gpt_description_prompt": "night breeze",
        "negative_tags": "",
        "lyrics_type": "instrumental",
        "seed": -1

    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    }
}

Request Body Example of Udio Full Lyrics

This mode generates music using user-provided lyrics.

{
    "model": "music-u",
    "task_type": "generate_music",
    "input": {
        "lyrics": "[Verse]\nIn the gentle evening air,\nWhispers dance without a care.\nStars ignite our dreams above,\nWrapped in warmth, we find our love.\n[Chorus]\n",
        "gpt_description_prompt": "jazz, pop",
        "negative_tags": "",
        "lyrics_type": "user",
        "seed": -1
    },
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    }
}

Song API Task Creation Examples

Music-u (Udio API)#

Request Body Example of Udio Simple Prompt#

Request Body Example of Udio Instrumental#

Request Body Example of Udio Full Lyrics#

Music-u (Udio API)

Request Body Example of Udio Simple Prompt

Request Body Example of Udio Instrumental

Request Body Example of Udio Full Lyrics