음악
submit_music은 생성 jobId를 반환합니다. 모든 결과가 미디어 풀에 저장될 때까지 track_progress를 호출하세요. 배치, 트림, 루프, 페이드 및 덕킹은 타임라인 작업으로 유지됩니다.
공급자 및 모드
| 공급자 | 모드 | 참조 |
|---|---|---|
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 |
이름이 지정된/구성된 벤더를 선택하세요. 일반 BGM에는 Mureka instrumental을 기본값으로 사용합니다. 보컬이나 참조 제어가 필요한 경우 Mureka song/prompt-song을 사용하고, 이미지/비디오 기반 스코어링이 필요하면 Mureka soundtrack을, 노래/오디오 소스에서 stem/트랙을 생성하려면 track 모드를 사용하세요. 텍스트-음악 및 커버 모델에는 MiniMax를 사용하세요. 스키마 기반 텍스트-음악에는 Atlas Cloud의 비동기 오디오 API를 사용하세요. 텍스트 설명 대신 완성된 컷(프로젝트 비디오 에셋)에서 음악을 구성해야 할 때는 Sonilo v2m을 사용하세요.
공유 워크플로우
- 공급자, 모드 및 여러 유료 변형이 필요한지 확인합니다.
- 공급자 참조를 읽고 해당 공급자의 매개변수만 전달합니다.
- 한 번 제출한 다음
track_progress({ target:"generation", action:"wait", jobIds:[jobId] })를 호출합니다. count가 여러 결과를 생성한 경우 반환된 모든 에셋을 사용합니다. 레거시result필드만 있다고 가정하지 마십시오.- 실제 지속 시간을 확인한 후에만 타임라인에 배치/트림/덕킹을 수행합니다.
예시
// Mureka instrumental (기본 count는 의도적으로 1)
submit_music({ provider: "mureka", mode: "instrumental", prompt: "Warm lo-fi piano bed under narration", count: 1 });
// Mureka 가사 노래
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 프롬프트 노래
submit_music({ provider: "mureka", mode: "prompt-song", prompt: "A hopeful road-trip anthem", styles: ["pop", "folk"] });
// 프로젝트 비디오 또는 이미지 스코어링
submit_music({ provider: "mureka", mode: "soundtrack", sourceAssetId: "videoAssetId", prompt: "Tense restrained documentary score" });
// Mureka 노래 ID에서 스템 생성
submit_music({ provider: "mureka", mode: "track", songId: "song-id", trackType: "Drums", prompt: "Tight punchy acoustic drums" });
// MiniMax 악기 / 보컬
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 커버
submit_music({ provider: "minimax", mode: "cover", prompt: "Warm acoustic coffee-shop cover", referenceAssetId: "audioAssetId" });
// Atlas Cloud 텍스트-음악
submit_music({ provider: "atlas", mode: "t2m", prompt: "Cinematic ambient score with restrained piano", isInstrumental: true });
// 렌더링된 컷에서 Sonilo 비디오-음악 (프롬프트는 선택 사항)
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId" });
submit_music({ provider: "sonilo", mode: "v2m", sourceAssetId: "renderedCutAssetId", prompt: "Warm indie folk, no drums" });
규칙
- 명시적 요청이 있을 때만 생성하십시오.
count2–3은 공급자 비용을 증가시킬 수 있으므로 변형을 자동으로 추가하지 마십시오. - Mureka
stream:true는 공급자의 스트리밍 태스크 단계를 활성화하지만 OpenChatCut은 여전히 지속 가능한 최종 파일을 기다립니다. - MiniMax 커버는 구성된
music-cover*모델과referenceAssetId또는coverFeatureId중 정확히 하나가 필요합니다.coverFeatureId에는 가사도 필요합니다. - Atlas Cloud는
t2m만 지원하며 MiniMax 커버/최적화 또는 Mureka 특정 제어를 허용하지 않습니다. - MiniMax 오디오 설정 필드를 Mureka에 혼합하거나 Mureka ID/모드를 MiniMax에 혼합하지 마십시오.
- 생성된 음악은 정확한 비트/드롭 타이밍을 보장하지 않습니다. 생성 후 컷하고 정렬하십시오.