PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Endpoints
  2. Song(Suno+Udio)
  • Get Started
    • Overview
    • Quickstart
  • Endpoints
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Text to Image
        • Image to Image
      • Get task
    • AI Hug
      • Get Task
      • Create Task
    • LLM
      • How To Find GPTs Gizmo Name?
      • How To Avoid Timeouts in Completion API
      • Deepseek Models
      • LLM API | Basic Completions
      • Get Task
    • Midjourney
      • PiAPI Penalties on Midjourney Usage
      • Detailed Explaination on Midjourney Task Result
      • Create Task
        • Imagine
        • Upscale
        • Variation
        • Reroll
        • Describe
        • Seed
        • Blend
        • Inpaint
        • Outpaint
        • Pan
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
    • Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Song(Suno+Udio)
      • Song API Task Creation Examples(Suno and Udio)
      • [Udio] Song Extend
      • Get Task
        GET
      • Create Task
        POST
      • [Suno] Generate Full Song
        POST
      • [Suno] Song Extend
        POST
      • [Suno] Upload Audio
        POST
      • [Suno] Generate Lyrics
        POST
      • [Udio] Generate Lyrics
        POST
    • Trellis
      • Create Task
      • Get Task
    • Luma Dream Machine
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Create Task
      • Get Task
    • Kling
      • Lipsync With PiAPI Kling API Examples
      • Motion Brush With PiAPI Kling API Example
      • Kling Elements Video Generation API
      • Kling Effects Video Generation
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Get Task
      • Create Task
      • Kling Virtual Try-On
    • Hailuo
      • Hailuo Director Mode Example
      • Generate Video
      • Get Task
    • Skyreels
      • Create Task
      • Get Task
    • WanX
      • Create Task
      • Get Task
    • Hunyuan Video
      • Generate Video
      • Get Task
    • PiAPI Account Management
      • PiAPI Account Info
      • Task List Info
    • Mmaudio
      • Get Task
      • Generate Audio
    • DiffRhythm
      • Generate Audio
      • Get Task
    • Tools
      • File Upload API
      • Video Upscale
      • Video Upscale-Get Task
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
    • Bulk Generation Service
    • Billings
    • Workspace Manual
      • Host-your-account (HYA) | Back-up Account
      • Host-your-account (HYA) | Debug Checklist
      • Host-your-account (HYA) | Connected Account Status
    • Announcements
      • PiAPI 2025 January 1st Pricing Update
  • Legacy Documentation
    • Midjourney
      • Midjourney Webhook
      • Imagine
      • Reroll
      • Upscale
      • Variation
      • Inpaint
      • Outpaint
      • Pan
      • Describe
      • Blend
      • Seed
      • Fetch
      • Multi Fetch
      • Cancel
    • Face Swap
      • Video Faceswap
      • Multi-face-swap
      • Fetch
    • Dream Machine
      • Video Generation
      • Video Extend
      • Get Video Generation
    • Kling
      • Video Generation
      • Video Extend
      • Get Video Generation
  1. Endpoints
  2. Song(Suno+Udio)

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-s: $0.045 / generation (default version is V4)
music-u: $0.045 / 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 values:
music-umusic-s
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'
tags
string 
optional
tags of the music, seperate by comma
gpt_description_prompt
string 
optional
use in generate_music only
title
string 
optional
title of the music
make_instrumental
boolean 
optional
set to true if you want intrumental melody only
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
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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-03-24 15:59:07
Previous
Get Task
Next
[Suno] Generate Full Song