Complete Request Example

Producer API - Complete Request Examples

This document provides comprehensive request body examples for all Producer API operations. Each example includes detailed explanations and best practices.

---

Table of Contents

1. Create Music (with Lyrics)
2. Create Music (with Description/Sound)
3. Create Instrumental Music
4. Extend Music
5. Cover Music
6. Replace Music Section
7. Music Variation
8. Swap Music Vocals
9. Swap Music Sound
10. Advanced Custom Parameters
11. Upload Audio
12. Download MP3/WAV
13. Webhook Integration

---

1. Create Music (with Lyrics)

Generate music with complete lyrics and optional style description.

Endpoint

POST /api/v1/producer/create

Request Body

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "lyrics": "[Verse 1]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nWhere only love grows\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNight will divide my in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
  "sound": "pop",
  "title": "Starry Night",
  "make_instrumental": false
}

Parameters Explanation

• task_type: create_music - Creates a new music track
• mv: FUZZ-2.0 - Uses the default high-quality model
• lyrics: Complete song lyrics with verse/chorus structure
• sound: Music style descriptor (e.g., "pop", "rock", "jazz")
• title: Song title (max 80 characters)
• make_instrumental: false - Include vocals

Best Practices

• Provide complete, well-structured lyrics (minimum 20-30 words)
• Use proper formatting with [Verse], [Chorus], [Bridge] markers
• Include line breaks (\n) for proper lyric structure
• The sound parameter helps define the musical style

---

2. Create Music (with Description/Sound)

Generate music using only style descriptions without lyrics (instrumental or vocal improvisation).

Endpoint

POST /api/v1/producer/create

Request Body

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "upbeat electronic dance music with energetic synths, pulsing bass, and driving four-on-the-floor beat, perfect for club atmosphere with euphoric buildups and drops",
  "make_instrumental": false
}

Alternative Examples

Example 1: Ambient Meditation

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "peaceful ambient meditation music with soft piano melodies, gentle nature sounds, flowing water, and calming atmospheric pads for deep relaxation",
  "title": "Inner Peace",
  "make_instrumental": true
}

Example 2: Rock Anthem

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0 Pro",
  "sound": "powerful rock anthem with distorted electric guitars, thundering drums, heavy bass, and energetic male vocals singing about overcoming challenges",
  "title": "Rise Up",
  "make_instrumental": false
}

Example 3: Jazz Lounge

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "smooth jazz lounge music with sultry saxophone, soft piano chords, brushed drums, and upright bass creating a sophisticated late-night atmosphere",
  "title": "Midnight Blues",
  "make_instrumental": true
}

Example 4: Using Lyria 3 preview

{
  "task_type": "create_music",
  "mv": "Lyria 3 preview",
  "sound": "Energetic pop rock with electric guitar and drums",
  "lyrics": "[Verse]\nWalking through the city lights\nFeeling like I own the night\n\n[Chorus]\nWe are unstoppable tonight",
  "title": "Unstoppable"
}

Best Practices

• Write detailed, descriptive prompts (minimum 10-20 words)
• Include specific instruments, mood, tempo, and genre
• Mention vocal style if make_instrumental is false
• Be specific about the atmosphere or emotion you want

---

3. Create Instrumental Music

Generate pure instrumental tracks without vocals.

Endpoint

POST /api/v1/producer/create

Request Body

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "cinematic orchestral score with soaring strings, powerful brass section, epic percussion, and dramatic crescendos perfect for movie trailer",
  "title": "Epic Journey",
  "make_instrumental": true
}

Alternative Examples

Example 1: Classical Piano

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "classical piano solo with delicate melodic phrases, emotional dynamics, and romantic period styling reminiscent of Chopin",
  "title": "Moonlight Sonata Redux",
  "make_instrumental": true,
  "lyrics_strength": 0.3,
  "sound_strength": 0.8
}

Example 2: Electronic Chillout

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "downtempo electronic chillout with warm analog synths, subtle glitch effects, deep sub bass, and atmospheric textures",
  "title": "Digital Dreams",
  "make_instrumental": true,
  "weirdness": 0.6
}

Best Practices

• Set make_instrumental to true to ensure no vocals
• Provide detailed descriptions of desired instruments and mood
• Use sound_strength to control how strictly the model follows your description

---

4. Extend Music

