Musik
submit_music gibt eine jobId (Auftrags-ID) zurück; rufen Sie track_progress auf, bis jedes Ergebnis im Media-Pool gespeichert ist. Platzierung, Trimmen, Schleifen, Ein-/Ausblendungen und Ducking bleiben zeitliche Operationen auf der Timeline.
Anbieter und Modi
| Anbieter | Modi | Referenz |
|---|---|---|
mureka | instrumental, song, prompt-song, soundtrack, track | references/mureka.md |
minimax | t2m, cover | references/minimax.md |
atlas | t2m | references/atlas.md |
sonilo | v2m | references/sonilo.md |
Wählen Sie den benannten/konfigurierten Anbieter aus. Standardmäßig Mureka Instrumental für gewöhnliche Hintergrundmusik. Verwenden Sie Mureka Song/Prompt-Song, wenn dessen Gesangs- oder Referenzsteuerungen gewünscht sind; verwenden Sie Mureka Soundtrack für eine bild-/videogesteuerte Vertonung und den Track-Modus zum Erzeugen eines Stems/Tracks aus einer Song-/Audioquelle. Verwenden Sie MiniMax für seine Text-zu-Musik- und Cover-Modelle. Verwenden Sie Atlas Cloud für schema-basierte Text-zu-Musik über seine asynchrone Audio-API. Verwenden Sie Sonilo v2m, wenn die Musik aus dem fertigen Schnitt selbst (einem Projektvideo-Asset) und nicht aus einer Textbeschreibung komponiert werden soll.
Gemeinsamer Workflow
- Anbieter, Modus und ob mehrere kostenpflichtige Varianten gewünscht sind, bestätigen.
- Die Anbieterreferenz lesen und nur die Parameter dieses Anbieters übergeben.
- Einmal einreichen, dann
track_progress({ target:"generation", action:"wait", jobIds:[jobId] })aufrufen. - Jedes zurückgegebene Asset verwenden, wenn
countmehrere Ergebnisse erzeugt hat; nicht davon ausgehen, dass nur das alteresult-Feld existiert. - Auf der Timeline erst platzieren/trimmen/ducken, nachdem die tatsächlichen Dauern bekannt sind.
Beispiele
// Mureka Instrumental (Standardwert von count ist bewusst 1)
submit_music({ provider: "mureka", mode: "instrumental", prompt: "Warmes Lo-Fi-Klavierbett unter Erzählung", count: 1 });
// Mureka Lied mit Text
submit_music({
provider: "mureka", mode: "song", prompt: "Hell, moderner Pop", gender: "female", count: 2,
lyrics: "[Strophe]\nStadtlichter öffnen die Nacht\n[Refrain]\nWir bauen die Zukunft in Echtzeit",
});
// Mureka Prompt-Song
submit_music({ provider: "mureka", mode: "prompt-song", prompt: "Eine hoffnungsvolle Roadtrip-Hymne", styles: ["pop", "folk"] });
// Vertonung eines Projektvideos oder -bildes
submit_music({ provider: "mureka", mode: "soundtrack", sourceAssetId: "videoAssetId", prompt: "Angespannter, zurückhaltender Dokumentarfilm-Score" });
// Erzeugen eines Stems aus einer Mureka-Song-ID
submit_music({ provider: "mureka", mode: "track", songId: "song-id", trackType: "Drums", prompt: "Straffe, druckvolle akustische Drums" });
// MiniMax instrumental / mit Gesang
submit_music({ provider: "minimax", mode: "t2m", prompt: "Aufgeweckter elektronischer Tech-Intro", isInstrumental: true });
submit_music({ provider: "minimax", mode: "t2m", prompt: "Regennächtlicher Pop", lyricsOptimizer: true });
// MiniMax Cover aus einem Projekt-Audio-Asset
submit_music({ provider: "minimax", mode: "cover", prompt: "Warmes, akustisches Coffee-Shop-Cover", referenceAssetId: "audioAssetId" });
// Atlas Cloud Text-zu-Musik
submit_music({ provider: "atlas", mode: "t2m", prompt: "Kinematografischer Ambient-Score mit zurückhaltendem Klavier", isInstrumental: true });
// Sonilo Video-zu-Musik aus dem gerenderten Schnitt (Prompt optional)
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId" });
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId", prompt: "Warmes Indie-Folk, keine Drums" });
Regeln
- Nur nach einer expliziten Aufforderung generieren;
count2–3 kann die Anbieterkosten vervielfachen, daher niemals stillschweigend Varianten hinzufügen. - Mureka
stream:trueaktiviert die Streaming-Aufgabenphase des Anbieters, aber OpenChatCut wartet dennoch auf dauerhafte finale Dateien. - MiniMax Cover erfordert ein konfiguriertes
music-cover*-Modell und genau eines vonreferenceAssetIdodercoverFeatureId;coverFeatureIderfordert ebenfalls einen Liedtext. - Atlas Cloud unterstützt nur
t2mund akzeptiert keine MiniMax-Cover/Optimizer- oder Mureka-spezifischen Steuerungen. - Niemals MiniMax-Audio-Einstellungsfelder mit Mureka oder Mureka-IDs/Modi mit MiniMax vermischen.
- Generierte Musik garantiert kein exaktes Beat-/Drop-Timing; nach der Generierung schneiden und ausrichten.