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)#
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 latest 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",
"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
}
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",
"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 Verse#
{
"task_type": "replace_music",
"clip_id": "your-clip-id-here",
"mv": "FUZZ-2.0",
"sound": "minimal sparse arrangement with just vocals and subtle piano for emotional contrast",
"lyrics": "[Verse 2 - Revised]\nIn the silence I find peace\nAll the noise begins to cease\nClarity comes rushing in\nNew beginnings can begin",
"starts_at": 25,
"ends_at": 50,
"lyrics_strength": 0.7
}
Example 3: 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",
"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
}
Example 3: Jazz Vocals#
{
"task_type": "swap_music_vocals",
"clip_id": "your-clip-id-here",
"mv": "FUZZ-2.0",
"sound": "sultry female jazz vocal with smoky tone, subtle vibrato, and sophisticated phrasing reminiscent of classic jazz singers",
"lyrics": "[Verse]\nIn the midnight hour\nWhen the moon hangs low\nI sing my song for you\nLetting feelings flow",
"cover_strength": 0.7
}
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
}
Example 4: Acoustic Folk#
{
"task_type": "swap_music_sound",
"clip_id": "your-clip-id-here",
"mv": "FUZZ-2.0",
"sound": "warm acoustic folk with fingerstyle guitar, subtle mandolin, upright bass, and light hand percussion",
"lyrics": "[Verse]\nDown by the riverside\nWhere the willows grow\nI'll wait for you my dear\nIn the sunset's glow",
"cover_strength": 0.65,
"sound_strength": 0.7
}
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",
"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
}
{
"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
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",
"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"
}
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
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#
Modified at 2025-10-02 06:23:54