Continue an existing music track from a specific timestamp.

Endpoint

POST /api/v1/producer/create

Request Body

{
  "task_type": "extend_music",
  "clip_id": "abc123xyz789",
  "mv": "FUZZ-2.0",
  "sound": "add soaring violin strings and uplifting orchestral build with increasing intensity",
  "lyrics": "[Outro]\nReaching for the stars above\nFeeling endless love\nThis is just the start\nOf our journey's heart",
  "starts_at": 45
}

Alternative Examples

Example 1: Rock Song Extension

{
  "task_type": "extend_music",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "sound": "explosive guitar solo with wah-wah effect, building to a powerful final chorus",
  "starts_at": 60
}

Example 2: Ambient Extension

{
  "task_type": "extend_music",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "sound": "gradually fade into peaceful silence with gentle reverb and soft wind chimes",
  "lyrics": "[Bridge]\nSoftly falling\nDreams are calling\nPeace is near",
  "starts_at": 90,
  "sound_strength": 0.6,
  "lyrics_strength": 0.7
}

Parameters Explanation

• clip_id: Required - The ID of the track to extend (from previous generation)
• starts_at: Start time in seconds (default: 30)
• sound: Description of how to extend the music
• lyrics: Optional additional lyrics for the extension

Best Practices

• Use the clip_id from a successfully generated track
• Provide clear direction for the extension in sound parameter
• starts_at typically ranges from 30-90 seconds
• Include lyrics if you want to add a new verse or outro

---

5. Cover Music

Create a new version of an existing track with different style or arrangement.

Endpoint

POST /api/v1/producer/create

Request Body

{
  "task_type": "cover_music",
  "clip_id": "abc123xyz789",
  "mv": "FUZZ-2.0",
  "sound": "emotional female ballad with piano accompaniment and soft strings, intimate and heartfelt performance",
  "lyrics": "[Verse 1]\nIn the quiet of the evening\nWhen the world slows down\nI hear your voice calling\nThrough the silence all around\n\n[Chorus]\nYou're my everything\nMy reason to believe\nIn this crazy world\nYou're all I need",
  "cover_url": "https://example.com/cover-art.jpg",
  "cover_strength": 0.8
}

Alternative Examples

Example 1: Acoustic Cover

{
  "task_type": "cover_music",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "sound": "stripped down acoustic version with fingerpicked guitar and raw male vocal, intimate coffee shop style",
  "lyrics": "[Verse 1]\nWhen the morning comes alive\nAnd the sun begins to rise\nI think of you and smile\nKnowing you're by my side\n\n[Chorus]\nEvery moment feels so right\nWith you here day and night",
  "cover_strength": 0.7,
  "title": "Acoustic Version"
}

Example 2: Electronic Remix Style

{
  "task_type": "cover_music",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0 Pro",
  "sound": "modern electronic pop remix with synthesizers, vocoder effects, dance beat, and club-ready production",
  "cover_strength": 0.9,
  "sound_strength": 0.8
}

Parameters Explanation

• clip_id: Required - Original track ID to create a cover from
• cover_strength: Intensity of the transformation (0.2-1.0)
  • Lower values (0.2-0.5): Subtle reinterpretation
  • Higher values (0.6-1.0): Dramatic reimagining
• sound: Detailed description of the new style
• lyrics: Can be the same or modified lyrics
• cover_url: Optional custom cover art URL

Best Practices

• Use cover_strength to control how different the cover sounds
• Provide detailed style descriptions in sound parameter
• You can keep original lyrics or provide new ones
• Consider the musical contrast you want to achieve

---

6. Replace Music Section

Replace a specific segment of an existing track with new content.

Endpoint

POST /api/v1/producer/create

Request Body

{
  "task_type": "replace_music",
  "clip_id": "abc123xyz789",
  "mv": "FUZZ-2.0",
  "sound": "heavy distorted guitar riff with double bass drums and aggressive energy",
  "lyrics": "[Bridge]\nBreak the chains\nFeel no pain\nRise again\nStronger than before",
  "starts_at": 30,
  "ends_at": 45
}

Alternative Examples

Example 1: Replace Chorus

{
  "task_type": "replace_music",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "sound": "uplifting major key change with gospel choir backing vocals and powerful dynamics",
  "lyrics": "[Chorus - New]\nWe will rise above it all\nStanding strong and standing tall\nNothing's gonna break our will\nWe'll keep climbing up that hill",
  "starts_at": 60,
  "ends_at": 90,
  "sound_strength": 0.8
}

