Multimillion-dollar payouts are becoming more common for residents in rent-regulated apartments in exceptionally lucrative New York real estate.