Producer API Documentation

Producer API provides advanced AI-powered music generation capabilities through a simple text-to-music interface. Generate, extend, remix, and manipulate audio tracks with professional-grade quality.

Base Path: /api/v1/producer/*

Why Choose Producer API?

🎯 Suno v5 Quality at Lightning Speed

Producer API delivers music quality comparable to Suno v5, but with significantly faster generation times:

Quality: FUZZ-2.0 model produces studio-grade music that rivals Suno v5 in clarity, dynamics, and musical coherence

Speed: Generate tracks in ~30 seconds vs. typical 2-3 minutes with other platforms

Cost-Effective: 10 credits per task with consistent pricing across all model versions

Key Features

🎵 High-Quality Music Generation - Create vocals, instrumentals, and full tracks with studio-quality output matching Suno v5 standards

🧠 Advanced AI Models - Powered by the latest FUZZ-2.0 model, delivering exceptional quality with superior processing efficiency

⚡ Ultra-Fast Generation - Generate professional tracks in approximately 30 seconds, dramatically faster than competing platforms

🔁 Multiple Operations - Create, extend, cover, replace, vocal/instrumental swap, and variation support

🧩 Simple Interface - Intuitive API with just two core parameters: sound and lyrics

💰 Predictable Pricing - Flat 10 credits per task regardless of operation type or model version

Authentication & Endpoints

Base Configuration

Base URL: /api/v1/producer

Required Headers:

Authorization: Bearer <YOUR_MUSICAPI_KEY>

Content-Type: application/json

Available Endpoints

Create Task: POST /api/v1/producer/create

Query Task: GET /api/v1/producer/task/{task_id}

Pricing & Rate Limits

Cost: 10 credits per task (create, extend, cover, replace, swap, or variation)

Query Tasks: Free - no credit cost for checking task status

Rate Limits: Please implement reasonable polling intervals to avoid excessive requests

API Parameters

Request Body Schema

Parameter	Type	Required	Description
`task_type`	string	Yes	Task type: `create_music`, `extend_music`, `cover_music`, `replace_music`, `swap_music_vocals`, `swap_music_sound`, `music_variation`
`sound`	string	No*	Audio style prompt describing the desired sound. *Required if `lyrics` is empty
`lyrics`	string	No*	Song lyrics text. *Required if `sound` is empty
`make_instrumental`	boolean	No	Generate instrumental only (ignores lyrics). Default: `false`
`mv`	string	No	Model version: `FUZZ-2.0`, `FUZZ-2.0 Raw`, `FUZZ-1.1 Pro`, `FUZZ-1.1`, `FUZZ-1.0 Pro`, `FUZZ-1.0`, `FUZZ-0.8`. Default: `FUZZ-2.0`
`title`	string	No	Track title (max 80 characters)
`cover_url`	string	No	Custom cover image URL
`seed`	string	No	Random seed for reproducible generation
`lyrics_strength`	number	No	Lyrics adherence strength (0-1). Default: `0.5`
`sound_strength`	number	No	Sound prompt strength (0.2-1). Default: `0.5`
`weirdness`	number	No	Creative variation level (0-1). Default: `0.5`
`clip_id`	string	No**	Parent clip ID. **Required for: extend, cover, replace, swap, and variation tasks
`starts_at`	number	No	Start time in seconds (extend default: 30; replace: start point of replacement)
`ends_at`	number	No	End time in seconds (replace only; omit to replace until end)
`cover_strength`	number	No	Cover intensity for cover/swap operations (0.2-1)

⚠️ Important: The sound parameter can be used independently to achieve prompt-based generation similar to description/prompt mode.

🔴 Critical Parameter Guidelines

The Producer API requires high-quality, meaningful input to ensure successful generation. Please follow these guidelines carefully:

Sound Parameter

✅ DO: Provide detailed, descriptive prompts (e.g., "upbeat pop song with electronic synths and catchy melody")

✅ DO: Use specific musical terminology (genres, instruments, mood, tempo)

✅ DO: Write at least 5-10 words for better results

❌ DON'T: Use vague or minimal text (e.g., "music", "song", "test")

❌ DON'T: Submit random characters or placeholder text

❌ DON'T: Leave it empty unless lyrics are provided

Lyrics Parameter

✅ DO: Provide complete, well-structured lyrics with proper formatting

✅ DO: Include verse/chorus markers (e.g., "[Verse 1]", "[Chorus]")

✅ DO: Write meaningful, coherent lyrics (at least 20-30 words minimum)

❌ DON'T: Submit incomplete fragments or single words

❌ DON'T: Use nonsensical or random text as lyrics

❌ DON'T: Submit test strings like "test", "aaa", "123"

Why This Matters

Due to the advanced nature of our AI models, low-quality or insufficient input may result in task failures. The system expects realistic, production-ready content to generate high-quality music. Random or placeholder content can cause generation errors and waste your credits.

Examples

Good Sound Prompts:

"Energetic rock anthem with distorted electric guitars, driving drums, and powerful vocals"
"Calm ambient meditation music with soft piano, gentle strings, and nature sounds"
"90s hip-hop beat with vinyl scratches, deep bass, and smooth jazz samples"

Good Lyrics:

[Verse 1]
Walking through the city lights
Feeling the rhythm of the night
Every step a new surprise
Under these electric skies

[Chorus]
We're alive, we're free tonight
Dancing till the morning light

Poor Examples (Avoid These):

❌ sound: "music"
❌ sound: "test"
❌ lyrics: "la la la"
❌ lyrics: "test lyrics here"

Usage Examples

1. Create Music (Sound Only)

2. Extend Music

3. Cover Music

4. Replace Music Section

5. Swap Vocals

6. Swap Instrumentals

7. Create Variation

Task Query & Response

Query Task Status

Response Examples

Success (200 OK)

{
  "code": 200,
  "data": [
    {
      "clip_id": "abc123",
      "title": "Epic Orchestral Trailer",
      "sound": "epic orchestral trailer with choirs",
      "lyrics": "",
      "image_url": "https://...",
      "audio_url": "https://...",
      "video_url": "https://...",
      "created_at": "2025-10-01T12:00:00Z",
      "mv": "FUZZ-2.0",
      "duration": 30.5
    }
  ]
}

Processing (202 Accepted)

{
  "code": 202,
  "type": "not_ready",
  "error": "Task is still processing. Please wait a few seconds and try again."
}

Error (500 Internal Server Error)

{
  "code": 500,
  "error": "Internal Server Error"
}

HTTP Status Codes

Code	Status	Description
200	OK	Task completed successfully
202	Accepted	Task is still processing, query again later
400	Bad Request	Invalid parameters or validation error
401	Unauthorized	Invalid or missing API key
403	Forbidden	Insufficient credits or permission denied
404	Not Found	Task not found
500	Internal Server Error	Server error occurred

Available Models

The mv parameter accepts the following model versions:

FUZZ-2.0 (Default) - Latest model with best quality

FUZZ-2.0 Raw - Raw output without post-processing

FUZZ-1.1 Pro - Enhanced version of 1.1

FUZZ-1.1 - Stable production model

FUZZ-1.0 Pro - Enhanced version of 1.0

FUZZ-1.0 - Previous stable release

FUZZ-0.8 - Legacy model

Best Practices

Polling Strategy

Recommended interval: Query task status every 5-10 seconds

Fast completion: Most tasks complete within 30-60 seconds with FUZZ-2.0

Timeout: Consider implementing a timeout after 2-3 minutes for optimal UX

Error handling: Implement exponential backoff for rate limiting

Optimization Tips

Production use: FUZZ-2.0 delivers the best balance of quality and speed (recommended)

Reproducibility: Use the seed parameter for consistent results during testing and A/B testing

Fine-tuning: Adjust sound_strength (0.2-1.0) and lyrics_strength (0-1.0) to control output characteristics

Creative control: Use weirdness parameter sparingly (0-1.0) - higher values increase variation but reduce predictability

Legacy support: Older models (FUZZ-1.1, FUZZ-1.0) available for compatibility but FUZZ-2.0 is faster and higher quality

Performance Advantages

Rapid iteration: ~30 second generation time enables real-time creative workflows

Batch processing: Process multiple tracks simultaneously without long wait times

Production ready: Consistent Suno v5-level quality with enterprise-grade reliability

Credit Management

Flat pricing: 10 credits per task across all operations and model versions

Free queries: Task status checks never consume credits - poll as needed

Batch operations: Check credit balance before initiating multiple concurrent tasks

Cost predictability: No hidden fees or variable pricing based on output length

Producer Instructions

Producer API Documentation

Why Choose Producer API?

🎯 Suno v5 Quality at Lightning Speed

Key Features

Authentication & Endpoints

Base Configuration

Available Endpoints

Pricing & Rate Limits

API Parameters

Request Body Schema

🔴 Critical Parameter Guidelines

Sound Parameter

Lyrics Parameter

Why This Matters

Examples

Usage Examples

1. Create Music (Sound Only)

2. Extend Music

3. Cover Music

4. Replace Music Section

5. Swap Vocals

6. Swap Instrumentals

7. Create Variation

Task Query & Response

Query Task Status

Response Examples

Success (200 OK)

Processing (202 Accepted)

Error (500 Internal Server Error)

HTTP Status Codes

Available Models

Best Practices

Polling Strategy

Optimization Tips

Performance Advantages

Credit Management

Need Help?

join our discord channel : https://discord.gg/UFT2J2XK7d

Producer Instructions

Producer API Documentation#

Why Choose Producer API?#

🎯 Suno v5 Quality at Lightning Speed#

Key Features#

Authentication & Endpoints#

Base Configuration#

Available Endpoints#

Pricing & Rate Limits#

API Parameters#

Request Body Schema#

🔴 Critical Parameter Guidelines#

Sound Parameter#

Lyrics Parameter#

Why This Matters#

Examples#

Usage Examples#

1. Create Music (Sound Only)#

2. Extend Music#

3. Cover Music#

4. Replace Music Section#

5. Swap Vocals#

6. Swap Instrumentals#

7. Create Variation#

Task Query & Response#

Query Task Status#

Response Examples#

Success (200 OK)#

Processing (202 Accepted)#

Error (500 Internal Server Error)#

HTTP Status Codes#

Available Models#

Best Practices#

Polling Strategy#

Optimization Tips#

Performance Advantages#

Credit Management#

Need Help?#

join our discord channel : https://discord.gg/UFT2J2XK7d#

Producer API Documentation

Why Choose Producer API?

🎯 Suno v5 Quality at Lightning Speed

Key Features

Authentication & Endpoints

Base Configuration

Available Endpoints

Pricing & Rate Limits

API Parameters

Request Body Schema

🔴 Critical Parameter Guidelines

Sound Parameter

Lyrics Parameter

Why This Matters

Examples

Usage Examples

1. Create Music (Sound Only)

2. Extend Music

3. Cover Music

4. Replace Music Section

5. Swap Vocals

6. Swap Instrumentals

7. Create Variation

Task Query & Response

Query Task Status

Response Examples

Success (200 OK)

Processing (202 Accepted)

Error (500 Internal Server Error)

HTTP Status Codes

Available Models

Best Practices

Polling Strategy

Optimization Tips

Performance Advantages

Credit Management

Need Help?

join our discord channel : https://discord.gg/UFT2J2XK7d