Example 2: Replace to End

{
  "task_type": "replace_music",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "sound": "gradual fade out with ambient reverb and ethereal soundscape",
  "starts_at": 75
}

Parameters Explanation

• clip_id: Required - Track ID to modify
• starts_at: Required - Start time of replacement in seconds
• ends_at: Optional - End time in seconds (omit to replace until the end)
• sound: Description of the replacement content
• lyrics: Optional lyrics for the replaced section

Best Practices

• Precisely specify starts_at and ends_at for the section you want to replace
• If ends_at is omitted, replacement continues to the end of the track
• Ensure the new content fits stylistically with surrounding sections
• Use this for fixing specific parts or adding variation

---

7. Music Variation

Generate a different version of the same track with similar characteristics.

Endpoint

POST /api/v1/producer/create

Request Body

{
  "task_type": "music_variation",
  "clip_id": "abc123xyz789"
}

Alternative Examples

Example 1: Variation with Custom Model

{
  "task_type": "music_variation",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0 Raw"
}

Example 2: Variation with Seed

{
  "task_type": "music_variation",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "seed": "12345"
}

Parameters Explanation

• clip_id: Required - Original track ID
• mv: Optional model version (default: FUZZ-2.0)
• seed: Optional seed for reproducible variations

What Music Variation Does

• Creates an alternative version with similar style and structure
• Keeps the same general mood and genre
• Changes specific melodic elements, arrangement details, and production choices
• Useful for getting multiple options from the same musical concept

Best Practices

• Use variation to explore different interpretations of the same idea
• Great for A/B testing different versions
• Generate multiple variations to choose the best one
• Combine with different mv models for variety

---

8. Swap Music Vocals

Replace the vocal performance while keeping the instrumental track.

Endpoint

POST /api/v1/producer/create

Request Body

{
  "task_type": "swap_music_vocals",
  "clip_id": "abc123xyz789",
  "mv": "FUZZ-2.0",
  "sound": "smooth male pop vocal with subtle autotune effect, contemporary R&B style delivery with emotional runs and riffs",
  "lyrics": "[Verse 1]\nWhen I see you smile\nTime just stands still\nEvery moment with you\nIs a perfect thrill\n\n[Chorus]\nYou're the one I need\nYou're my everything\nWith you by my side\nI can spread my wings",
  "cover_strength": 0.9
}

Alternative Examples

Example 1: Opera Vocals

{
  "task_type": "swap_music_vocals",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "sound": "classical opera soprano with powerful vibrato and dramatic theatrical delivery, Italian bel canto technique",
  "lyrics": "[Aria]\nAmore mio eterno\nCuore che batte forte\nVita della mia vita\nAnima della mia anima",
  "cover_strength": 0.8,
  "lyrics_strength": 0.6
}

Example 2: Rap Vocals

{
  "task_type": "swap_music_vocals",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0 Pro",
  "sound": "confident hip-hop rap vocal with rhythmic flow and clear articulation, modern trap style delivery",
  "lyrics": "[Verse 1]\nYeah, I'm on the rise, no surprise\nGrind every day, that's how I survive\nStacking up wins, living my best\nPut me to the test, I'll pass with finesse\n\n[Hook]\nWe going up, up, never coming down\nMaking moves, taking over this town",
  "cover_strength": 0.85,
  "sound_strength": 0.9
}

Parameters Explanation

• clip_id: Required - Track ID to swap vocals on
• sound: Required - Detailed description of desired vocal style
• lyrics: Required - New or same lyrics for the vocals
• cover_strength: Intensity of vocal transformation (0.2-1.0)
  • Lower values (0.2-0.4): Subtle vocal style change
  • Medium values (0.5-0.7): Moderate vocal change
  • Higher values (0.8-1.0): Dramatic vocal reimagining

Best Practices

• Provide very detailed vocal descriptions (gender, style, technique, effects)
• You can keep the same lyrics or provide completely new ones
• Adjust cover_strength based on how different you want the vocals
• The instrumental track remains largely unchanged
• Great for gender swaps or genre transformations

---

9. Swap Music Sound

Replace the instrumental arrangement while keeping vocals similar.

