|
|
""" |
|
|
Main model for using CodecLM. This will combine all the required components |
|
|
and provide easy access to the generation API. |
|
|
""" |
|
|
|
|
|
import typing as tp |
|
|
import warnings |
|
|
|
|
|
import torch |
|
|
|
|
|
from codeclm.tokenizer.audio_tokenizer import AudioTokenizer |
|
|
from .lm_levo import LmModel |
|
|
from ..modules.conditioners import ConditioningAttributes, AudioCondition |
|
|
from ..utils.autocast import TorchAutocast |
|
|
import torch |
|
|
from torch.nn import functional as F |
|
|
import torchaudio |
|
|
|
|
|
|
|
|
|
|
|
MelodyList = tp.List[tp.Optional[torch.Tensor]] |
|
|
MelodyType = tp.Union[torch.Tensor, MelodyList] |
|
|
|
|
|
class CodecLM: |
|
|
"""CodecLM main model with convenient generation API. |
|
|
|
|
|
Args: |
|
|
name (str): name of the model. |
|
|
compression_model (CompressionModel): Compression model |
|
|
used to map audio to invertible discrete representations. |
|
|
lm (LMModel): Language model over discrete representations. |
|
|
max_duration (float, optional): maximum duration the model can produce, |
|
|
otherwise, inferred from the training params. |
|
|
""" |
|
|
def __init__(self, name: str, audiotokenizer: AudioTokenizer, lm: LmModel, |
|
|
max_duration: tp.Optional[float] = None, seperate_tokenizer: AudioTokenizer = None): |
|
|
self.name = name |
|
|
self.audiotokenizer = audiotokenizer |
|
|
self.lm = lm |
|
|
self.seperate_tokenizer = seperate_tokenizer |
|
|
|
|
|
if max_duration is None: |
|
|
if hasattr(lm, 'cfg'): |
|
|
max_duration = lm.cfg.dataset.segment_duration |
|
|
else: |
|
|
raise ValueError("You must provide max_duration when building directly CodecLM") |
|
|
assert max_duration is not None |
|
|
|
|
|
self.max_duration: float = max_duration |
|
|
self.device = next(iter(lm.parameters())).device |
|
|
self.generation_params: dict = {} |
|
|
|
|
|
self.set_generation_params(duration=15, extend_stride=self.max_duration // 2) |
|
|
self._progress_callback: tp.Optional[tp.Callable[[int, int], None]] = None |
|
|
if self.device.type == 'cpu': |
|
|
self.autocast = TorchAutocast(enabled=False) |
|
|
else: |
|
|
self.autocast = TorchAutocast(enabled=False) |
|
|
|
|
|
|
|
|
|
|
|
@property |
|
|
def frame_rate(self) -> float: |
|
|
"""Roughly the number of AR steps per seconds.""" |
|
|
return self.audiotokenizer.frame_rate |
|
|
|
|
|
@property |
|
|
def sample_rate(self) -> int: |
|
|
"""Sample rate of the generated audio.""" |
|
|
return self.audiotokenizer.sample_rate |
|
|
|
|
|
@property |
|
|
def audio_channels(self) -> int: |
|
|
"""Audio channels of the generated audio.""" |
|
|
return self.audiotokenizer.channels |
|
|
|
|
|
def set_generation_params(self, use_sampling: bool = True, top_k: int = 250, |
|
|
top_p: float = 0.0, temperature: float = 1.0, |
|
|
duration: float = 30.0, cfg_coef: float = 3.0, |
|
|
extend_stride: float = 18, record_tokens: bool = False, |
|
|
record_window: int = 50): |
|
|
"""Set the generation parameters for CodecLM. |
|
|
|
|
|
Args: |
|
|
use_sampling (bool, optional): Use sampling if True, else do argmax decoding. Defaults to True. |
|
|
top_k (int, optional): top_k used for sampling. Defaults to 250. |
|
|
top_p (float, optional): top_p used for sampling, when set to 0 top_k is used. Defaults to 0.0. |
|
|
temperature (float, optional): Softmax temperature parameter. Defaults to 1.0. |
|
|
duration (float, optional): Duration of the generated waveform. Defaults to 30.0. |
|
|
cfg_coef (float, optional): Coefficient used for classifier free guidance. Defaults to 3.0. |
|
|
two_step_cfg (bool, optional): If True, performs 2 forward for Classifier Free Guidance, |
|
|
instead of batching together the two. This has some impact on how things |
|
|
are padded but seems to have little impact in practice. |
|
|
extend_stride: when doing extended generation (i.e. more than 30 seconds), by how much |
|
|
should we extend the audio each time. Larger values will mean less context is |
|
|
preserved, and shorter value will require extra computations. |
|
|
""" |
|
|
assert extend_stride <= self.max_duration, "Cannot stride by more than max generation duration." |
|
|
self.extend_stride = extend_stride |
|
|
self.duration = duration |
|
|
self.generation_params = { |
|
|
'use_sampling': use_sampling, |
|
|
'temp': temperature, |
|
|
'top_k': top_k, |
|
|
'top_p': top_p, |
|
|
'cfg_coef': cfg_coef, |
|
|
'record_tokens': record_tokens, |
|
|
'record_window': record_window, |
|
|
} |
|
|
|
|
|
def set_custom_progress_callback(self, progress_callback: tp.Optional[tp.Callable[[int, int], None]] = None): |
|
|
"""Override the default progress callback.""" |
|
|
self._progress_callback = progress_callback |
|
|
|
|
|
|
|
|
def generate(self, lyrics: tp.List[str], |
|
|
descriptions: tp.List[str], |
|
|
melody_wavs: torch.Tensor = None, |
|
|
melody_is_wav: bool = True, |
|
|
vocal_wavs: torch.Tensor = None, |
|
|
bgm_wavs: torch.Tensor = None, |
|
|
return_tokens: bool = False, |
|
|
) -> tp.Union[torch.Tensor, tp.Tuple[torch.Tensor, torch.Tensor]]: |
|
|
"""Generate samples conditioned on text and melody. |
|
|
|
|
|
Args: |
|
|
descriptions (list of str): A list of strings used as text conditioning. |
|
|
melody_wavs: (torch.Tensor or list of Tensor): A batch of waveforms used as |
|
|
melody conditioning. Should have shape [B, C, T] with B matching the description length, |
|
|
C=1 or 2. It can be [C, T] if there is a single description. It can also be |
|
|
a list of [C, T] tensors. |
|
|
melody_sample_rate: (int): Sample rate of the melody waveforms. |
|
|
progress (bool, optional): Flag to display progress of the generation process. Defaults to False. |
|
|
""" |
|
|
if melody_wavs is not None: |
|
|
if melody_wavs.dim() == 2: |
|
|
melody_wavs = melody_wavs[None] |
|
|
if melody_wavs.dim() != 3: |
|
|
raise ValueError("Melody wavs should have a shape [B, C, T].") |
|
|
melody_wavs = list(melody_wavs) |
|
|
if vocal_wavs is not None: |
|
|
if vocal_wavs.dim() == 2: |
|
|
vocal_wavs = vocal_wavs[None] |
|
|
if vocal_wavs.dim() != 3: |
|
|
raise ValueError("Vocal wavs should have a shape [B, C, T].") |
|
|
vocal_wavs = list(vocal_wavs) |
|
|
if bgm_wavs is not None: |
|
|
if bgm_wavs.dim() == 2: |
|
|
bgm_wavs = bgm_wavs[None] |
|
|
if bgm_wavs.dim() != 3: |
|
|
raise ValueError("BGM wavs should have a shape [B, C, T].") |
|
|
bgm_wavs = list(bgm_wavs) |
|
|
|
|
|
texts, audio_qt_embs = self._prepare_tokens_and_attributes(lyrics=lyrics, melody_wavs=melody_wavs, vocal_wavs=vocal_wavs, bgm_wavs=bgm_wavs, melody_is_wav=melody_is_wav) |
|
|
tokens = self._generate_tokens(texts, descriptions, audio_qt_embs) |
|
|
|
|
|
if (tokens == self.lm.eos_token_id).any(): |
|
|
length = torch.nonzero(torch.eq(tokens, self.lm.eos_token_id))[:,-1].min() |
|
|
tokens = tokens[...,:length] |
|
|
|
|
|
if return_tokens: |
|
|
return tokens |
|
|
else: |
|
|
out = self.generate_audio(tokens) |
|
|
return out |
|
|
|
|
|
|
|
|
@torch.no_grad() |
|
|
def _prepare_tokens_and_attributes( |
|
|
self, |
|
|
lyrics: tp.Sequence[tp.Optional[str]], |
|
|
melody_wavs: tp.Optional[MelodyList] = None, |
|
|
vocal_wavs: tp.Optional[MelodyList] = None, |
|
|
bgm_wavs: tp.Optional[MelodyList] = None, |
|
|
melody_is_wav = True |
|
|
) -> tp.Tuple[tp.List[str], tp.List[torch.Tensor]]: |
|
|
"""Prepare model inputs. |
|
|
|
|
|
Args: |
|
|
descriptions (list of str): A list of strings used as text conditioning. |
|
|
prompt (torch.Tensor): A batch of waveforms used for continuation. |
|
|
melody_wavs (torch.Tensor, optional): A batch of waveforms |
|
|
used as melody conditioning. Defaults to None. |
|
|
""" |
|
|
assert len(lyrics) == 1 |
|
|
texts = [lyric for lyric in lyrics] |
|
|
audio_qt_embs = [] |
|
|
target_melody_token_len = self.lm.cfg.prompt_len * self.audiotokenizer.frame_rate |
|
|
|
|
|
if melody_wavs is None: |
|
|
melody_tokens = torch.full((1,1,target_melody_token_len), 16385, device=self.device).long() |
|
|
elif melody_wavs is not None: |
|
|
if 'prompt_audio' not in self.lm.condition_provider.conditioners: |
|
|
raise RuntimeError("This model doesn't support melody conditioning. " |
|
|
"Use the `melody` model.") |
|
|
assert len(melody_wavs) == len(texts), \ |
|
|
f"number of melody wavs must match number of descriptions! " \ |
|
|
f"got melody len={len(melody_wavs)}, and descriptions len={len(texts)}" |
|
|
if type(melody_wavs) == list: |
|
|
melody_wavs = torch.stack(melody_wavs, dim=0) |
|
|
melody_wavs = melody_wavs.to(self.device) |
|
|
if melody_is_wav: |
|
|
melody_tokens, scale = self.audiotokenizer.encode(melody_wavs) |
|
|
else: |
|
|
melody_tokens = melody_wavs |
|
|
if melody_tokens.shape[-1] > target_melody_token_len: |
|
|
melody_tokens = melody_tokens[...,:target_melody_token_len] |
|
|
elif melody_tokens.shape[-1] < target_melody_token_len: |
|
|
melody_tokens = torch.cat([melody_tokens, torch.full((1,1,target_melody_token_len - melody_tokens.shape[-1]), 16385, device=self.device).long()], dim=-1) |
|
|
if self.seperate_tokenizer is not None: |
|
|
if vocal_wavs is not None: |
|
|
if type(vocal_wavs) == list: |
|
|
vocal_wavs = torch.stack(vocal_wavs, dim=0) |
|
|
if bgm_wavs is None: |
|
|
use_bgm = False |
|
|
bgm_wavs = torch.zeros_like(vocal_wavs) |
|
|
bgm_wavs[:, 0] = 1.0 |
|
|
bgm_wavs[:, 1:] = torch.randn_like(bgm_wavs[:, 1:])* 0.0003 |
|
|
else: |
|
|
use_bgm = True |
|
|
if type(bgm_wavs) == list: |
|
|
bgm_wavs = torch.stack(bgm_wavs, dim=0) |
|
|
vocal_wavs = vocal_wavs.to(self.device) |
|
|
bgm_wavs = bgm_wavs.to(self.device) |
|
|
vocal_tokens, bgm_tokens = self.seperate_tokenizer.encode(vocal_wavs, bgm_wavs) |
|
|
assert len(vocal_tokens.shape) == len(bgm_tokens.shape) == 3, \ |
|
|
f"vocal and bgm tokens should have a shape [B, C, T]! " \ |
|
|
f"got vocal len={vocal_tokens.shape}, and bgm len={bgm_tokens.shape}" |
|
|
assert vocal_tokens.shape[-1] == bgm_tokens.shape[-1], \ |
|
|
f"vocal and bgm tokens should have the same length! " \ |
|
|
f"got vocal len={vocal_tokens.shape[-1]}, and bgm len={bgm_tokens.shape[-1]}" |
|
|
if not use_bgm: |
|
|
bgm_tokens = torch.full_like(bgm_tokens, 16385) |
|
|
if bgm_tokens.shape[-1] > target_melody_token_len: |
|
|
bgm_tokens = bgm_tokens[...,:target_melody_token_len] |
|
|
elif bgm_tokens.shape[-1] < target_melody_token_len: |
|
|
bgm_tokens = torch.cat([bgm_tokens, torch.full((1,1,target_melody_token_len - bgm_tokens.shape[-1]), 16385, device=self.device).long()], dim=-1) |
|
|
if vocal_tokens.shape[-1] > target_melody_token_len: |
|
|
vocal_tokens = vocal_tokens[...,:target_melody_token_len] |
|
|
elif vocal_tokens.shape[-1] < target_melody_token_len: |
|
|
vocal_tokens = torch.cat([vocal_tokens, torch.full((1,1,target_melody_token_len - vocal_tokens.shape[-1]), 16385, device=self.device).long()], dim=-1) |
|
|
else: |
|
|
bgm_tokens = torch.full((1,1,target_melody_token_len), 16385, device=self.device).long() |
|
|
vocal_tokens = torch.full((1,1,target_melody_token_len), 16385, device=self.device).long() |
|
|
|
|
|
melody_tokens = torch.cat([melody_tokens, vocal_tokens, bgm_tokens], dim=1) |
|
|
assert melody_tokens.shape[-1] == target_melody_token_len |
|
|
audio_qt_embs = melody_tokens.long() |
|
|
return texts, audio_qt_embs |
|
|
|
|
|
|
|
|
|
|
|
def _generate_tokens(self, |
|
|
texts: tp.Optional[tp.List[str]] = None, |
|
|
descriptions: tp.Optional[tp.List[str]] = None, |
|
|
audio_qt_embs: tp.Optional[tp.List[torch.Tensor]] = None) -> torch.Tensor: |
|
|
"""Generate discrete audio tokens given audio prompt and/or conditions. |
|
|
|
|
|
Args: |
|
|
attributes (list of ConditioningAttributes): Conditions used for generation (text/melody). |
|
|
prompt_tokens (torch.Tensor, optional): Audio prompt used for continuation. |
|
|
progress (bool, optional): Flag to display progress of the generation process. Defaults to False. |
|
|
Returns: |
|
|
torch.Tensor: Generated audio, of shape [B, C, T], T is defined by the generation params. |
|
|
""" |
|
|
total_gen_len = int(self.duration * self.frame_rate) |
|
|
current_gen_offset: int = 0 |
|
|
|
|
|
def _progress_callback(generated_tokens: int, tokens_to_generate: int): |
|
|
generated_tokens += current_gen_offset |
|
|
if self._progress_callback is not None: |
|
|
|
|
|
|
|
|
self._progress_callback(generated_tokens, total_gen_len) |
|
|
else: |
|
|
print(f'{generated_tokens: 6d} / {total_gen_len: 6d}', end='\r') |
|
|
|
|
|
if self.duration <= self.max_duration: |
|
|
|
|
|
with self.autocast: |
|
|
gen_tokens = self.lm.generate(texts=texts, |
|
|
descriptions=descriptions, |
|
|
audio_qt_embs=audio_qt_embs, |
|
|
max_gen_len=total_gen_len, |
|
|
**self.generation_params) |
|
|
else: |
|
|
raise NotImplementedError(f"duration {self.duration} < max duration {self.max_duration}") |
|
|
return gen_tokens |
|
|
|
|
|
@torch.no_grad() |
|
|
def generate_audio(self, gen_tokens: torch.Tensor, prompt=None, vocal_prompt=None, bgm_prompt=None): |
|
|
"""Generate Audio from tokens""" |
|
|
assert gen_tokens.dim() == 3 |
|
|
if self.seperate_tokenizer is not None: |
|
|
gen_tokens_song = gen_tokens[:, [0], :] |
|
|
gen_tokens_vocal = gen_tokens[:, [1], :] |
|
|
gen_tokens_bgm = gen_tokens[:, [2], :] |
|
|
|
|
|
gen_audio_seperate = self.seperate_tokenizer.decode([gen_tokens_vocal, gen_tokens_bgm], vocal_prompt, bgm_prompt) |
|
|
return gen_audio_seperate |
|
|
else: |
|
|
gen_audio = self.audiotokenizer.decode(gen_tokens, prompt) |
|
|
return gen_audio |
|
|
|