API: added method for randomly getting up to N seqs per sample

Randomly get up to N sequences per sample from a sequence file
Can you please add ```optional``` to this line, and indicate default on the next?