File size: 4,134 Bytes
356a13c
45d92cc
 
c600f78
45d92cc
356a13c
45d92cc
356a13c
 
c600f78
 
 
 
 
356a13c
 
45d92cc
 
d360571
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
45d92cc
4d426ef
 
 
 
 
 
 
457e012
 
 
4d426ef
457e012
d360571
 
4d426ef
 
 
457e012
d360571
45d92cc
 
 
 
 
d360571
4d426ef
 
 
 
457e012
 
 
45d92cc
 
 
 
 
 
457e012
64801e1
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
---
title: 2B-Studio
emoji: 🎛️
colorFrom: yellow
colorTo: gray
sdk: gradio
sdk_version: "6.25.0"
app_file: app.py
pinned: false
hf_oauth: true
hf_oauth_scopes:
  - write-repos
  - manage-repos
short_description: 2B-Studio – KI-Musik generieren, arrangieren & mastern
---

# 2B-Studio

Gradio-Shell für **Generieren → Hören → Rüberschalten → Mastern** – im *Toxic-Studio*-Look
(Acid-Chartreuse auf Beton, Schablonen-Typo, Sporen & Wellen-Glut · by EINswarm).

## Aufbau (v2)

- **Raum-Leiste links:** `Generate` · `Master` · `Studio` (Platzhalter, „bald“).
- **Arbeitsfläche:** 01 Prompt → 02 Modell → 03 Parameter → Generieren (Leiste klebt unten, `Strg/⌘ + Enter`).
- **Seitenleiste rechts:** Verlauf mit Wellenform-Karten, gewählter Take, Export, „↺ Einstellungen“ (Prompt/Modell/Seed des Takes zurückholen), Smart Remix, Master.
- **Modell-Status-Chips** oben (Live / Schläft / Pausiert / Privat / Demo-Modus).

## Vorlagen-Bibliothek

30 kuratierte Vorlagen – **Einsatz** (Intro, Jingle, Podcast-Bett, Trailer, Werbespot, Outro, Game-Loop, Meditation),
**Genres** (Lo-Fi, Techno, Boom-Bap, Trap, Ambient, Cinematic, House, DnB, Synthwave, Pop, Rock, Afro House,
Dark Riddim, Jazz Lounge, Neo-Soul, Toxic Club) und **Sound-FX** (Whoosh, Riser, Impact, UI-Sounds, Atmo, Sci-Fi).

- Variablen: BPM, Dauer, Tonart, Stimmung, Instrumente, Gesang ja/nein, Stimme, Sprache (DE/EN/ES), Titel, Zusatz.
- Modell-spezifische Formatierung (MiniMax Structured Caption, ACE-Step-Tags, Stable-Audio-Liste, AudioLDM-Satz, MusicGen-Beschreibung); Modelle ohne Gesang werden automatisch instrumental gerendert.
- Favoriten und eigene Vorlagen werden im Browser gespeichert (localStorage, max. 40).

## API

Benannte Endpunkte u. a.: `/generate`, `/producer_chat`, `/_apply_proposal`, `/reuse_settings`, `/smart_remix`,
`/_open_master`, `/_master_reply`, `/_apply_master_proposal`, `/_run_onus`.
(Seit v2 heißen die früheren `/lambda` → `/generate` und `/lambda_2` → `/producer_chat`.)

## Modelle (alle live angebunden)

| Modell | Worker-Space | Hinweis |
|---|---|---|
| MiniMax Music 3 | `MiniMaxAI/MiniMax-Music3` | Vocals & strukturierte Lyrics, bis 180 s |
| 2B Audio Small | `2Btainment/2baudio` | instrumental bevorzugt, bis 20 s |
| 2B Audio Medium | `2Btainment/2baudio` | instrumental bevorzugt, bis 30 s |
| Stable Audio Open | `2Btainment/stable-audio-open` | instrumental, bis 47 s (**privat** → `HF_TOKEN`) |
| AudioLDM 2 | `2Btainment/audioldm2` | instrumental, bis 20 s (**privat** → `HF_TOKEN`) |
| ACE-Step | `2Btainment/ace-step` | Vocals/Lyrics, bis 600 s |

Die Shell läuft als leichter HF-Space (`cpu-basic`); die Modelle laufen als getrennte ZeroGPU-Worker.
Schlafende Worker werden beim Generate geweckt. **Pausierte** Worker (vom Owner gestoppt) lassen sich nicht per Aufruf wecken –
sie erscheinen als „Pausiert“ und müssen im HF-Dashboard neu gestartet werden. Ohne `HF_TOKEN` läuft MiniMax im Demo-Modus (Test-Audio).

## Master-Ebene (ONUS)

- **Lokal:** voller Funktionsumfang inkl. ONUS-Mastering.
- **HF-Space:** Space-Mastering über den Master-Raum (`STUDIO_SPACE_MODE=1` automatisch bei `HF_SPACE_ID`).

## Secrets

| Name | Wert |
|---|---|
| `HF_TOKEN` | Pflicht für MiniMax (sonst Demo-Modus) und private Worker (stable-audio-open, audioldm2) |
| `TWO_B_AUDIO_SPACE_ID` | optional, Default `2Btainment/2baudio` |
| `MINIMAX_SPACE_ID` | optional, Default `MiniMaxAI/MiniMax-Music3` |
| `STABLE_AUDIO_SPACE_ID` | optional, Default `2Btainment/stable-audio-open` |
| `AUDIOLDM2_SPACE_ID` | optional, Default `2Btainment/audioldm2` |
| `ACE_STEP_SPACE_ID` | optional, Default `2Btainment/ace-step` |
| `GEMINI_API_KEY` | optional, Producer-Agent |
| `AGENT_MODEL_ID` | optional, HF-Inference-Modell für den Agenten |

## Lokal starten

```bash
uv sync --extra dev
STUDIO_PORT=7861 uv run python app.py
```

## Raum STUDIO (MVP)

Prompt-getriebenes Waben-Studio: eine Zeile, Suggestion-Chips, Honeycomb mit EQ/Dynamik/Streaming/−14/Club/Transition/Export.
3B-Agent über HF Inference mit Keyword-Fallback. API: `/studio_chat`, `/studio_upload`.