0xsline/openchatcut

Génération musicale via Mureka, MiniMax, Atlas Cloud et Sonilo. Utilisez-le pour instrumentaux, chansons, bandes-son, pistes/stems, reprises ou composition synchronisée sur vidéo du montage final via `submit_music`.

Qu'est-ce que openchatcut ?

L'outil `0xsline/openchatcut` est une compétence d'agent IA spécialisée dans la génération musicale, conçue pour les plateformes d'édition vidéo comme OpenChatCut et d'autres environnements d'agents. Il prend en charge plusieurs fournisseurs de qualité professionnelle : Mureka, MiniMax, Atlas Cloud et Sonilo, offrant chacun des modes spécifiques (instrumental, chanson, bande-son, reprise, etc.). L'agent orchestre le flux de travail : il soumet une requête via `submit_music`, récupère l'identifiant `jobId`, puis appelle `track_progress` pour surveiller la génération jusqu'à ce que toutes les pistes soient enregistrées dans le médiathèque. Une fois les pistes disponibles, il les place, les coupe, ajoute des fondus et ajuste le volume sur la timeline. La compétence gère automatiquement les paramètres propres à chaque fournisseur (par exemple, la génération de paroles avec Mureka, les reprises avec MiniMax, ou la composition audio à partir de la vidéo montée avec Sonilo). Elle applique des règles strictes pour éviter la génération non demandée et ne jamais mélanger les paramètres entre fournisseurs. Les développeurs et utilisateurs d'agents IA peuvent ainsi déléguer la création musicale complète, de la composition instrumentale aux bandes-son synchronisées, en minimisant les interventions manuelles.

Compatible avec~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/0xsline/openchatcut/tree/HEAD/src/agent/skills/music

Documentation

Musique

submit_music retourne un jobId ; appelez track_progress jusqu'à ce que chaque résultat soit enregistré dans le médiathèque. Le placement, le rognage, la boucle, les fondus et le ducking restent des opérations sur la timeline.

Fournisseurs et modes

Fournisseur	Modes	Référence
`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

Sélectionnez le fournisseur nommé/configuré. Par défaut, utilisez Mureka instrumental pour une ambiance sonore standard. Utilisez Mureka song/prompt-song lorsque vous souhaitez du chant ou des contrôles de référence ; utilisez Mureka soundtrack pour une composition basée sur une image/vidéo et le mode track pour générer une piste/stem à partir d'une source audio ou chanson existante. Utilisez MiniMax pour ses modèles texte-vers-musique et reprise. Utilisez Atlas Cloud pour la génération texte-vers-musique basée sur un schéma via son API audio asynchrone. Utilisez Sonilo v2m lorsque la musique doit être composée à partir du montage final lui-même (un élément vidéo du projet) plutôt que d'une description textuelle.

Flux de travail partagé

Confirmez le fournisseur, le mode, et si plusieurs variantes payantes sont souhaitées.
Lisez la référence du fournisseur et ne transmettez que les paramètres de ce fournisseur.
Soumettez une fois, puis appelez track_progress({ target:"generation", action:"wait", jobIds:[jobId] }).
Utilisez chaque élément retourné lorsque count a produit plusieurs résultats ; ne supposez pas que seul le champ hérité result existe.
Placez/rognez/duckez sur la timeline uniquement après avoir connu les durées réelles.

Exemples

// Mureka instrumental (le count par défaut est volontairement 1)
submit_music({ provider: "mureka", mode: "instrumental", prompt: "Warm lo-fi piano bed under narration", count: 1 });

// Mureka chanson avec paroles
submit_music({
  provider: "mureka", mode: "song", prompt: "Bright modern pop", gender: "female", count: 2,
  lyrics: "[Verse]\nCity lights open the night\n[Chorus]\nWe build the future in real time",
});

// Mureka prompt-song
submit_music({ provider: "mureka", mode: "prompt-song", prompt: "A hopeful road-trip anthem", styles: ["pop", "folk"] });

// Bande-son d'un projet vidéo ou image
submit_music({ provider: "mureka", mode: "soundtrack", sourceAssetId: "videoAssetId", prompt: "Tense restrained documentary score" });

// Génération d'une piste à partir d'un id de chanson Mureka
submit_music({ provider: "mureka", mode: "track", songId: "song-id", trackType: "Drums", prompt: "Tight punchy acoustic drums" });

// MiniMax instrumental / vocal
submit_music({ provider: "minimax", mode: "t2m", prompt: "Upbeat electronic tech intro", isInstrumental: true });
submit_music({ provider: "minimax", mode: "t2m", prompt: "Rainy night pop", lyricsOptimizer: true });

// MiniMax reprise à partir d'un élément audio du projet
submit_music({ provider: "minimax", mode: "cover", prompt: "Warm acoustic coffee-shop cover", referenceAssetId: "audioAssetId" });

// Atlas Cloud texte-vers-musique
submit_music({ provider: "atlas", mode: "t2m", prompt: "Cinematic ambient score with restrained piano", isInstrumental: true });

// Sonilo vidéo-vers-musique à partir du montage rendu (description facultative)
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId" });
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId", prompt: "Warm indie folk, no drums" });

Règles

Ne générez qu'après une demande explicite ; count 2–3 peut multiplier les frais du fournisseur, n'ajoutez donc jamais de variantes en silence.
Mureka stream:true active la phase de tâche streaming du fournisseur, mais OpenChatCut attend toujours les fichiers finaux durables.
MiniMax cover nécessite un modèle music-cover* configuré et exactement l'un de referenceAssetId ou coverFeatureId ; coverFeatureId nécessite également des paroles.
Atlas Cloud ne prend en charge que t2m et n'accepte pas les champs cover/optimizer de MiniMax ni les contrôles spécifiques à Mureka.
Ne mélangez jamais les champs de réglage audio MiniMax dans Mureka, ni les IDs/modes Mureka dans MiniMax.
La musique générée ne garantit pas un rythme/beat exact ; coupez et alignez après la génération.