Endpoint

POST /api/v1/producer/create

Request Body

{
  "task_type": "swap_music_sound",
  "clip_id": "abc123xyz789",
  "mv": "FUZZ-2.0",
  "sound": "ambient atmospheric pads with soft piano melodies, gentle reverb, and minimalist production creating an intimate soundscape",
  "lyrics": "[Verse 1]\nIn this quiet moment\nJust you and I\nWords left unspoken\nUnderneath the sky\n\n[Chorus]\nHold me close tonight\nNever let me go\nIn your arms I'm home\nThis is all I know",
  "cover_strength": 0.6
}

Alternative Examples

Example 1: Orchestral Arrangement

{
  "task_type": "swap_music_sound",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "sound": "full symphonic orchestra with lush string arrangements, French horns, woodwinds, and timpani, cinematic film score style",
  "cover_strength": 0.9,
  "sound_strength": 0.85
}

Example 2: Reggae Instrumentation

{
  "task_type": "swap_music_sound",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "sound": "classic reggae riddim with offbeat guitar skanks, deep dub bass, one-drop drum pattern, and organ stabs",
  "lyrics": "[Verse]\nUnder the sun we dance\nMoving to the rhythm's trance\nFeel the island breeze\nSwaying through the palm trees",
  "cover_strength": 0.75
}

Example 3: Synthwave Style

{
  "task_type": "swap_music_sound",
  "clip_id": "your-clip-id-here",
  "mv": "FUZZ-2.0",
  "sound": "retro 80s synthwave with analog synthesizers, gated reverb drums, arpeggiators, and nostalgic neon atmosphere",
  "cover_strength": 0.8,
  "weirdness": 0.4
}

Parameters Explanation

• clip_id: Required - Track ID to swap instrumentation on
• sound: Required - Detailed description of new instrumental style
• lyrics: Required - Lyrics (typically kept the same)
• cover_strength: Intensity of instrumental transformation (0.2-1.0)
  • Lower values (0.2-0.4): Subtle arrangement changes
  • Medium values (0.5-0.7): Moderate instrumentation swap
  • Higher values (0.8-1.0): Complete genre transformation

Best Practices

• Focus on instrumental descriptions (instruments, genre, production style)
• Keep lyrics the same unless you want to adjust phrasing
• Use this to transform a song's genre while maintaining vocal character
• Perfect for creating multiple versions (acoustic, orchestral, electronic, etc.)
• Adjust sound_strength to control how strictly the model follows your description

---

10. Advanced Custom Parameters

Leverage advanced parameters for fine-tuned control over generation.

Example 1: Maximum Creative Control

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "experimental electronic music with glitch elements and unconventional time signatures",
  "lyrics": "[Verse]\nBreaking all the patterns\nBending all the rules\nCreating new dimensions\nWith artistic tools",
  "title": "Digital Chaos",
  "lyrics_strength": 0.4,
  "sound_strength": 0.9,
  "weirdness": 0.8,
  "seed": "99999",
  "make_instrumental": false
}

Example 2: Precise Lyrical Focus

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "singer-songwriter style with acoustic guitar",
  "lyrics": "[Verse 1]\nThese words I wrote at midnight\nWhen the world was fast asleep\nPouring out my heart and soul\nSecrets that I keep\n\n[Chorus]\nEvery line tells a story\nEvery word rings true\nIn these melodies and harmonies\nI'm sharing me with you",
  "title": "Songwriter's Truth",
  "lyrics_strength": 0.9,
  "sound_strength": 0.5,
  "weirdness": 0.2
}

Example 3: High Quality Instrumental Focus

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0 Pro",
  "sound": "neoclassical piano composition with complex harmonies, dynamic contrasts, and virtuosic technical passages",
  "title": "Etude in D Minor",
  "lyrics_strength": 0,
  "sound_strength": 1.0,
  "weirdness": 0.3,
  "make_instrumental": true,
  "seed": "classical2025"
}

Example 4: Reproducible Results

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "upbeat pop rock with electric guitars and energetic drums",
  "lyrics": "[Chorus]\nThis is our moment\nThis is our time\nWe'll make it happen\nEverything's fine",
  "title": "Test Version A",
  "seed": "test-seed-12345",
  "lyrics_strength": 0.5,
  "sound_strength": 0.5,
  "weirdness": 0.5
}

