Suno

AI-powered music generation with vocals and instrumentals

Suno

Professional AI music generation with multiple model versions.

Model ID

suno

Price

$0.12/use

Speed

2-3 minutes

Output

2 tracks/task

Model Versions

Version	Features
`V4`	Standard quality
`V4_5`	Improved quality
`V4_5PLUS`	Enhanced controls
`V4_5ALL`	All V4.5 features
`V5`	Latest, highest quality

Parameters

For common parameters (request_type, callback_url), see Request Format.

Core Parameters

Parameter	Type	Required	Default	Description
`mode`	string	Yes	-	Model version (see above)
`customMode`	boolean	Yes	`false`	Enable advanced controls
`instrumental`	boolean	Yes	`false`	`true` for no vocals
`prompt`	string	Conditional	-	Lyrics or creative brief
`style`	string	Conditional	-	Musical genres/moods
`title`	string	Conditional	-	Track title (max 80 chars)

Advanced Parameters

Parameter	Type	Range	Description
`negativeTags`	string	-	Styles to avoid
`styleWeight`	number	0-1	Style adherence strength
`weirdnessConstraint`	number	0-1	Creative deviation
`audioWeight`	number	0-1	Audio vs lyrical balance
`vocalGender`	string	`m`/`f`	Vocal gender preference

Examples

Simple Mode (Quick Start)

curl -X POST https://api.apixo.ai/api/v1/generateTask/suno \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "callback",
    "callback_url": "https://your-server.com/webhook",
    "input": {
      "mode": "V5",
      "customMode": false,
      "instrumental": false,
      "prompt": "An upbeat pop song about summer adventures"
    }
  }'

Custom Mode with Lyrics

curl -X POST https://api.apixo.ai/api/v1/generateTask/suno \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "callback",
    "callback_url": "https://your-server.com/webhook",
    "input": {
      "mode": "V5",
      "customMode": true,
      "instrumental": false,
      "prompt": "[Verse]\nWalking down the street\nFeeling the beat\n[Chorus]\nThis is our time\nMake it sublime",
      "style": "Pop, Electronic, Upbeat",
      "title": "Our Time"
    }
  }'

Instrumental Only

curl -X POST https://api.apixo.ai/api/v1/generateTask/suno \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "callback",
    "callback_url": "https://your-server.com/webhook",
    "input": {
      "mode": "V5",
      "customMode": true,
      "instrumental": true,
      "style": "Lo-fi, Jazz, Chill",
      "title": "Midnight Coffee"
    }
  }'

Response Format

Suno returns 2 tracks per request:

{
  "resultUrls": [
    {
      "image_url": "https://cdn2.suno.ai/cover1.jpeg",
      "audio_url": "https://cdn1.suno.ai/track1.mp3"
    },
    {
      "image_url": "https://cdn2.suno.ai/cover2.jpeg",
      "audio_url": "https://cdn1.suno.ai/track2.mp3"
    }
  ]
}

Tips

Recommended: Use callback mode (webhooks) for Suno
Polling: Wait 90 seconds, then poll every 10 seconds
Timeout: Set max wait to 5 minutes
Generated assets available for 14 days—download promptly
Start with customMode: false if new to the API
For vocals with custom lyrics, use [Verse], [Chorus] tags in prompt

Suno

On this page