import math from typing import Optional, Union import torch from PIL import Image from transformers import Qwen2VLForConditionalGeneration ImageInput = Union[Image.Image, list[Image.Image], tuple[Image.Image, ...]] HPSV3_INSTRUCTION = """ You are tasked with evaluating a generated image based on Visual Quality and Text Alignment and give a overall score to estimate the human preference. Please provide a rating from 0 to 10, with 0 being the worst and 10 being the best. **Visual Quality:** Evaluate the overall visual quality of the image. The following sub-dimensions should be considered: - **Reasonableness:** The image should not contain any significant biological or logical errors, such as abnormal body structures or nonsensical environmental setups. - **Clarity:** Evaluate the sharpness and visibility of the image. The image should be clear and easy to interpret, with no blurring or indistinct areas. - **Detail Richness:** Consider the level of detail in textures, materials, lighting, and other visual elements (e.g., hair, clothing, shadows). - **Aesthetic and Creativity:** Assess the artistic aspects of the image, including the color scheme, composition, atmosphere, depth of field, and the overall creative appeal. The scene should convey a sense of harmony and balance. - **Safety:** The image should not contain harmful or inappropriate content, such as political, violent, or adult material. If such content is present, the image quality and satisfaction score should be the lowest possible. **Text Alignment:** Assess how well the image matches the textual prompt across the following sub-dimensions: - **Subject Relevance** Evaluate how accurately the subject(s) in the image (e.g., person, animal, object) align with the textual description. The subject should match the description in terms of number, appearance, and behavior. - **Style Relevance:** If the prompt specifies a particular artistic or stylistic style, evaluate how well the image adheres to this style. - **Contextual Consistency**: Assess whether the background, setting, and surrounding elements in the image logically fit the scenario described in the prompt. The environment should support and enhance the subject without contradictions. - **Attribute Fidelity**: Check if specific attributes mentioned in the prompt (e.g., colors, clothing, accessories, expressions, actions) are faithfully represented in the image. Minor deviations may be acceptable, but critical attributes should be preserved. - **Semantic Coherence**: Evaluate whether the overall meaning and intent of the prompt are captured in the image. The generated content should not introduce elements that conflict with or distort the original description. Textual prompt - {text_prompt} """ HPSV3_PROMPT_WITH_SPECIAL_TOKEN = """ Please provide the overall ratings of this image: <|Reward|> END """ HPSV3_PROMPT_WITHOUT_SPECIAL_TOKEN = """ Please provide the overall ratings of this image: """ def _as_list(value): if isinstance(value, (list, tuple)): return list(value) return [value] def _round_by_factor(number, factor): return round(number / factor) * factor def _ceil_by_factor(number, factor): return math.ceil(number / factor) * factor def _floor_by_factor(number, factor): return math.floor(number / factor) * factor def _smart_resize(height, width, factor=28, min_pixels=256 * 28 * 28, max_pixels=256 * 28 * 28): if max(height, width) / min(height, width) > 200: raise ValueError(f"Image aspect ratio must be smaller than 200, got {max(height, width) / min(height, width)}.") h_bar = max(factor, _round_by_factor(height, factor)) w_bar = max(factor, _round_by_factor(width, factor)) if h_bar * w_bar > max_pixels: beta = math.sqrt((height * width) / max_pixels) h_bar = _floor_by_factor(height / beta, factor) w_bar = _floor_by_factor(width / beta, factor) elif h_bar * w_bar < min_pixels: beta = math.sqrt(min_pixels / (height * width)) h_bar = _ceil_by_factor(height * beta, factor) w_bar = _ceil_by_factor(width * beta, factor) return h_bar, w_bar class HPSv3RewardModelMixin: def init_reward_head( self, output_dim=2, reward_token="special", special_token_ids=None, rm_head_type="ranknet", rm_head_kwargs=None, ): self.output_dim = output_dim self.reward_token = "special" if special_token_ids is not None else reward_token self.special_token_ids = special_token_ids hidden_size = getattr(self.config, "hidden_size", None) if hidden_size is None and hasattr(self.config, "text_config"): hidden_size = self.config.text_config.hidden_size if rm_head_type == "ranknet": rm_head_kwargs = rm_head_kwargs or {} hidden = rm_head_kwargs.get("hidden_size", 1024) dropout = rm_head_kwargs.get("dropout", 0.05) self.rm_head = torch.nn.Sequential( torch.nn.Linear(hidden_size, hidden), torch.nn.ReLU(), torch.nn.Dropout(dropout), torch.nn.Linear(hidden, 16), torch.nn.ReLU(), torch.nn.Linear(16, output_dim), ) else: self.rm_head = torch.nn.Linear(hidden_size, output_dim, bias=False) self.rm_head.to(torch.float32) def forward( self, input_ids: torch.LongTensor = None, attention_mask: Optional[torch.Tensor] = None, position_ids: Optional[torch.LongTensor] = None, past_key_values: Optional[list[torch.FloatTensor]] = None, inputs_embeds: Optional[torch.FloatTensor] = None, labels: Optional[torch.LongTensor] = None, use_cache: Optional[bool] = None, output_attentions: Optional[bool] = None, output_hidden_states: Optional[bool] = None, return_dict: Optional[bool] = None, pixel_values: Optional[torch.Tensor] = None, pixel_values_videos: Optional[torch.FloatTensor] = None, image_grid_thw: Optional[torch.LongTensor] = None, video_grid_thw: Optional[torch.LongTensor] = None, rope_deltas: Optional[torch.LongTensor] = None, **kwargs, ): output_attentions = output_attentions if output_attentions is not None else self.config.output_attentions output_hidden_states = output_hidden_states if output_hidden_states is not None else self.config.output_hidden_states return_dict = return_dict if return_dict is not None else self.config.use_return_dict kwargs.pop("logits_to_keep", None) mm_token_type_ids = kwargs.pop("mm_token_type_ids", None) outputs = self.model( input_ids=input_ids, attention_mask=attention_mask, position_ids=position_ids, past_key_values=past_key_values, inputs_embeds=inputs_embeds, use_cache=use_cache, pixel_values=pixel_values, pixel_values_videos=pixel_values_videos, image_grid_thw=image_grid_thw, video_grid_thw=video_grid_thw, rope_deltas=rope_deltas, mm_token_type_ids=mm_token_type_ids, output_attentions=output_attentions, output_hidden_states=output_hidden_states, return_dict=return_dict, **kwargs, ) hidden_states = outputs.last_hidden_state if hasattr(outputs, "last_hidden_state") else outputs[0] logits = self.rm_head(hidden_states.to(next(self.rm_head.parameters()).dtype)) batch_size = input_ids.shape[0] if input_ids is not None else inputs_embeds.shape[0] pad_token_id = getattr(self.config, "pad_token_id", None) if pad_token_id is None and hasattr(self.config, "text_config"): pad_token_id = getattr(self.config.text_config, "pad_token_id", None) if pad_token_id is None and batch_size != 1: raise ValueError("Cannot handle batch sizes > 1 if no padding token is defined.") if pad_token_id is None: sequence_lengths = -1 elif input_ids is not None: sequence_lengths = torch.eq(input_ids, pad_token_id).int().argmax(-1) - 1 sequence_lengths = sequence_lengths % input_ids.shape[-1] sequence_lengths = sequence_lengths.to(logits.device) else: sequence_lengths = -1 if self.reward_token == "last": pooled_logits = logits[torch.arange(batch_size, device=logits.device), sequence_lengths] elif self.reward_token == "mean": valid_lengths = torch.clamp(sequence_lengths, min=0, max=logits.size(1) - 1) pooled_logits = torch.stack([logits[i, : valid_lengths[i]].mean(dim=0) for i in range(batch_size)]) elif self.reward_token == "special": if self.special_token_ids is None: raise ValueError("HPSv3 reward_token='special' requires special_token_ids.") special_token_mask = torch.zeros_like(input_ids, dtype=torch.bool) for special_token_id in self.special_token_ids: special_token_mask = special_token_mask | (input_ids == special_token_id) pooled_logits = logits[special_token_mask, ...].view(batch_size, -1) else: raise ValueError(f"Invalid HPSv3 reward token mode: {self.reward_token}") return {"logits": pooled_logits} class HPSv3Qwen2VLRewardModel(HPSv3RewardModelMixin, Qwen2VLForConditionalGeneration): def __init__( self, config=None, vocab_size=None, output_dim=2, reward_token="special", special_token_ids=None, rm_head_type="ranknet", rm_head_kwargs=None, ): if config is None: config = self.default_config(vocab_size or 151658) elif vocab_size is not None and hasattr(config, "text_config"): config.text_config.vocab_size = vocab_size super().__init__(config) self.init_reward_head( output_dim=output_dim, reward_token=reward_token, special_token_ids=special_token_ids, rm_head_type=rm_head_type, rm_head_kwargs=rm_head_kwargs, ) @staticmethod def default_config(vocab_size=151658): from transformers import Qwen2VLConfig return Qwen2VLConfig( text_config={ "vocab_size": vocab_size, "hidden_size": 3584, "intermediate_size": 18944, "num_hidden_layers": 28, "num_attention_heads": 28, "num_key_value_heads": 4, "hidden_act": "silu", "max_position_embeddings": 32768, "initializer_range": 0.02, "rms_norm_eps": 1e-6, "use_cache": True, "use_sliding_window": False, "sliding_window": 32768, "max_window_layers": 28, "attention_dropout": 0.0, "rope_parameters": { "rope_type": "default", "type": "mrope", "mrope_section": [16, 24, 24], "rope_theta": 1000000.0, }, "bos_token_id": 151643, "eos_token_id": 151645, }, vision_config={ "depth": 32, "embed_dim": 1280, "hidden_size": 3584, "mlp_ratio": 4, "num_heads": 16, "in_channels": 3, "patch_size": 14, "spatial_merge_size": 2, "temporal_patch_size": 2, }, image_token_id=151655, video_token_id=151656, vision_start_token_id=151652, vision_end_token_id=151653, tie_word_embeddings=False, ) class HPSv3Model(torch.nn.Module): def __init__( self, model, processor, use_special_tokens=True, max_pixels=256 * 28 * 28, min_pixels=256 * 28 * 28, score_index=0, ): super().__init__() self.model = model self.processor = processor self.use_special_tokens = use_special_tokens self.max_pixels = max_pixels self.min_pixels = min_pixels self.score_index = score_index @property def device(self): return next(self.parameters(), torch.tensor([])).device def _normalize_inputs(self, prompts, images): images = _as_list(images) prompts = _as_list(prompts) if len(prompts) == 1 and len(images) > 1: prompts = prompts * len(images) if len(images) == 1 and len(prompts) > 1: images = images * len(prompts) if len(prompts) != len(images): raise ValueError(f"Expected the same number of prompts and images, got {len(prompts)} and {len(images)}.") return prompts, images def _prepare_images(self, images): prepared = [] for image in images: image = image.convert("RGB") height, width = image.height, image.width resized_height, resized_width = _smart_resize( height, width, min_pixels=self.min_pixels, max_pixels=self.max_pixels, ) prepared.append(image.resize((resized_width, resized_height), Image.BICUBIC)) return prepared def _messages(self, prompts, images): suffix = HPSV3_PROMPT_WITH_SPECIAL_TOKEN if self.use_special_tokens else HPSV3_PROMPT_WITHOUT_SPECIAL_TOKEN messages = [] for prompt, image in zip(prompts, images): messages.append( [ { "role": "user", "content": [ {"type": "image", "image": image}, {"type": "text", "text": HPSV3_INSTRUCTION.format(text_prompt=prompt) + suffix}, ], } ] ) return messages def _prepare_batch(self, prompts, images): images = self._prepare_images(images) messages = self._messages(prompts, images) text = self.processor.apply_chat_template(messages, tokenize=False, add_generation_prompt=True) batch = self.processor(text=text, images=images, padding=True, return_tensors="pt") return batch.to(self.device) @torch.no_grad() def forward(self, prompts: Union[str, list[str]], images): prompts, images = self._normalize_inputs(prompts, images) batch = self._prepare_batch(prompts, images) rewards = self.model(return_dict=True, **batch)["logits"] if rewards.ndim == 2: return rewards[:, self.score_index] return rewards