Example 5: Cover Art and Metadata

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0",
  "sound": "modern pop ballad with emotional piano and strings",
  "lyrics": "[Verse 1]\nLooking at your photograph\nMemories come rushing back\nAll the moments that we shared\nHow I wished that you were there\n\n[Chorus]\nI miss you every day\nThough you're far away\nIn my heart you'll always stay",
  "title": "Memories of You",
  "cover_url": "https://example.com/album-art/memories.jpg",
  "lyrics_strength": 0.7,
  "sound_strength": 0.6
}

Advanced Parameters Explained

lyrics_strength (0-1, default: 0.5)

• 0-0.3: Very loose interpretation of lyrics, more melodic freedom
• 0.4-0.6: Balanced approach, standard adherence
• 0.7-1.0: Strict lyrical fidelity, lyrics are primary focus

sound_strength (0.2-1, default: 0.5)

• 0.2-0.4: Loose interpretation of style prompt
• 0.5-0.7: Balanced adherence to description
• 0.8-1.0: Strict adherence to sound description

weirdness (0-1, default: 0.5)

• 0-0.3: Conventional, predictable arrangements
• 0.4-0.6: Moderate creativity, some surprises
• 0.7-1.0: Experimental, unconventional, high variation

seed (string)

• Use the same seed for reproducible results
• Different seeds produce different variations
• Useful for A/B testing and version control

cover_url (string)

• Provide a direct URL to custom album art
• Must be a valid image URL (HTTPS recommended)
• Typical formats: JPG, PNG

Best Practices for Advanced Parameters

• Testing Phase: Use seed for consistent results during development
• Lyric-Focused Songs: Set lyrics_strength high (0.7-0.9)
• Instrumental Focus: Set sound_strength high (0.8-1.0)
• Experimental Music: Increase weirdness (0.7-0.9)
• Commercial Production: Keep weirdness low (0.2-0.4)
• Start Conservative: Begin with default values, then adjust based on results

---

11. Upload Audio

Upload your own audio and let Producer process it (costs 2 credits).

Endpoint

POST /api/v1/producer/upload

Request Body

{
  "audio_url": "https://example.com/audio/song.mp3"
}

With Webhook Notification

{
  "audio_url": "https://example.com/audio/song.mp3",
  "webhook_url": "https://your-server.com/webhooks/upload",
  "webhook_secret": "your-secret-key"
}

Parameters

Parameter	Type	Required	Description
audio_url	string	Yes	Public URL of the audio file to upload
webhook_url	string	No	HTTPS URL to receive upload completion notification
webhook_secret	string	No	Secret for signing webhook payloads

Response

{ "code": 200, "message": "success", "task_id": "<uuid>" }

Result Retrieval

• Poll GET /api/v1/producer/task/{task_id} until completion to receive data:
  • { clip_id, audio_url, lyrics }
• The returned clip_id can be used with extend, cover, replace, swap, and variation operations

---

12. Download MP3/WAV

Export an existing track to MP3 or WAV (costs 2 credits).

Endpoint

POST /api/v1/producer/download

Request Body

{
  "clip_id": "370c650a-88cd-4f4b-960d-801e686c8a7a",
  "format": "mp3"
}

Parameters

Parameter	Type	Required	Description
clip_id	string	Yes	Music clip ID to download
format	string	No	Download format: mp3 or wav. Default: mp3

Response

{ "code": 200, "message": "success", "task_id": "<uuid>" }

Result Retrieval

• Poll GET /api/v1/producer/task/{task_id}; on success returns data:
  • { audio_url }

---

13. Webhook Integration

Use webhooks to receive notifications when tasks complete instead of polling.

How It Works

1. Include webhook_url (and optionally webhook_secret) in your create/upload request
2. The API returns a task_id immediately
3. When the task completes or fails, a POST request is sent to your webhook_url
4. If webhook_secret is provided, the payload is signed with HMAC-SHA256 for verification

Create Music with Webhook

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0 Pro",
  "sound": "chill lofi hip hop with soft piano and vinyl crackle",
  "make_instrumental": true,
  "title": "Late Night Study",
  "webhook_url": "https://your-server.com/webhooks/music",
  "webhook_secret": "your-secret-key"
}

Upload with Webhook

