Mix and master stems
doseedo_mixMIXING and MASTERING: each part levelled, panned, high-passed, given its depth on a shared reverb, mastered to a loudness target — a WAV AND mixgraph, the mix as a document. After doseedo_render_score pass from_job (its parts and the instruments they play are the stems); or stems: [{name, audio_url, instrument?}]. An orchestra (strings / winds / brass / timpani / harp…) is SEATED by default (film-orchestral: violins left, low strings right, brass behind, each seat at its depth in a 2.3 s hall, written dynamics riding the faders); others mixed blind. style: an id or words — the style parameter lists every id (scoring halls, jazz-combo, big-band, brass and marching bands, soul, rock-band and the other guitar bands, blues, country, reggae, disco, the decades). guitar_tone = guitar sound. balance {part: dB} moves parts on top of the levelling (+3 = a melody forward). Change the mix: edit the returned mixgraph — strips[] {stem, gain_db, pan, seat, chain, sends}, buses[] (verb = the hall; a section's fader_db = its level), master.chain, automation [{target: "strips..gain_db", points: [[seconds, dB]…]}] for rides (dB off the strip's gain_db: 0 = as set, -60 mutes) — and call again with mix_job (this job_id) + only your edits (or the whole mixgraph + the same stems): rendered as written, rails reported, no credits. Then doseedo_session_from_stems {from_job, mix_job: } → the DAW project at this mix's levels and pans. TO PICTURE: dialogue (the VO; the music ducks under it), music_offset_s (bar 1 on the picture), length_s (cut + end fade). Async: job_id → doseedo_wait_task (~15–90 s). Cancel: the plane has no stop for a running mix — it runs to completion (credits spent), the job ends as canceled and its output is discarded. Only a job still queued at the plane is refunded by the plane's own failure refund.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "doseedo_mix"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bpm | No | The music's tempo: a guitar tone's echoes (an eighth, a dotted eighth) land on it. from_job fills it. | |
| duck | No | How the music sits under the dialogue: {vo_over_db (default 7 dB — a broadcast mix's 6–10), carve_db (default 3, at 1–4 kHz), max_db (default 12), include (default true; false = the music bed alone, ducked as if the voice played)}. | |
| loop | No | Make the mix a LOOP that repeats seamlessly: {bars, bpm, beats_per_bar?} (the loop is bars × beats_per_bar × 60 / bpm seconds; beats_per_bar default 4) or {seconds}, 0.5–240 s. For music WRITTEN to come round (a game level, a menu, a waiting screen: nothing ending on the last bar — the game_town and game_dungeon generators are). Send the stems as rendered, their tails past the last bar included (a render runs ~2 s past its last note): whatever still sounds at the loop point (a note's release, the room) is carried over the loop's start, and the mix is played round until its rooms and compressors have settled. The mix (and every print) comes back EXACTLY that long, to the sample: output.loop {length_s, samples, sr, seam_db}. With print_parts each part is a loop of the same length — layers that stay in time. Not with dialogue, music_offset_s or length_s. | |
| name | No | Optional: a name for this job's files, e.g. "rainy-loop-3". Every file it returns downloads as <name>_<part>.<ext> (rainy-loop-3_Celesta.wav, rainy-loop-3_rough-mix.wav; one take: rainy-loop-3.wav), so the user can find them. Give each job its own name (a second take: "rainy-loop-3b"). Default: doseedo-<last 6 characters of the job id>. | |
| room | No | An orchestra's room: "studio" (intimate scoring stage, ~1.2 s, close), "stage" (~1.8 s), "hall" (the default scoring hall, ~2.3 s), "cathedral" (~4 s, wet) — or 0..1 between them. Sets the decay, size and how wet every seat sits. | |
| stems | No | [{name, audio_url, instrument?}] — the stems (≤ 32). instrument = the sound it plays (a doseedo_instruments id: "violin", "timpani", "harp"), which decides how it is mixed; without it the name decides. | |
| style | No | A mix style: an id or words ("dry 90s rock"). Pick it for the picture — the default (film-orchestral, a 2.3 s scoring hall) suits film drama, not every orchestra: film-orchestral-sections = the same hall, the strings and winds seated wider, a fader per section (buses[].fader_db); cartoon-studio = a cartoon / animation orchestra (a close, dry, wide scoring stage, punchy rides); golden-age-cartoon = a 1940s–50s cartoon (mono, small studio, tape); film-scoring-stage = intimate TV / documentary; concert-hall; film-epic-hybrid = trailer / action; cathedral-choral; classical-chamber; 2020s-tech-ad = a tech / product / brand film (sleek modern electronic, matched to official tech ads); ad-groove = the funk groove of a modern ad (a round bass riff in front, a small dry kit, bright horn stabs, a shout: the mix of the ad_groove generator); afro-soul = a seventies funk band in a room, to tape (nearly mono, dark on top, the horns and the electric piano forward: the mix of the afro_soul generator, set on a period recording); or jazz-combo (a small jazz band), big-band (a big band, seated in sections), sports-broadcast (a sports theme: brass and drumline, close, bright and loud, matched to network sports themes), marching-band (a marching band or drum corps on the field), brass-band (a New Orleans street brass band, a trad-jazz band: dry, close, the sousaphone as the bass), motown-soul (a sixties soul band: the bass forward, the lead in front of horns, strings and voices), doo-wop (a vocal group in an echo chamber, narrow, the lead in front), a guitar band by its genre — rock-band, punk-rock, new-wave-rock, surf-rock, grunge-rock, metal-band, doom-metal, indie-rock, post-rock, shoegaze (each gives the guitars the amp of that genre) — blues-band, country-band, reggae-band, disco, ambient, 1970s-analog-rock, 2020s-pop … Every id: film-orchestral, film-orchestral-sections, film-scoring-stage, concert-hall, film-epic-hybrid, cathedral-choral, choral-chapel, stadium-crowd, classical-chamber, cartoon-studio, golden-age-cartoon, jazz-combo, jazz-strings, jazz-ballad, big-band, brass-band, marching-band, sports-broadcast, motown-soul, wall-of-sound, soul-ballad, funk-band, ad-groove, afro-soul, psychedelic-soul, neo-soul, gospel, doo-wop, disco, rock-n-roll, rock-band, punk-rock, new-wave-rock, surf-rock, grunge-rock, metal-band, doom-metal, indie-rock, post-rock, shoegaze, lofi-soft-rock, blues-band, country-band, string-band, bakersfield, country-rock, nashville-sound, reggae-band, dub, calypso-band, soca-band, zouk, dancehall, jazz-fusion, smooth-jazz, house-club, deep-house, jazz-house, french-house, acid-house, hardstyle, big-beat, phonk, spaghetti-western, spy-film, ambient, country-pop, metal-modern, 1950s-mono, 1960s-lcr-pop, 1970s-analog-rock, 1970s-dub, 1980s-pop-gated, 1980s-slow-burn, 1980s-horn-pop, new-jack-swing, 1990s-rock-dry, 1990s-hiphop, boom-bap, jazz-rap, hardcore-hiphop, west-coast-hiphop, g-funk, lofi-hiphop, 2000s-loudness-rock, 2010s-edm, 2010s-trap, 2020s-pop, 2020s-hyperpop, 2020s-tech-ad | |
| levels | No | The level the music is MEANT to play at over time: [[seconds, "none" | "low" | "medium" | "high" | "peak"], …] in time order, each held until the next row (a third item true = that level is REACHED there, moving evenly from the row before). The mix measures its own sum, stretch by stretch, and holds each stretch to its level's place — peak the loudest, high 3.5 LU under it, medium 6, low 10 — so a thin passage is not lost under a full one and the band coming in is a step, not a jump. from_job fills it from a band generator's own dynamics; pass [] for none. | |
| shapes | No | The director's dynamics keyframes on this music, seconds into it: [{curve, at_s, to_s?}, …] — curve "fadein" | "cresc" | "swell" | "steady" | "decresc" | "fadeout" (each over at_s..to_s, 4 s without one) or "accent" | "subito" | "stop" (at at_s). The mix measures its own sum over each and rides it only by what the music did not play: a crescendo it already plays is left alone; a stop the music played on through goes silent after its beat, to the next keyframe or for a breath. output.report.master.shape_follow says what it read and rode, keyframe by keyframe. | |
| balance | No | {part name: dB in -12..12} — your balance on top of the levelling (and of the written dynamics a from_job reads). | |
| mix_job | No | MCP: a doseedo_mix job_id to edit — its whole stored mix (every ride) is the base, mixgraph is applied on top, and its stems are reused when you pass no from_job / stems. | |
| vintage | No | A period medium over any style, after the mix: "tape" = 7.5 ips tape (saturation, wow and flutter, a low hiss); "shellac" = a 78 played back (mono, ~90 Hz–5.5 kHz with the reproducer's presence, a 1.3 Hz wow, surface noise that swishes once a turn, crackle). "none" takes a style's own medium off (golden-age-cartoon carries tape). Its node (master.chain type vintage: noise_db, crackle, hi_hz …) is editable in the returned mixgraph. | |
| without | No | MCP, with from_job / from_jobs: the parts LEFT OUT of this mix, by name (a section's name leaves out its players) — the same render mixed again without them: nothing is played again, every other part keeps its take. | |
| dialogue | No | The VO / dialogue on the picture's timeline (≤ 4): [{name?, audio_url}]. The music ducks under each line until the voice sits duck.vo_over_db over it, with a 1–4 kHz carve while it talks; the voice joins after the music's master chain. Report: output.dialogue.lines [{start_s, end_s, duck_db, vo_over_music_db}] as mixed. | |
| dynamics | No | Fader rides from written dynamics: {part name: [[onset_seconds, velocity 0-127], …]}. from_job fills it from the score (pp to ff ≈ 17 dB); pass {} for no rides. | |
| from_job | No | MCP: a doseedo_render_score job_id — its parts are the stems, each with the instrument it plays, and each part's written dynamics (its mean velocity) set its balance. A render made from a BAND GENERATOR (render_score {generator}) is mixed in the style that generator names for its genre — a dub in its spring tank and tape echo, surf guitars in a spring, a fifties slapback — at the tempo it plays, unless you pass style. | |
| length_s | No | The program's length (a :30 = 30; ≤ 600 s): the mix is cut there with end_fade_s (default 0.5 s); the room's tail never runs past it. | |
| mixgraph | No | An edited mix — the mixgraph a doseedo_mix returned, changed — rendered against the same stems (from_job or stems). With mix_job: ONLY what you change (strips[] by stem, automation[] rides by target — points: [] removes one, buses[] by id, master) — the rest is that mix as stored. A mixgraph marked `partial` (its rides summarized) is refused without mix_job. Omit for a fresh mix. | |
| from_jobs | No | MCP: ONE cue rendered as several doseedo_render_score jobs (its parts split across renders): every job's parts are the stems, balanced and ridden by their written dynamics as one score. | |
| end_fade_s | No | With length_s: the fade at the program's end (0–10 s, default 0.5). | |
| moves_plan | No | The SPACE a band generator's style leaves, as the mix plays it: {risers: [{from_s, to_s, kind: "build" | "drop" | "breath" | "outro", shut?, every_s?}], dry: [[from_s, to_s]], blurbs: [seconds]} — a build's riser swells into the space, the rooms the rhythm section does not feed shut through it, a blurb answers the lead in its rests. Played only by a mix style with moves (lofi-soft-rock). from_job fills it from a generator that leaves space. | |
| guitar_tone | No | The guitars' and bass guitar's own SOUND. Every guitar and bass-guitar part (an upright played pizzicato too; never a synth bass or an 808) gets a tone by default ("auto"): a mixing chain for the style — compression, the amp's voicing and speaker, chorus / phaser / tremolo, its own echo and reverb, in stereo — fitted to that stem (drive only where the genre is driven, and less on a take that already came out amped; an acoustic gets EQ, compression and a room, never an amp; a bass stays centred and dry). "none" = as rendered (dry, mono). Or name one: a tone id, or words ("surf", "dark trap loop", "80s chorus") — for every guitar, or {part name: tone} for one. Tones — electric: clean-studio, pop-shimmer, funk-quack, funk-phaser, disco-chank, neo-soul, motown-soul, jazz-archtop, jazz-fusion, country-twang, country-ballad, surf-drip, desert-twang, rockabilly-slap, fifties-tweed, sixties-jangle, british-chime, psychedelic-swirl, soft-rock-phase, eighties-chorus, city-pop, new-wave-flange, post-punk-chorus, grunge-chorus, dream-pop, indie-jangle, math-rock-clean, emo-twinkle, reggae-skank, ska-upstroke, dub-skank, afrobeat-clean, soukous-sparkle, bachata-requinto, cumbia-psych, gospel-clean, rnb-smooth, edm-funk, hiphop-sample, lofi-tape, portastudio-chorus, portastudio-lead, trap-ambient, ambient-swell, slow-burn-swell, cinematic-clean, prog-clean, blues-edge, blues-lead, heartland-edge, indie-rock-edge, worship-dotted, post-rock, seventies-crunch, southern-rock, slide-delta, new-wave-crunch, new-wave-lead, alt-rock-crunch, britpop-wall, grunge-rhythm, eighties-arena-lead, synthwave-lead, shoegaze-wash, pop-punk-rhythm, punk-raw, metal-rhythm, metal-lead, djent-tight, doom-fuzz, garage-fuzz · acoustic: acoustic-natural, acoustic-pop-strum, acoustic-fingerstyle, acoustic-intimate, acoustic-country, acoustic-bluegrass, acoustic-rock, acoustic-celtic, acoustic-12-string, acoustic-lofi, acoustic-cinematic, acoustic-hiphop-loop, acoustic-worship, acoustic-latin-strum, acoustic-blues, acoustic-gypsy-jazz · nylon: nylon-bossa, nylon-classical, nylon-flamenco, nylon-latin-pop, nylon-lofi, nylon-cinematic · steel: pedal-steel-country, pedal-steel-ambient, lap-steel-island · bass: bass-studio, bass-sixties-thump, bass-finger-funk, bass-slap, bass-picked-rock, bass-picked-dark, bass-driven-rock, bass-metal, bass-dub, bass-jazz-electric, bass-fretless, bass-eighties-chorus, bass-hiphop, bass-lofi, bass-flatwound-crushed, bass-country, bass-indie, bass-dance, bass-latin, bass-cinematic · upright: upright-jazz, upright-slap, upright-folk, upright-sampled, upright-latin, upright-cinematic. The mix says what it chose and why: mixgraph.provenance.guitar_tones {part: {tone, why, read, drive}}; the chain is the strip's own (strips[].chain), editable like the rest. | |
| print_parts | No | Also print every PART alone as its own stem: output.part_stems [{name, url}] — a 24-bit WAV per part (that player, their room and hall share, through the mix's own master), all the mix's length and summing to the mix: the LAYERS a game fades in and out over a looping mix, or stems an editor mutes one by one. Instead of print_sections, not with it. About twice the render. Per-part stems come with Pro: a free plan is handed the mix. | |
| target_lufs | No | Master loudness, -24..-6 LUFS (default: the style's — -18 for film-orchestral, -14 for the blind default). Met within ~0.3 LU (a loud target clips the shortest transients first); output.loudness says what landed, and why when short. With mix_job it re-masters the stored mix. | |
| tonal_match | No | Nudge the master toward professionally mixed orchestral references (default on for the orchestral styles). Its presence and air are judged only where the score is written loud (written_level), so a pp passage keeps its darkness. | |
| dynamics_ride | No | How hard the written dynamics move the faders: 1 = default (pp to ff ≈ 17 dB), 0 = no rides, up to 1.5. | |
| written_level | No | [[seconds, velocity], …] — the whole score's written level, the loudest part sounding, held until the next row (0 = nothing plays). The tonal match reads only the passages it writes loud (f and louder), so a pp passage keeps its darkness. from_job fills it. | |
| level_range_lu | No | How far apart "low" and "peak" sit, in LU (default 10; about 7 for music that plays under speech — the rungs between scale with it). | |
| music_offset_s | No | Where bar 1 of the music sits on the picture (seconds, ≤ 600; the program ≤ 600 s): every music stem — and its rides — starts this late; the dialogue does not move. | |
| print_sections | No | Also print every section as its own stem: output.section_stems [{name, members, url}] — a 24-bit WAV per section (its players, their room and hall share, through the mix's own master), and the dialogue as one; the prints add up to the mix (report.prints.sum_error_db). Sections are the mix's group buses (film-orchestral-sections: strings / woodwinds / brass / percussion / keys_harp; parts in none print as "other"). About twice the render time; no extra credits. Works with mix_job too. | |
| idempotency_key | No | Optional. Any unique string for THIS request (e.g. a UUID). Re-sending the same call with the same key after a timeout returns the same job instead of starting a second one. | |
| dynamics_carried | No | {part name: top velocity} — parts whose stems already play their written level (a render part's dynamics_level receipt, up to its top_vel). Their rides count it: no doubled swing. from_job fills it. |