Gunmen killed eight people and wounded three others at a birthday party in South Africa at the weekend before fleeing, police said.