Create Task

POST

https://api.piapi.ai/api/v1/task

INFO

The API to create song from text prompts - supporting models like Udio and others!

Unit Pricing

music-u: $0.05 / generation

Examples

Check here for different examples when using the Song API.

Request

Body Params application/json

model

enum<string>

required

model of the music api

Allowed value:

music-u

task_type

enum<string>

required

type of the task

Allowed values:

generate_musicgenerate_music_custom

input

object

required

prompt

string

optional

prompt of the music, check Examples

negative_tags

string

optional

negative tags of the music, seperate by comma, for example 'pop,rock'

gpt_description_prompt

string

optional

use in generate_music only, if

title

string

optional

title of the music

lyrics_type

enum<string>

required

used in music-u only, check Examples

Allowed values:

generateuserinstrumental

seed

number

optional

used in music-u only, check Examples

lyrics

string

optional

if lyrics_type is user, put full lyrics here

config

object

optional

webhook_config

object

optional

Example

{
    "model": "music-u",
    "task_type": "generate_music",
    "input": {
        "negative_tags": "veritatis",
        "gpt_description_prompt": "magna in id in eu",
        "lyrics_type": "instrumental",
        "seed": -25443934
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.piapi.ai/api/v1/task' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "music-u",
    "task_type": "generate_music",
    "input": {
        "negative_tags": "veritatis",
        "gpt_description_prompt": "magna in id in eu",
        "lyrics_type": "instrumental",
        "seed": -25443934
    }
}'

Responses

🟢200Success

application/json

Body

object {0}

Example

{}

Modified at 2025-05-06 09:11:07

Get Task

[Udio] Generate Lyrics

Create Task

Unit Pricing#

Examples#

Request

Request samples

Responses

Unit Pricing

Examples