Suno TTAPI Music Generator

Generate original music compositions using Suno TTAPI with access to the latest Suno model versions including v4 and v4.5. Features custom lyric support and advanced controls for professional music creation.

API Endpoint

POST /api/features

Parameters

Parameter	Type	Required	Description
type	string	Yes	Must be "MUSIC_GENERATOR"
model	string	Yes	Must be "suno-ttapi"
conversationId	string	No	Conversation ID for context
promptObject	object	Yes	Suno TTAPI-specific parameters

Prompt Object Parameters

Parameter	Type	Required	Description
mv	string	Yes	Model version: "chirp-v3-0", "chirp-v3-5", "chirp-v4", "chirp-v4-5"
custom	boolean	Yes	Whether to use custom mode (true) or auto mode (false)
prompt	string	Conditional	Required when custom is true - custom lyrics
gpt_description_prompt	string	Conditional	Required when custom is false - music description
instrumental	boolean	No	Whether to create instrumental version
title	string	No	Song title
tags	string	No	Genre tags, comma-separated

Model Versions

Version	Features	Best For
chirp-v4-5	Latest model with improved quality	Professional projects
chirp-v4	Advanced model with better coherence	High-quality music
chirp-v3-5	Enhanced v3 with stability improvements	Balanced quality/speed
chirp-v3-0	Original stable model	Basic music generation

Generation Modes

Custom Mode (custom: true)

• Provide your own lyrics
• Full control over song structure
• Best for specific lyrical content

Auto Mode (custom: false)

• AI generates lyrics from description
• Quick and simple generation
• Best for concept exploration

Interactive API Testing

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

Model Version *chirp-v4-5 - Latest and highest qualitychirp-v4 - Advanced model with better coherencechirp-v3-5 - Enhanced v3 with improvementschirp-v3-0 - Original stable model

Custom Mode *Auto Mode - AI generates lyrics from descriptionCustom Mode - Use your own lyrics

Music Description *upbeat indie rock song about chasing dreams

Instrumental No - Include vocals/lyricsYes - Instrumental only

Song Title

Genre Tags

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "MUSIC_GENERATOR",
  "model": "suno-ttapi",
  "conversationId": "MUSIC_GENERATOR",
  "promptObject": {
    "mv": "chirp-v4",
    "custom": false,
    "gpt_description_prompt": "upbeat indie rock song about chasing dreams",
    "prompt": "",
    "instrumental": false,
    "title": "",
    "tags": "indie rock, upbeat, dreams"
  }
}'

Response Format

Successful requests return:

{}

Key Features

Latest Model Versions

• v4.5: Cutting-edge quality with improved coherence and naturalness
• v4: Advanced model with better song structure and lyrical flow
• v3.5/v3.0: Stable options for reliable generation

Flexible Input Modes

• Custom Lyrics: Full control with your own written lyrics
• AI Descriptions: Let AI create lyrics from your description
• Instrumental Option: Create vocal or instrumental versions

Professional Controls

• Model Selection: Choose the right model version for your needs
• Genre Specification: Guide style with detailed tags
• Title Integration: Song titles influence the overall composition

Best Practices

1. Model Selection: Use v4.5 for best quality, v3.0 for faster generation
2. Custom vs Auto: Use custom mode for specific lyrics, auto mode for exploration
3. Descriptive Tags: Include genre, mood, and instrument preferences
4. Structured Lyrics: When using custom mode, structure lyrics with verses/choruses

Example Requests

Auto Mode Rock Song

{
  "type": "MUSIC_GENERATOR",
  "model": "suno-ttapi",
  "promptObject": {
    "mv": "chirp-v4-5",
    "custom": false,
    "gpt_description_prompt": "powerful rock anthem about overcoming obstacles and finding inner strength",
    "title": "Rise Above",
    "tags": "rock, anthem, powerful, guitar",
    "instrumental": false
  }
}

Custom Folk Song

{
  "type": "MUSIC_GENERATOR",
  "model": "suno-ttapi",
  "promptObject": {
    "mv": "chirp-v4",
    "custom": true,
    "prompt": "[Verse 1]\nBy the riverside where willows grow\nI found a place where time moves slow\nThe water whispers ancient tales\nOf love that never fails\n\n[Chorus]\nTake me to the river\nWhere my heart can heal\nIn the flowing water\nFind what's truly real",
    "title": "River Song",
    "tags": "folk, acoustic, peaceful, nature",
    "instrumental": false
  }
}

Instrumental Jazz

{
  "type": "MUSIC_GENERATOR",
  "model": "suno-ttapi",
  "promptObject": {
    "mv": "chirp-v4-5",
    "custom": false,
    "gpt_description_prompt": "sophisticated jazz composition with piano, bass, and subtle drums",
    "tags": "jazz, instrumental, piano, sophisticated",
    "instrumental": true
  }
}

Model Version Comparison

chirp-v4-5 (Recommended)

• Quality: Highest
• Coherence: Excellent song structure
• Naturalness: Most human-like vocals
• Use Case: Professional projects, final versions

chirp-v4

• Quality: High
• Coherence: Good song structure
• Features: Improved lyrical flow
• Use Case: Quality projects, detailed work

chirp-v3-5

• Quality: Good
• Stability: Enhanced reliability
• Speed: Faster than v4 models
• Use Case: Balanced quality/performance

chirp-v3-0

• Quality: Standard
• Reliability: Very stable
• Speed: Fastest generation
• Use Case: Quick prototypes, testing ideas