Música
submit_music retorna um jobId de geração; chame track_progress até que cada resultado seja salvo na pool de mídia. Posicionamento, corte, loop, fades e ducking permanecem operações da linha do tempo.
Provedores e modos
| Provedor | Modos | Referência |
|---|---|---|
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 |
Selecione o fornecedor nomeado/configurado. Padrão para Mureka instrumental para BGM comum. Use Mureka song/prompt-song quando seus controles vocais ou de referência forem desejados; use Mureka soundtrack para uma pontuação baseada em imagem/vídeo e o modo track para gerar um stem/faixa a partir de uma música/fonte de áudio. Use MiniMax para seus modelos de texto-para-música e cover. Use Atlas Cloud para texto-para-música com esquema através de sua API de áudio assíncrona. Use Sonilo v2m quando a música deve ser composta a partir do próprio corte final (um asset de vídeo do projeto) em vez de uma descrição textual.
Fluxo de trabalho compartilhado
- Confirme provedor, modo e se múltiplas variantes pagas são desejadas.
- Leia a referência do provedor e passe apenas os parâmetros desse provedor.
- Envie uma vez, depois chame
track_progress({ target:"generation", action:"wait", jobIds:[jobId] }). - Use cada asset retornado quando
countproduziu múltiplos resultados; não assuma que apenas o campo legadoresultexiste. - Coloque/corte/faça duck na linha do tempo somente após as durações reais serem conhecidas.
Exemplos
// Mureka instrumental (count padrão é deliberadamente 1)
submit_music({ provider: "mureka", mode: "instrumental", prompt: "Base de piano lo-fi aconchegante para narração", count: 1 });
// Mureka música com letra
submit_music({
provider: "mureka", mode: "song", prompt: "Pop moderno vibrante", gender: "female", count: 2,
lyrics: "[Verso]\nLuzes da cidade abrem a noite\n[Refrão]\nConstruímos o futuro em tempo real",
});
// Mureka música com prompt
submit_music({ provider: "mureka", mode: "prompt-song", prompt: "Um hino esperançoso de viagem", styles: ["pop", "folk"] });
// Pontuar um vídeo ou imagem do projeto
submit_music({ provider: "mureka", mode: "soundtrack", sourceAssetId: "videoAssetId", prompt: "Trilha documental tensa e contida" });
// Gerar um stem a partir de um id de música do Mureka
submit_music({ provider: "mureka", mode: "track", songId: "song-id", trackType: "Drums", prompt: "Bateria acústica firme e marcante" });
// MiniMax instrumental / vocais
submit_music({ provider: "minimax", mode: "t2m", prompt: "Intro eletrônica animada de tecnologia", isInstrumental: true });
submit_music({ provider: "minimax", mode: "t2m", prompt: "Pop de noite chuvosa", lyricsOptimizer: true });
// MiniMax cover a partir de um asset de áudio do projeto
submit_music({ provider: "minimax", mode: "cover", prompt: "Cover acústico aconchegante de cafeteria", referenceAssetId: "audioAssetId" });
// Atlas Cloud texto-para-música
submit_music({ provider: "atlas", mode: "t2m", prompt: "Trilha ambiente cinematográfica com piano contido", isInstrumental: true });
// Sonilo vídeo-para-música a partir do corte renderizado (prompt opcional)
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId" });
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId", prompt: "Folk indie aconchegante, sem bateria" });
Regras
- Gere apenas após uma solicitação explícita;
count2–3 pode multiplicar os custos do provedor, então nunca adicione variantes silenciosamente. - Mureka
stream:truehabilita a fase de tarefa de streaming do provedor, mas o OpenChatCut ainda aguarda pelos arquivos finais duráveis. - MiniMax cover requer um modelo
music-cover*configurado e exatamente um dereferenceAssetIdoucoverFeatureId;coverFeatureIdtambém requer letra. - Atlas Cloud suporta apenas
t2me não aceita controles de cover/otimizador do MiniMax ou específicos do Mureka. - Nunca misture campos de configuração de áudio do MiniMax em Mureka ou IDs/modos do Mureka em MiniMax.
- A música gerada não garante batida/tempo exatos; corte e alinhe após a geração.