{
  "audio_url": "https://example.com/audio/song.mp3",
  "webhook_url": "https://your-server.com/webhooks/upload",
  "webhook_secret": "your-secret-key"
}

Webhook Requirements

• webhook_url must use HTTPS protocol
• Maximum URL length: 1024 characters
• Your endpoint must accept POST requests with JSON body

Webhook Payload (Success)

{
  "code": 200,
  "data": [
    {
      "clip_id": "abc123",
      "title": "Late Night Study",
      "audio_url": "https://...",
      "state": "succeeded",
      "duration": 185.02
    }
  ],
  "message": "success"
}

Webhook Payload (Failure)

{
  "code": 500,
  "data": [],
  "message": "Task failed"
}

Best Practices

• Always verify webhook signatures when using webhook_secret
• Implement idempotency in your webhook handler (you may receive duplicate notifications)
• Return a 2xx status code from your webhook endpoint to acknowledge receipt
• Implement a timeout handler as a fallback in case webhook delivery fails

---

Available Models Reference

Model	Avg. Generation Time	Stability	Best For
FUZZ-2.0 Pro	~20-30s	Stable	Best quality, production use
FUZZ-2.0	<30s	Very Stable	Default, reliable
FUZZ-2.0 Raw	<30s	Very Stable	Raw/unprocessed output
FUZZ-1.1 Pro	30-50s	Stable	Enhanced legacy
FUZZ-1.0 Pro	<30s	Very Stable	Fast, stable
FUZZ-1.0	30-50s	Stable	Previous release
FUZZ-1.1	30-50s	Occasional failures	Legacy
FUZZ-0.8	30-50s	Occasional failures	Legacy
Lyria 3 preview	30-50s	Occasional failures	Google Lyria 3 quality
FUZZ-3-Demo	50-80s	Low success rate	Experimental, newest

---

Complete Workflow Example

Here's a complete production workflow using multiple operations:

Step 1: Create Initial Track

{
  "task_type": "create_music",
  "mv": "FUZZ-2.0 Pro",
  "sound": "indie rock with jangly guitars and melodic vocals",
  "lyrics": "[Verse 1]\nWalking down these empty streets\nCity lights and concrete\nSearching for a place to be\nSomewhere I can feel free\n\n[Chorus]\nTake me away from here\nTo a place with no fear\nWhere I can finally breathe\nAnd be who I want to be",
  "title": "City Lights",
  "webhook_url": "https://your-server.com/webhooks/music"
}

Step 2: Extend with Bridge

{
  "task_type": "extend_music",
  "clip_id": "<from-step-1>",
  "mv": "FUZZ-2.0",
  "sound": "build intensity with layered guitars and driving drums",
  "lyrics": "[Bridge]\nEvery step I take\nEvery move I make\nBrings me closer to\nThe person I've been meant to be",
  "starts_at": 90
}

Step 3: Create Acoustic Version

{
  "task_type": "cover_music",
  "clip_id": "<from-step-2>",
  "mv": "FUZZ-2.0",
  "sound": "intimate acoustic version with fingerstyle guitar and raw vocals",
  "cover_strength": 0.7,
  "title": "City Lights (Acoustic)"
}

Step 4: Create Variations

{
  "task_type": "music_variation",
  "clip_id": "<from-step-2>",
  "mv": "FUZZ-2.0"
}

---

Error Prevention Checklist

Before submitting your request, verify:

• sound or lyrics contains meaningful content (not "test" or placeholders)
• lyrics are at least 20-30 words with proper structure
• sound descriptions are detailed (10+ words)
• clip_id is provided for extend/cover/replace/swap/variation operations
• task_type matches your intended operation
• Parameter values are within valid ranges
• Required parameters are included
• JSON syntax is valid
• webhook_url uses HTTPS (if provided)

---

Quick Reference Table

Operation	task_type	Requires clip_id	Requires sound/lyrics	Best Use Case
Create	create_music	No	Yes	New original tracks
Extend	extend_music	Yes	Yes	Add outro/bridge
Cover	cover_music	Yes	Yes	Style transformation
Replace	replace_music	Yes	Yes	Fix/modify sections
Variation	music_variation	Yes	No	Alternative versions
Swap Vocals	swap_music_vocals	Yes	Yes	Change vocal style
Swap Sound	swap_music_sound	Yes	Yes	Change instrumentation

---

Support

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

---