Música
submit_music devuelve un jobId de generación; llama a track_progress hasta que cada resultado se guarde en el pool de medios. La colocación, recorte, bucle, fundidos y ducking siguen siendo operaciones de la línea de tiempo.
Proveedores y modos
| Proveedor | Modos | Referencia |
|---|---|---|
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 |
Selecciona el proveedor nombrado/configurado. Por defecto, usa Mureka instrumental para BGM ordinario. Usa Mureka song/prompt-song cuando se deseen sus controles vocales o de referencia; usa Mureka soundtrack para una partitura basada en imagen/video y el modo track para generar un stem/pista a partir de una canción/fuente de audio. Usa MiniMax para sus modelos de texto a música y versiones. Usa Atlas Cloud para texto a música basado en esquemas a través de su API de audio asíncrona. Usa Sonilo v2m cuando la música deba componerse a partir del corte finalizado (un activo de video del proyecto) en lugar de una descripción de texto.
Flujo de trabajo compartido
- Confirma el proveedor, el modo y si se desean múltiples variantes pagadas.
- Lee la referencia del proveedor y pasa solo los parámetros de ese proveedor.
- Envía una vez, luego llama a
track_progress({ target:"generation", action:"wait", jobIds:[jobId] }). - Usa todos los activos devueltos cuando
counthaya producido múltiples resultados; no asumas que solo existe el camporesultheredado. - Coloca/recorta/realiza ducking en la línea de tiempo solo después de conocer las duraciones reales.
Ejemplos
// Mureka instrumental (el count predeterminado es deliberadamente 1)
submit_music({ provider: "mureka", mode: "instrumental", prompt: "Cama de lo-fi cálida para narración", count: 1 });
// Canción con letra de Mureka
submit_music({
provider: "mureka", mode: "song", prompt: "Pop moderno brillante", gender: "female", count: 2,
lyrics: "[Verso]\nLuces de la ciudad abren la noche\n[Estribillo]\nConstruimos el futuro en tiempo real",
});
// Canción prompt de Mureka
submit_music({ provider: "mureka", mode: "prompt-song", prompt: "Un himno esperanzador de viaje por carretera", styles: ["pop", "folk"] });
// Partitura para un video o imagen del proyecto
submit_music({ provider: "mureka", mode: "soundtrack", sourceAssetId: "videoAssetId", prompt: "Partitura documental tensa y contenida" });
// Generar un stem a partir de un ID de canción de Mureka
submit_music({ provider: "mureka", mode: "track", songId: "song-id", trackType: "Drums", prompt: "Batería acústica ajustada y contundente" });
// MiniMax instrumental / con voz
submit_music({ provider: "minimax", mode: "t2m", prompt: "Introducción tecnológica electrónica alegre", isInstrumental: true });
submit_music({ provider: "minimax", mode: "t2m", prompt: "Pop de noche lluviosa", lyricsOptimizer: true });
// Versión de MiniMax a partir de un activo de audio del proyecto
submit_music({ provider: "minimax", mode: "cover", prompt: "Versión acústica cálida de cafetería", referenceAssetId: "audioAssetId" });
// Atlas Cloud texto a música
submit_music({ provider: "atlas", mode: "t2m", prompt: "Partitura ambiental cinematográfica con piano contenido", isInstrumental: true });
// Sonilo video a música a partir del corte renderizado (prompt opcional)
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId" });
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId", prompt: "Folk indie cálido, sin batería" });
Reglas
- Solo genera después de una solicitud explícita;
count2–3 puede multiplicar los costos del proveedor, así que nunca agregues variantes en silencio. stream:trueen Mureka habilita la fase de tarea de streaming del proveedor, pero OpenChatCut aún espera archivos finales duraderos.- MiniMax cover requiere un modelo
music-cover*configurado y exactamente uno dereferenceAssetIdocoverFeatureId;coverFeatureIdtambién requiere letra. - Atlas Cloud solo admite
t2my no acepta los controles de MiniMax cover/optimizer ni los específicos de Mureka. - Nunca mezcles campos de configuración de audio de MiniMax en Mureka ni IDs/modos de Mureka en MiniMax.
- La música generada no garantiza una sincronización exacta de ritmo/beat; corta y alinea después de la generación.