Transformers 文件
GLM-4.1V
並獲得增強的文件體驗
開始使用
GLM-4.1V
以下示例演示瞭如何使用 Pipeline 或 AutoModel 類根據影像生成文字。
import torch
from transformers import pipeline
pipe = pipeline(
task="image-text-to-text",
model="THUDM/GLM-4.1V-9B-Thinking",
device=0,
torch_dtype=torch.bfloat16
)
messages = [
{
"role": "user",
"content": [
{
"type": "image",
"url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/pipeline-cat-chonk.jpeg",
},
{ "type": "text", "text": "Describe this image."},
]
}
]
pipe(text=messages,max_new_tokens=20, return_full_text=False)
將 GLM-4.1V 與影片輸入一起使用與將其與影像輸入一起使用類似。該模型可以處理影片資料並根據影片內容生成文字。
from transformers import AutoProcessor, Glm4vForConditionalGeneration
import torch
processor = AutoProcessor.from_pretrained("THUDM/GLM-4.1V-9B-Thinking")
model = Glm4vForConditionalGeneration.from_pretrained(
pretrained_model_name_or_path="THUDM/GLM-4.1V-9B-Thinking",
torch_dtype=torch.bfloat16,
device_map="cuda:0"
)
messages = [
{
"role": "user",
"content": [
{
"type": "video",
"url": "https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/720/Big_Buck_Bunny_720_10s_10MB.mp4",
},
{
"type": "text",
"text": "discribe this video",
},
],
}
]
inputs = processor.apply_chat_template(messages, tokenize=True, add_generation_prompt=True, return_dict=True, return_tensors="pt", padding=True).to("cuda:0")
generated_ids = model.generate(**inputs, max_new_tokens=1024, do_sample=True, temperature=1.0)
output_text = processor.decode(generated_ids[0][inputs["input_ids"].shape[1] :], skip_special_tokens=True)
print(output_text)
Glm4vConfig
class transformers.Glm4vConfig
< 來源 >( text_config = None vision_config = None image_token_id = 151343 video_token_id = 151344 image_start_token_id = 151339 image_end_token_id = 151340 video_start_token_id = 151341 video_end_token_id = 151342 **kwargs )
引數
- text_config (
Union[PreTrainedConfig, dict]
, 可選, 預設為Glm4vTextConfig
) — 文字主幹的配置物件或字典。 - vision_config (
Union[PreTrainedConfig, dict]
, 可選, 預設為Glm4vVisionConfig
) — 視覺主幹的配置物件或字典。 - image_token_id (
int
, 可選, 預設為 151343) — 用於編碼影像提示的影像令牌索引。 - video_token_id (
int
, 可選, 預設為 151344) — 用於編碼影像提示的影片令牌索引。 - image_start_token_id (
int
, 可選, 預設為 151339) — 用於編碼影像開頭的影像開始令牌索引。 - image_end_token_id (
int
, 可選, 預設為 151340) — 用於編碼影像末尾的影像結束令牌索引。 - video_start_token_id (
int
, 可選, 預設為 151341) — 用於編碼影片開頭的影片開始令牌索引。 - video_end_token_id (
int
, 可選, 預設為 151342) — 用於編碼影片末尾的影片結束令牌索引。
這是用於儲存 Glm4vModel 配置的配置類。它用於根據指定的引數例項化 GLM-4.1V 模型,定義模型架構。使用預設值例項化配置將生成與 GLM-4.1V-9B-Thinking THUDM/GLM-4.1V-9B-Thinking 類似的配置。
配置物件繼承自 PretrainedConfig,可用於控制模型輸出。有關更多資訊,請參閱 PretrainedConfig 的文件。
>>> from transformers import Glm4vForConditionalGeneration, Glm4vConfig
>>> # Initializing a GLM-4.1V style configuration
>>> configuration = Glm4vConfig()
>>> # Initializing a model from the GLM-4.1V style configuration
>>> model = Glm4vForConditionalGeneration(configuration)
>>> # Accessing the model configuration
>>> configuration = model.config
Glm4vTextConfig
class transformers.Glm4vTextConfig
< 來源 >( vocab_size = 151552 hidden_size = 4096 intermediate_size = 13696 num_hidden_layers = 40 num_attention_heads = 32 num_key_value_heads = 2 hidden_act = 'silu' max_position_embeddings = 32768 initializer_range = 0.02 rms_norm_eps = 1e-05 use_cache = True tie_word_embeddings = False rope_theta = 10000.0 attention_dropout = 0.0 rope_scaling = None image_token_id = None video_token_id = None **kwargs )
引數
- vocab_size (
int
, 可選, 預設為 151552) — Glm4v 模型的詞彙量。定義了呼叫 Glm4vModel 時傳遞的inputs_ids
可以表示的不同令牌的數量。 - hidden_size (
int
, 可選, 預設為 4096) — 隱藏表示的維度。 - intermediate_size (
int
, 可選, 預設為 13696) — MLP 表示的維度。 - num_hidden_layers (
int
, 可選, 預設為 40) — Transformer 編碼器中的隱藏層數量。 - num_attention_heads (
int
, 可選, 預設為 32) — Transformer 編碼器中每個注意力層的注意力頭數量。 - num_key_value_heads (
int
, 可選, 預設為 2) — 用於實現分組查詢注意力(Grouped Query Attention)的鍵值頭數量。如果num_key_value_heads=num_attention_heads
,模型將使用多頭注意力(MHA);如果num_key_value_heads=1
,模型將使用多查詢注意力(MQA),否則使用 GQA。將多頭檢查點轉換為 GQA 檢查點時,每個分組鍵和值頭應透過對該組內的所有原始頭進行均值池化來構建。有關更多詳細資訊,請檢視 此論文。如果未指定,將預設為32
。 - hidden_act (
str
或function
, 可選, 預設為"silu"
) — 解碼器中的非線性啟用函式(函式或字串)。 - max_position_embeddings (
int
, 可選, 預設為 32768) — 此模型可能使用的最大序列長度。 - initializer_range (
float
, 可選, 預設為 0.02) — 用於初始化所有權重矩陣的 truncated_normal_initializer 的標準差。 - rms_norm_eps (
float
, 可選, 預設為 1e-05) — RMS 歸一化層使用的 epsilon。 - use_cache (
bool
, 可選, 預設為True
) — 模型是否應返回最後一個鍵/值注意力(並非所有模型都使用)。僅在config.is_decoder=True
時相關。 - tie_word_embeddings (
bool
, 可選, 預設為False
) — 模型的輸入和輸出詞嵌入是否應繫結。 - rope_theta (
float
, 可選, 預設為 10000.0) — RoPE 嵌入的基週期。 - attention_dropout (
float
, 可選, 預設為 0.0) — 注意力機率的 dropout 比率。 - rope_scaling (
Dict
, 可選) — 包含 RoPE 嵌入縮放配置的字典。注意:如果您應用新的 RoPE 型別並期望模型能在更長的max_position_embeddings
上工作,我們建議您相應地更新此值。預期內容:rope_type
(str
): 要使用的 RoPE 子變體。可以是 ['default', 'linear', 'dynamic', 'yarn', 'longrope', 'llama3'] 之一,其中 'default' 是原始 RoPE 實現。factor
(float
, 可選): 除 'default' 外的所有 RoPE 型別均使用。應用於 RoPE 嵌入的縮放因子。在大多數縮放型別中,x 的factor
將使模型能夠處理長度為 x * 原始最大預訓練長度的序列。original_max_position_embeddings
(int
, 可選): 與 'dynamic', 'longrope' 和 'llama3' 一起使用。預訓練期間使用的原始最大位置嵌入。attention_factor
(float
, 可選): 與 'yarn' 和 'longrope' 一起使用。應用於注意力計算的縮放因子。如果未指定,則預設為實現建議的值,使用factor
欄位推斷建議值。 - image_token_id (
int
, 可選) — 用作影像嵌入佔位符的令牌索引。 - video_token_id (
int
, 可選) — 用作影片嵌入佔位符的令牌索引。
這是用於儲存 Glm4vModel 配置的配置類。它用於根據指定的引數例項化 GLM-4.1V 模型,定義模型架構。使用預設值例項化配置將生成與 GLM-4.1V-9B-Thinking THUDM/GLM-4.1V-9B-Thinking 類似的配置。
配置物件繼承自 PretrainedConfig,可用於控制模型輸出。有關更多資訊,請參閱 PretrainedConfig 的文件。
>>> from transformers import Glm4vTextModel, Glm4vConfig
>>> # Initializing a GLM-4.1V style configuration
>>> configuration = Glm4vConfig()
>>> # Initializing a model from the GLM-4.1V style configuration
>>> model = Glm4vTextModel(configuration)
>>> # Accessing the model configuration
>>> configuration = model.config
Glm4vImageProcessor
class transformers.Glm4vImageProcessor
< 來源 >( do_resize: bool = True size: typing.Optional[dict[str, int]] = None resample: Resampling = <Resampling.BICUBIC: 3> do_rescale: bool = True rescale_factor: typing.Union[int, float] = 0.00392156862745098 do_normalize: bool = True image_mean: typing.Union[float, list[float], NoneType] = None image_std: typing.Union[float, list[float], NoneType] = None do_convert_rgb: bool = True patch_size: int = 14 temporal_patch_size: int = 2 merge_size: int = 2 **kwargs )
引數
- do_resize (
bool
, 可選, 預設為True
) — 是否調整影像的(高度,寬度)尺寸。 - size (
Dict[str, int]
可選, 預設為{"shortest_edge" -- 112 * 112, "longest_edge": 28 * 28 * 15000}
): 調整大小後圖像的(height, width)
尺寸。可透過preprocess
方法中的size
引數覆蓋。可用選項包括:{"height": int, "width": int}
: 影像將調整為確切的大小(height, width)
。不保留縱橫比。{"shortest_edge": int, "longest_edge": int}
: 影像將調整為最大尺寸,同時保持縱橫比,並將最短邊小於或等於shortest_edge
,最長邊小於或等於longest_edge
。{"max_height": int, "max_width": int}
: 影像將調整為最大尺寸,同時保持縱橫比,並將高度小於或等於max_height
,寬度小於或等於max_width
。
- resample (
PILImageResampling
, 可選, 預設為Resampling.BICUBIC
) — 調整影像大小時使用的重取樣過濾器。 - do_rescale (
bool
, 可選, 預設為True
) — 是否按指定的比例rescale_factor
重新縮放影像。 - rescale_factor (
int
或float
, 可選, 預設為1/255
) — 如果重新縮放影像,則使用的縮放因子。 - do_normalize (
bool
, 可選, 預設為True
) — 是否對影像進行歸一化。 - image_mean (
float
或List[float]
, 可選, 預設為[0.48145466, 0.4578275, 0.40821073]
) — 用於影像歸一化的均值。這是一個浮點數或影像每個通道的浮點數列表。 - image_std (
float
或List[float]
, 可選, 預設為[0.26862954, 0.26130258, 0.27577711]
) — 用於影像歸一化的標準差。這是一個浮點數或影像每個通道的浮點數列表。 - do_convert_rgb (
bool
, 可選, 預設為True
) — 是否將影像轉換為 RGB 格式。 - patch_size (
int
, 可選, 預設為 14) — 視覺編碼器的空間補丁大小。 - temporal_patch_size (
int
, 可選, 預設為 2) — 視覺編碼器的時間補丁大小。 - merge_size (
int
, 可選, 預設為 2) — 視覺編碼器到 LLM 編碼器的合併大小。
構建一個 GLM-4V 影像處理器,它根據原始影像動態調整影像大小。
預處理
< 源 >( images: typing.Union[ForwardRef('PIL.Image.Image'), numpy.ndarray, ForwardRef('torch.Tensor'), list['PIL.Image.Image'], list[numpy.ndarray], list['torch.Tensor']] videos: typing.Union[list['PIL.Image.Image'], ForwardRef('np.ndarray'), ForwardRef('torch.Tensor'), list['np.ndarray'], list['torch.Tensor'], list[list['PIL.Image.Image']], list[list['np.ndarrray']], list[list['torch.Tensor']]] = None do_resize: typing.Optional[bool] = None size: typing.Optional[dict[str, int]] = None resample: Resampling = None do_rescale: typing.Optional[bool] = None rescale_factor: typing.Optional[float] = None do_normalize: typing.Optional[bool] = None image_mean: typing.Union[float, list[float], NoneType] = None image_std: typing.Union[float, list[float], NoneType] = None patch_size: typing.Optional[int] = None temporal_patch_size: typing.Optional[int] = None merge_size: typing.Optional[int] = None do_convert_rgb: typing.Optional[bool] = None return_tensors: typing.Union[str, transformers.utils.generic.TensorType, NoneType] = None data_format: typing.Optional[transformers.image_utils.ChannelDimension] = <ChannelDimension.FIRST: 'channels_first'> input_data_format: typing.Union[str, transformers.image_utils.ChannelDimension, NoneType] = None )
引數
- images (
ImageInput
) — 待預處理的影像。期望畫素值範圍為 0 到 255 的單張或批處理影像。如果傳入畫素值範圍在 0 到 1 之間的影像,請設定do_rescale=False
。 - videos (
VideoInput
) — 待預處理的影片。期望畫素值範圍為 0 到 255 的單個或批處理影片。如果傳入畫素值範圍在 0 到 1 之間的影片,請設定do_rescale=False
。 - do_resize (
bool
, 可選, 預設為self.do_resize
) — 是否調整影像大小。 - size (
Dict[str, int]
, 可選, 預設為self.size
) — 調整大小後的影像大小。影像的最短邊將調整為 size["shortest_edge"],最長邊將保持輸入寬高比進行調整。 - resample (
int
, 可選, 預設為self.resample
) — 如果調整影像大小,要使用的重取樣濾鏡。可以是列舉PILImageResampling
之一。僅當do_resize
設定為True
時有效。 - do_rescale (
bool
, 可選, 預設為self.do_rescale
) — 是否重新縮放影像。 - rescale_factor (
float
, 可選, 預設為self.rescale_factor
) — 如果do_rescale
設定為True
,則用於重新縮放影像的縮放因子。 - do_normalize (
bool
, 可選, 預設為self.do_normalize
) — 是否歸一化影像。 - image_mean (
float
或List[float]
, 可選, 預設為self.image_mean
) — 用於歸一化的影像均值。僅當do_normalize
設定為True
時有效。 - image_std (
float
或List[float]
, 可選, 預設為self.image_std
) — 用於歸一化的影像標準差。僅當do_normalize
設定為True
時有效。要調整影像大小的最大畫素數。 - patch_size (
int
, 可選, 預設為self.patch_size
) — 視覺編碼器的空間補丁大小。 - temporal_patch_size (
int
, 可選, 預設為self.temporal_patch_size
) — 視覺編碼器的時間補丁大小。 - merge_size (
int
, 可選, 預設為self.merge_size
) — 視覺編碼器到 LLM 編碼器的合併大小。 - do_convert_rgb (
bool
, 可選, 預設為self.do_convert_rgb
) — 是否將影像轉換為 RGB 格式。 - return_tensors (
str
或TensorType
, 可選) — 要返回的張量型別。可以是以下之一:- 未設定:返回
np.ndarray
列表。 TensorType.TENSORFLOW
或'tf'
:返回tf.Tensor
型別的批處理。TensorType.PYTORCH
或'pt'
:返回torch.Tensor
型別的批處理。TensorType.NUMPY
或'np'
:返回np.ndarray
型別的批處理。TensorType.JAX
或'jax'
:返回jax.numpy.ndarray
型別的批處理。
- 未設定:返回
- data_format (
ChannelDimension
或str
, 可選, 預設為ChannelDimension.FIRST
) — 輸出影像的通道維度格式。可以是以下之一:"channels_first"
或ChannelDimension.FIRST
:影像格式為 (num_channels, height, width)。"channels_last"
或ChannelDimension.LAST
:影像格式為 (height, width, num_channels)。- 未設定:使用輸入影像的通道維度格式。
- input_data_format (
ChannelDimension
或str
, 可選) — 輸入影像的通道維度格式。如果未設定,則從輸入影像推斷通道維度格式。可以是以下之一:"channels_first"
或ChannelDimension.FIRST
:影像格式為 (num_channels, height, width)。"channels_last"
或ChannelDimension.LAST
:影像格式為 (height, width, num_channels)。"none"
或ChannelDimension.NONE
:影像格式為 (height, width)。
Glm4vVideoProcessor
class transformers.Glm4vVideoProcessor
< 源 >( **kwargs: typing_extensions.Unpack[transformers.models.glm4v.video_processing_glm4v.Glm4vVideoProcessorInitKwargs] )
引數
- do_resize (
bool
, 可選, 預設為self.do_resize
) — 是否將影片的 (height, width) 維度調整到指定的size
。可在preprocess
方法中的do_resize
引數覆蓋。 - size (
dict
, 可選, 預設為self.size
) — 調整大小後的輸出影片的大小。可在preprocess
方法中的size
引數覆蓋。 - size_divisor (
int
, 可選, 預設為self.size_divisor
) — 確保高度和寬度都可以被其整除的大小。 - default_to_square (
bool
, 可選, 預設為self.default_to_square
) — 如果大小為整數,是否在調整影片大小時預設為方形影片。 - resample (
PILImageResampling
, 可選, 預設為self.resample
) — 如果調整影片大小,要使用的重取樣濾鏡。僅當do_resize
設定為True
時有效。可在preprocess
方法中的resample
引數覆蓋。 - do_center_crop (
bool
, 可選, 預設為self.do_center_crop
) — 是否將影片中心裁剪到指定的crop_size
。可在preprocess
方法中的do_center_crop
覆蓋。 - do_pad (
bool
, 可選) — 是否將影片填充到批處理中影片的(max_height, max_width)
。 - crop_size (
dict[str, int]
可選, 預設為self.crop_size
) — 應用center_crop
後的輸出影片大小。可在preprocess
方法中的crop_size
覆蓋。 - do_rescale (
bool
, 可選, 預設為self.do_rescale
) — 是否按指定的比例rescale_factor
重新縮放影片。可在preprocess
方法中的do_rescale
引數覆蓋。 - rescale_factor (
int
或float
, 可選, 預設為self.rescale_factor
) — 如果do_rescale
設定為True
,則用於重新縮放影片的縮放因子。可在preprocess
方法中的rescale_factor
引數覆蓋。 - do_normalize (
bool
, 可選, 預設為self.do_normalize
) — 是否歸一化影片。可在preprocess
方法中的do_normalize
引數覆蓋。可在preprocess
方法中的do_normalize
引數覆蓋。 - image_mean (
float
或list[float]
, 可選, 預設為self.image_mean
) — 用於影片歸一化的均值。這是一個浮點數或影片中通道數長度的浮點數列表。可在preprocess
方法中的image_mean
引數覆蓋。可在preprocess
方法中的image_mean
引數覆蓋。 - image_std (
float
或list[float]
, 可選, 預設為self.image_std
) — 用於影片歸一化的標準差。這是一個浮點數或影片中通道數長度的浮點數列表。可在preprocess
方法中的image_std
引數覆蓋。可在preprocess
方法中的image_std
引數覆蓋。 - do_convert_rgb (
bool
, 可選, 預設為self.image_std
) — 是否將影片轉換為 RGB 格式。 - video_metadata (
VideoMetadata
, 可選) — 影片的元資料,包含總時長、幀率和總幀數資訊。 - do_sample_frames (
int
, 可選, 預設為self.do_sample_frames
) — 是否在處理前從影片中取樣幀或處理整個影片。 - num_frames (
int
, 可選, 預設為self.num_frames
) — 當do_sample_frames=True
時要取樣的最大幀數。 - fps (
int
, 可選, 預設為self.fps
) — 當do_sample_frames=True
時,每秒取樣的目標幀數。 - return_tensors (
str
或TensorType
, 可選) — 如果設定為 `pt` 則返回堆疊的張量,否則返回張量列表。 - data_format (
ChannelDimension
或str
, 可選, 預設為ChannelDimension.FIRST
) — 輸出影片的通道維度格式。可以是以下之一:"channels_first"
或ChannelDimension.FIRST
:影片格式為 (num_channels, height, width)。"channels_last"
或ChannelDimension.LAST
:影片格式為 (height, width, num_channels)。- 未設定:使用輸入影片的通道維度格式。
- input_data_format (
ChannelDimension
或str
, 可選) — 輸入影片的通道維度格式。如果未設定,則從輸入影片推斷通道維度格式。可以是以下之一:"channels_first"
或ChannelDimension.FIRST
:影片格式為 (num_channels, height, width)。"channels_last"
或ChannelDimension.LAST
:影片格式為 (height, width, num_channels)。"none"
或ChannelDimension.NONE
:影片格式為 (height, width)。
- device (
torch.device
, 可選) — 處理影片的裝置。如果未設定,則從輸入影片推斷裝置。 - patch_size (
int
, 可選, 預設為 14) — 視覺編碼器的空間補丁大小。 - temporal_patch_size (
int
, 可選, 預設為 2) — 視覺編碼器的時間補丁大小。 - merge_size (
int
, 可選, 預設為 2) — 視覺編碼器到 LLM 編碼器的合併大小。
構建一個快速 GLM-4V 影像處理器,它根據原始影片動態調整影片大小。
預處理
< 源 >( videos: typing.Union[list['PIL.Image.Image'], ForwardRef('np.ndarray'), ForwardRef('torch.Tensor'), list['np.ndarray'], list['torch.Tensor'], list[list['PIL.Image.Image']], list[list['np.ndarrray']], list[list['torch.Tensor']]] **kwargs: typing_extensions.Unpack[transformers.processing_utils.VideosKwargs] )
引數
- do_resize (
bool
, 可選, 預設為self.do_resize
) — 是否將影片的 (height, width) 維度調整到指定的size
。可在preprocess
方法中的do_resize
引數覆蓋。 - size (
dict
, 可選, 預設為self.size
) — 調整大小後的輸出影片的大小。可在preprocess
方法中的size
引數覆蓋。 - size_divisor (
int
, 可選, 預設為self.size_divisor
) — 確保高度和寬度都可以被其整除的大小。 - default_to_square (
bool
, 可選, 預設為self.default_to_square
) — 如果大小為整數,是否在調整影片大小時預設為方形影片。 - resample (
PILImageResampling
, 可選, 預設為self.resample
) — 如果調整影片大小,要使用的重取樣濾鏡。僅當do_resize
設定為True
時有效。可在preprocess
方法中的resample
引數覆蓋。 - do_center_crop (
bool
, 可選, 預設為self.do_center_crop
) — 是否將影片中心裁剪到指定的crop_size
。可在preprocess
方法中的do_center_crop
覆蓋。 - do_pad (
bool
, 可選) — 是否將影片填充到批處理中影片的(max_height, max_width)
。 - crop_size (
dict[str, int]
可選, 預設為self.crop_size
) — 應用center_crop
後的輸出影片大小。可在preprocess
方法中的crop_size
覆蓋。 - do_rescale (
bool
, 可選, 預設為self.do_rescale
) — 是否按指定的比例rescale_factor
重新縮放影片。可在preprocess
方法中的do_rescale
引數覆蓋。 - rescale_factor (
int
或float
, 可選, 預設為self.rescale_factor
) — 如果對影片進行重新縮放,則使用的縮放因子。僅當do_rescale
設定為True
時才有效。可以透過preprocess
方法中的rescale_factor
引數覆蓋。 - do_normalize (
bool
, 可選, 預設為self.do_normalize
) — 是否對影片進行歸一化。可以透過preprocess
方法中的do_normalize
引數覆蓋。可以透過preprocess
方法中的do_normalize
引數覆蓋。 - image_mean (
float
或list[float]
, 可選, 預設為self.image_mean
) — 如果對影片進行歸一化,則使用的均值。這是一個浮點數或浮點數列表,其長度與影片中的通道數相同。可以透過preprocess
方法中的image_mean
引數覆蓋。可以透過preprocess
方法中的image_mean
引數覆蓋。 - image_std (
float
或list[float]
, 可選, 預設為self.image_std
) — 如果對影片進行歸一化,則使用的標準差。這是一個浮點數或浮點數列表,其長度與影片中的通道數相同。可以透過preprocess
方法中的image_std
引數覆蓋。可以透過preprocess
方法中的image_std
引數覆蓋。 - do_convert_rgb (
bool
, 可選, 預設為self.image_std
) — 是否將影片轉換為 RGB。 - video_metadata (
VideoMetadata
, 可選) — 影片的元資料,包含總時長、每秒幀數和總幀數資訊。 - do_sample_frames (
int
, 可選, 預設為self.do_sample_frames
) — 是在處理前從影片中取樣幀,還是處理整個影片。 - num_frames (
int
, 可選, 預設為self.num_frames
) — 當do_sample_frames=True
時,要取樣的最大幀數。 - fps (
int
, 可選, 預設為self.fps
) — 當do_sample_frames=True
時,每秒取樣的目標幀數。 - return_tensors (
str
或TensorType
, 可選) — 如果設定為 `pt`,則返回堆疊的張量,否則返回張量列表。 - data_format (
ChannelDimension
或str
, 可選, 預設為ChannelDimension.FIRST
) — 輸出影片的通道維度格式。可以是以下之一:"channels_first"
或ChannelDimension.FIRST
: 影片格式為 (通道數, 高度, 寬度)。"channels_last"
或ChannelDimension.LAST
: 影片格式為 (高度, 寬度, 通道數)。- 未設定: 使用輸入影片的通道維度格式。
- input_data_format (
ChannelDimension
或str
, 可選) — 輸入影片的通道維度格式。如果未設定,則從輸入影片推斷通道維度格式。可以是以下之一:"channels_first"
或ChannelDimension.FIRST
: 影片格式為 (通道數, 高度, 寬度)。"channels_last"
或ChannelDimension.LAST
: 影片格式為 (高度, 寬度, 通道數)。"none"
或ChannelDimension.NONE
: 影片格式為 (高度, 寬度)。
- device (
torch.device
, 可選) — 處理影片的裝置。如果未設定,則從輸入影片推斷裝置。
Glm4vImageProcessorFast
class transformers.Glm4vImageProcessorFast
< 來源 >( **kwargs: typing_extensions.Unpack[transformers.models.glm4v.image_processing_glm4v_fast.Glm4vFastImageProcessorKwargs] )
構造一個快速 Glm4V 影像處理器。
預處理
< 來源 >( images: typing.Union[ForwardRef('PIL.Image.Image'), numpy.ndarray, ForwardRef('torch.Tensor'), list['PIL.Image.Image'], list[numpy.ndarray], list['torch.Tensor']] videos: typing.Union[list['PIL.Image.Image'], ForwardRef('np.ndarray'), ForwardRef('torch.Tensor'), list['np.ndarray'], list['torch.Tensor'], list[list['PIL.Image.Image']], list[list['np.ndarrray']], list[list['torch.Tensor']]] = None do_resize: typing.Optional[bool] = None size: typing.Optional[dict[str, int]] = None resample: typing.Union[ForwardRef('PILImageResampling'), ForwardRef('F.InterpolationMode'), NoneType] = None do_rescale: typing.Optional[bool] = None rescale_factor: typing.Optional[float] = None do_normalize: typing.Optional[bool] = None image_mean: typing.Union[float, list[float], NoneType] = None image_std: typing.Union[float, list[float], NoneType] = None patch_size: typing.Optional[int] = None temporal_patch_size: typing.Optional[int] = None merge_size: typing.Optional[int] = None do_convert_rgb: typing.Optional[bool] = None return_tensors: typing.Union[str, transformers.utils.generic.TensorType, NoneType] = None data_format: typing.Optional[transformers.image_utils.ChannelDimension] = <ChannelDimension.FIRST: 'channels_first'> input_data_format: typing.Union[str, transformers.image_utils.ChannelDimension, NoneType] = None device: typing.Optional[ForwardRef('torch.device')] = None disable_grouping: typing.Optional[bool] = False **kwargs )
引數
- images (
Union[PIL.Image.Image, numpy.ndarray, torch.Tensor, list['PIL.Image.Image'], list[numpy.ndarray], list['torch.Tensor']]
) — 要預處理的影像。期望單個或批次影像,畫素值範圍為 0 到 255。如果傳入的影像畫素值在 0 到 1 之間,請將do_rescale=False
。 - videos (
Union[list['PIL.Image.Image'], np.ndarray, torch.Tensor, list['np.ndarray'], list['torch.Tensor'], list[list['PIL.Image.Image']], list[list['np.ndarrray']], list[list['torch.Tensor']]]
) — 要預處理的影片。期望單個或批次影片,畫素值範圍為 0 到 255。如果傳入的影片畫素值在 0 到 1 之間,請將do_rescale=False
。 - do_resize (
bool
, 可選) — 是否調整影像大小。 - size (
dict[str, int]
, 可選) — 描述模型最大輸入尺寸。 - resample (
Union[PILImageResampling, F.InterpolationMode, NoneType]
) — 如果調整影像大小,則使用的重取樣濾波器。這可以是列舉PILImageResampling
之一。僅當do_resize
設定為True
時才有效。 - do_rescale (
bool
, 可選) — 是否重新縮放影像。 - rescale_factor (
float
, 可選) — 如果do_rescale
設定為True
,則按此縮放因子對影像進行重新縮放。 - do_normalize (
bool
, 可選) — 是否對影像進行歸一化。 - image_mean (
Union[float, list[float], NoneType]
) — 用於歸一化的影像均值。僅當do_normalize
設定為True
時才有效。 - image_std (
Union[float, list[float], NoneType]
) — 用於歸一化的影像標準差。僅當do_normalize
設定為True
時才有效。 - patch_size (
int
, 可選, 預設為 14) — 視覺編碼器的空間補丁大小。 - temporal_patch_size (
int
, 可選, 預設為 2) — 視覺編碼器的時間補丁大小。 - merge_size (
int
, 可選, 預設為 2) — 視覺編碼器到 LLM 編碼器的合併大小。 - do_convert_rgb (
bool
, 可選) — 是否將影像轉換為 RGB。 - return_tensors (
Union[str, ~utils.generic.TensorType, NoneType]
) — 如果設定為 `pt`,則返回堆疊的張量,否則返回張量列表。 - data_format (
~image_utils.ChannelDimension
, 可選, 預設為ChannelDimension.FIRST
) — 僅支援ChannelDimension.FIRST
。為相容慢速處理器而新增。 - input_data_format (
Union[str, ~image_utils.ChannelDimension, NoneType]
) — 輸入影像的通道維度格式。如果未設定,則從輸入影像推斷通道維度格式。可以是以下之一:"channels_first"
或ChannelDimension.FIRST
: 影像格式為 (通道數, 高度, 寬度)。"channels_last"
或ChannelDimension.LAST
: 影像格式為 (高度, 寬度, 通道數)。"none"
或ChannelDimension.NONE
: 影像格式為 (高度, 寬度)。
- device (
torch.device
, 可選) — 處理影像的裝置。如果未設定,則從輸入影像推斷裝置。 - disable_grouping (
bool
, 可選, 預設為False
) — 是否停用按大小對影像進行分組,以單獨處理而非批次處理。如果為 None,則如果影像在 CPU 上,則設定為 True,否則設定為 False。此選擇基於經驗觀察,詳情請參閱:https://github.com/huggingface/transformers/pull/38157
Glm4vProcessor
class transformers.Glm4vProcessor
< 來源 >( image_processor = None tokenizer = None video_processor = None chat_template = None **kwargs )
引數
- image_processor (Glm4vProcessor, 可選) — 影像處理器是必需輸入。
- tokenizer (PreTrainedTokenizerFast, 可選) — 分詞器是必需輸入。
- video_processor (Glm4vVideoProcessor, 可選) — 影片處理器是必需輸入。
- chat_template (
str
, 可選) — 一個 Jinja 模板,用於將聊天中的訊息列表轉換為可分詞字串。
構造一個 GLM-4V 處理器,它將 GLM-4V 影像處理器和 GLM-4 分詞器封裝到一個單獨的處理器中。有關更多資訊,請參閱 __call__()
和 decode()。
此方法將其所有引數轉發到 Qwen2TokenizerFast 的 batch_decode()。有關更多資訊,請參閱此方法的文件字串。
post_process_image_text_to_text
< 來源 >( generated_outputs skip_special_tokens = True clean_up_tokenization_spaces = False **kwargs ) → list[str]
引數
- generated_outputs (
torch.Tensor
或np.ndarray
) — 模型generate
函式的輸出。輸出應為形狀為(batch_size, sequence_length)
或(sequence_length,)
的張量。 - skip_special_tokens (
bool
, 可選, 預設為True
) — 是否在輸出中移除特殊 token。引數傳遞給分詞器的batch_decode
方法。 - clean_up_tokenization_spaces (
bool
, 可選, 預設為False
) — 是否清理分詞空間。引數傳遞給分詞器的batch_decode
方法。 - **kwargs — 要傳遞給分詞器
batch_decode
方法的其他引數。
返回
list[str]
解碼後的文字。
後處理模型輸出以解碼文字。
Glm4vTextModel
class transformers.Glm4vTextModel
< 來源 >( config: Glm4vTextConfig )
引數
- config (Glm4vTextConfig) — 模型配置類,包含模型的所有引數。使用配置檔案初始化不載入與模型關聯的權重,僅載入配置。請檢視 from_pretrained() 方法載入模型權重。
裸 Glm4V 文字模型,輸出原始隱藏狀態,不帶任何特定頭部。
此模型繼承自 PreTrainedModel。請檢視超類文件,瞭解庫為所有模型實現的通用方法(例如下載或儲存、調整輸入嵌入大小、修剪頭部等)。
此模型也是 PyTorch torch.nn.Module 子類。將其作為常規 PyTorch 模組使用,並參考 PyTorch 文件瞭解所有與一般使用和行為相關的事項。
forward
< 來源 >( input_ids: typing.Optional[torch.LongTensor] = None attention_mask: typing.Optional[torch.Tensor] = None position_ids: typing.Optional[torch.LongTensor] = None past_key_values: typing.Optional[list[torch.FloatTensor]] = None inputs_embeds: typing.Optional[torch.FloatTensor] = None use_cache: typing.Optional[bool] = None output_attentions: typing.Optional[bool] = None output_hidden_states: typing.Optional[bool] = None cache_position: typing.Optional[torch.LongTensor] = None **kwargs: typing_extensions.Unpack[transformers.modeling_flash_attention_utils.FlashAttentionKwargs] ) → transformers.modeling_outputs.BaseModelOutputWithPast 或 tuple(torch.FloatTensor)
引數
- input_ids (形狀為
(batch_size, sequence_length)
的torch.LongTensor
, 可選) — 詞彙表中輸入序列 token 的索引。填充預設將被忽略。索引可以使用 AutoTokenizer 獲取。有關詳細資訊,請參閱 PreTrainedTokenizer.encode() 和 PreTrainedTokenizer.call()。
- attention_mask (形狀為
(batch_size, sequence_length)
的torch.Tensor
, 可選) — 掩碼,用於避免在填充 token 索引上執行注意力。掩碼值選擇在[0, 1]
之間:- 1 表示**未被掩碼**的 token,
- 0 表示**被掩碼**的 token。
- position_ids (形狀為
(batch_size, sequence_length)
的torch.LongTensor
, 可選) — 位置嵌入中每個輸入序列 token 位置的索引。在[0, config.n_positions - 1]
範圍內選擇。 - past_key_values (
list[torch.FloatTensor]
, 可選) — 預計算的隱藏狀態(自注意力塊和交叉注意力塊中的鍵和值),可用於加速順序解碼。這通常包括模型在解碼前期返回的past_key_values
,當use_cache=True
或config.use_cache=True
時。允許兩種格式:
- 一個 Cache 例項,詳見我們的 kv cache 指南;
- 一個長度為
config.n_layers
的tuple(torch.FloatTensor)
元組,每個元組包含兩個形狀為(batch_size, num_heads, sequence_length, embed_size_per_head)
的張量)。這也稱為傳統快取格式。
模型將輸出與輸入相同的快取格式。如果未傳入
past_key_values
,則將返回傳統快取格式。如果使用
past_key_values
,使用者可以選擇只輸入形狀為(batch_size, 1)
的最後一個input_ids
(那些沒有將過去鍵值狀態提供給此模型的),而不是形狀為(batch_size, sequence_length)
的所有input_ids
。 - inputs_embeds (形狀為
(batch_size, sequence_length, hidden_size)
的torch.FloatTensor
,可選) — 可選地,您可以選擇直接傳遞嵌入表示,而不是傳遞input_ids
。如果您想對如何將input_ids
索引轉換為關聯向量進行比模型內部嵌入查詢矩陣更精細的控制,這會很有用。 - use_cache (
bool
, 可選) — 如果設定為True
,則返回past_key_values
鍵值狀態,可用於加速解碼(參見past_key_values
)。 - output_attentions (
bool
, 可選) — 是否返回所有注意力層的注意力張量。更多詳情請參閱返回張量中的attentions
。 - output_hidden_states (
bool
, 可選) — 是否返回所有層的隱藏狀態。更多詳情請參閱返回張量中的hidden_states
。 - cache_position (形狀為
(sequence_length)
的torch.LongTensor
,可選) — 描述輸入序列令牌在序列中位置的索引。與position_ids
不同,此張量不受填充影響。它用於在正確位置更新快取並推斷完整的序列長度。
返回
transformers.modeling_outputs.BaseModelOutputWithPast 或 tuple(torch.FloatTensor)
一個 transformers.modeling_outputs.BaseModelOutputWithPast 或一個 torch.FloatTensor
的元組(如果傳入 return_dict=False
或當 config.return_dict=False
時),包含根據配置(None
)和輸入的不同元素。
-
last_hidden_state (
torch.FloatTensor
, 形狀為(batch_size, sequence_length, hidden_size)
) — 模型最後一層輸出的隱藏狀態序列。如果使用了
past_key_values
,則只輸出形狀為(batch_size, 1, hidden_size)
的序列的最後一個隱藏狀態。 -
past_key_values (
Cache
, 可選, 當傳入use_cache=True
或當config.use_cache=True
時返回) — 這是一個 Cache 例項。更多詳情,請參閱我們的 kv cache 指南。包含預計算的隱藏狀態(自注意力塊中的鍵和值,如果
config.is_encoder_decoder=True
則可選地包含交叉注意力塊中的鍵和值),可用於(參見past_key_values
輸入)加速順序解碼。 -
hidden_states (
tuple(torch.FloatTensor)
, 可選, 當傳入output_hidden_states=True
或當config.output_hidden_states=True
時返回) —torch.FloatTensor
的元組(如果模型有嵌入層,則一個用於嵌入層的輸出,加上每個層的一個輸出),形狀為(batch_size, sequence_length, hidden_size)
。模型在每個層輸出的隱藏狀態以及可選的初始嵌入輸出。
-
attentions (
tuple(torch.FloatTensor)
, 可選, 當傳入output_attentions=True
或當config.output_attentions=True
時返回) —torch.FloatTensor
的元組(每個層一個),形狀為(batch_size, num_heads, sequence_length, sequence_length)
。注意力 softmax 後的注意力權重,用於計算自注意力頭中的加權平均值。
Glm4vTextModel 的前向方法,覆蓋了 __call__
特殊方法。
儘管前向傳播的配方需要在該函式中定義,但之後應該呼叫 Module
例項而不是此函式,因為前者負責執行預處理和後處理步驟,而後者則默默地忽略它們。
Glm4vModel
class transformers.Glm4vModel
< source >( config )
引數
- config (Glm4vModel) — 包含模型所有引數的模型配置類。使用配置檔案初始化不載入與模型關聯的權重,只加載配置。請查閱 from_pretrained() 方法以載入模型權重。
裸 Glm4V 模型,輸出原始隱藏狀態,頂部沒有任何特定頭部。
此模型繼承自 PreTrainedModel。請檢視超類文件,瞭解庫為所有模型實現的通用方法(例如下載或儲存、調整輸入嵌入大小、修剪頭部等)。
此模型也是 PyTorch torch.nn.Module 子類。將其作為常規 PyTorch 模組使用,並參考 PyTorch 文件瞭解所有與一般使用和行為相關的事項。
forward
< source >( input_ids: LongTensor = None attention_mask: typing.Optional[torch.Tensor] = None position_ids: typing.Optional[torch.LongTensor] = None past_key_values: typing.Optional[list[torch.FloatTensor]] = None inputs_embeds: typing.Optional[torch.FloatTensor] = None use_cache: typing.Optional[bool] = None output_attentions: typing.Optional[bool] = None output_hidden_states: typing.Optional[bool] = None pixel_values: typing.Optional[torch.Tensor] = None pixel_values_videos: typing.Optional[torch.FloatTensor] = None image_grid_thw: typing.Optional[torch.LongTensor] = None video_grid_thw: typing.Optional[torch.LongTensor] = None rope_deltas: typing.Optional[torch.LongTensor] = None cache_position: typing.Optional[torch.LongTensor] = None **kwargs: typing_extensions.Unpack[transformers.models.glm4v.modeling_glm4v.KwargsForCausalLM] ) → transformers.models.glm4v.modeling_glm4v.Glm4vModelOutputWithPast
或 tuple(torch.FloatTensor)
引數
- input_ids (形狀為
(batch_size, sequence_length)
的torch.LongTensor
) — 詞彙表中輸入序列令牌的索引。預設情況下將忽略填充。索引可以使用 AutoTokenizer 獲取。有關詳情,請參閱 PreTrainedTokenizer.encode() 和 PreTrainedTokenizer.call()。
- attention_mask (形狀為
(batch_size, sequence_length)
的torch.Tensor
,可選) — 避免對填充令牌索引執行注意力的掩碼。掩碼值選擇在[0, 1]
之間:- 1 表示未被掩蓋的令牌,
- 0 表示被掩蓋的令牌。
- position_ids (形狀為
(batch_size, sequence_length)
的torch.LongTensor
,可選) — 每個輸入序列令牌在位置嵌入中的位置索引。選擇範圍為[0, config.n_positions - 1]
。 - past_key_values (
list[torch.FloatTensor]
, 可選) — 預計算的隱藏狀態(自注意力塊和交叉注意力塊中的鍵和值),可用於加速順序解碼。這通常包括模型在解碼前期返回的past_key_values
,當use_cache=True
或config.use_cache=True
時。允許兩種格式:
- 一個 Cache 例項,詳見我們的 kv cache 指南;
- 一個長度為
config.n_layers
的tuple(torch.FloatTensor)
元組,每個元組包含兩個形狀為(batch_size, num_heads, sequence_length, embed_size_per_head)
的張量)。這也稱為傳統快取格式。
模型將輸出與輸入相同的快取格式。如果未傳入
past_key_values
,則將返回傳統快取格式。如果使用
past_key_values
,使用者可以選擇只輸入形狀為(batch_size, 1)
的最後一個input_ids
(那些沒有將過去鍵值狀態提供給此模型的),而不是形狀為(batch_size, sequence_length)
的所有input_ids
。 - inputs_embeds (形狀為
(batch_size, sequence_length, hidden_size)
的torch.FloatTensor
,可選) — 可選地,您可以選擇直接傳遞嵌入表示,而不是傳遞input_ids
。如果您想對如何將input_ids
索引轉換為關聯向量進行比模型內部嵌入查詢矩陣更精細的控制,這會很有用。 - use_cache (
bool
, 可選) — 如果設定為True
,則返回past_key_values
鍵值狀態,可用於加速解碼(參見past_key_values
)。 - output_attentions (
bool
, 可選) — 是否返回所有注意力層的注意力張量。更多詳情請參閱返回張量中的attentions
。 - output_hidden_states (
bool
, 可選) — 是否返回所有層的隱藏狀態。更多詳情請參閱返回張量中的hidden_states
。 - pixel_values (形狀為
(batch_size, num_channels, image_size, image_size)
的torch.Tensor
,可選) — 對應輸入影像的張量。畫素值可以使用{image_processor_class}
獲取。有關詳情,請參閱{image_processor_class}.__call__
({processor_class}
使用{image_processor_class}
處理影像)。 - pixel_values_videos (形狀為 `(seq_length, num_channels * temporal_size * image_size * image_size)` 的
torch.FloatTensor
,可選) — 對應輸入影片的張量。畫素值可以使用 AutoImageProcessor 獲取。有關詳情,請參閱 Glm4vImageProcessor.call()。Glm4vProcessor 使用 Glm4vImageProcessor 處理影片。 - image_grid_thw (形狀為
(num_images, 3)
的torch.LongTensor
,可選) — LLM 中每張影像的特徵形狀的時間、高度和寬度。 - video_grid_thw (形狀為
(num_videos, 3)
的torch.LongTensor
,可選) — LLM 中每個影片的特徵形狀的時間、高度和寬度。 - rope_deltas (形狀為
(batch_size, )
的torch.LongTensor
,可選) — 序列長度與多模態旋轉位置編碼之間的旋轉位置編碼索引差。 - cache_position (形狀為
(sequence_length)
的torch.LongTensor
,可選) — 描述輸入序列令牌在序列中位置的索引。與position_ids
不同,此張量不受填充影響。它用於在正確位置更新快取並推斷完整的序列長度。
返回
transformers.models.glm4v.modeling_glm4v.Glm4vModelOutputWithPast
或 tuple(torch.FloatTensor)
一個 transformers.models.glm4v.modeling_glm4v.Glm4vModelOutputWithPast
或一個 torch.FloatTensor
的元組(如果傳入 return_dict=False
或當 config.return_dict=False
時),包含根據配置(None
)和輸入的不同元素。
-
last_hidden_state (形狀為
(batch_size, sequence_length, hidden_size)
的<class 'torch.FloatTensor'>.last_hidden_state
,預設為None
) — 模型最後一層的隱藏狀態序列。 -
past_key_values (
tuple(tuple(torch.FloatTensor))
, 可選, 當傳入use_cache=True
或當config.use_cache=True
時返回) — 長度為config.n_layers
的tuple(torch.FloatTensor)
元組,每個元組包含 2 個形狀為(batch_size, num_heads, sequence_length, embed_size_per_head)
的張量。包含預計算的隱藏狀態(自注意力塊中的鍵和值),可用於(參見
past_key_values
輸入)加速順序解碼。 -
hidden_states (
tuple[torch.FloatTensor]
, 可選, 當傳入output_hidden_states=True
或當config.output_hidden_states=True
時返回) —torch.FloatTensor
的元組(如果模型有嵌入層,則一個用於嵌入層的輸出,加上每個層的一個輸出),形狀為(batch_size, sequence_length, hidden_size)
。模型在每個層輸出的隱藏狀態以及可選的初始嵌入輸出。
-
attentions (
tuple[torch.FloatTensor]
, 可選, 當傳入output_attentions=True
或當config.output_attentions=True
時返回) —torch.FloatTensor
的元組(每個層一個),形狀為(batch_size, num_heads, sequence_length, sequence_length)
。注意力 softmax 後的注意力權重,用於計算自注意力頭中的加權平均值。
-
rope_deltas (形狀為
(batch_size, )
的torch.LongTensor
,可選) — 序列長度與多模態旋轉位置編碼之間的旋轉位置編碼索引差。
Glm4vModel 的前向方法,覆蓋了 __call__
特殊方法。
儘管前向傳播的配方需要在該函式中定義,但之後應該呼叫 Module
例項而不是此函式,因為前者負責執行預處理和後處理步驟,而後者則默默地忽略它們。
Glm4vForConditionalGeneration
forward
< source >( input_ids: LongTensor = None attention_mask: typing.Optional[torch.Tensor] = None position_ids: typing.Optional[torch.LongTensor] = None past_key_values: typing.Optional[list[torch.FloatTensor]] = None inputs_embeds: typing.Optional[torch.FloatTensor] = None labels: typing.Optional[torch.LongTensor] = None use_cache: typing.Optional[bool] = None output_attentions: typing.Optional[bool] = None output_hidden_states: typing.Optional[bool] = None return_dict: typing.Optional[bool] = None pixel_values: typing.Optional[torch.Tensor] = None pixel_values_videos: typing.Optional[torch.FloatTensor] = None image_grid_thw: typing.Optional[torch.LongTensor] = None video_grid_thw: typing.Optional[torch.LongTensor] = None rope_deltas: typing.Optional[torch.LongTensor] = None cache_position: typing.Optional[torch.LongTensor] = None **kwargs: typing_extensions.Unpack[transformers.models.glm4v.modeling_glm4v.KwargsForCausalLM] ) → transformers.models.glm4v.modeling_glm4v.Glm4vCausalLMOutputWithPast
或 tuple(torch.FloatTensor)
引數
- input_ids (形狀為
(batch_size, sequence_length)
的torch.LongTensor
) — 詞彙表中輸入序列令牌的索引。預設情況下將忽略填充。索引可以使用 AutoTokenizer 獲取。有關詳情,請參閱 PreTrainedTokenizer.encode() 和 PreTrainedTokenizer.call()。
- attention_mask (形狀為
(batch_size, sequence_length)
的torch.Tensor
,可選) — 避免對填充令牌索引執行注意力的掩碼。掩碼值選擇在[0, 1]
之間:- 1 表示未被掩蓋的令牌,
- 0 表示被掩蓋的令牌。
- position_ids (形狀為
(batch_size, sequence_length)
的torch.LongTensor
,可選) — 每個輸入序列令牌在位置嵌入中的位置索引。選擇範圍為[0, config.n_positions - 1]
。 - past_key_values (
list[torch.FloatTensor]
, 可選) — 預計算的隱藏狀態(自注意力塊和交叉注意力塊中的鍵和值),可用於加速順序解碼。這通常包括模型在解碼前期返回的past_key_values
,當use_cache=True
或config.use_cache=True
時。允許兩種格式:
- 一個 Cache 例項,詳見我們的 kv cache 指南;
- 一個長度為
config.n_layers
的tuple(torch.FloatTensor)
元組,每個元組包含兩個形狀為(batch_size, num_heads, sequence_length, embed_size_per_head)
的張量)。這也稱為傳統快取格式。
模型將輸出與輸入相同的快取格式。如果未傳入
past_key_values
,則將返回傳統快取格式。如果使用
past_key_values
,使用者可以選擇只輸入形狀為(batch_size, 1)
的最後一個input_ids
(那些沒有將過去鍵值狀態提供給此模型的),而不是形狀為(batch_size, sequence_length)
的所有input_ids
。 - inputs_embeds (形狀為
(batch_size, sequence_length, hidden_size)
的torch.FloatTensor
,可選) — 可選地,您可以選擇直接傳遞嵌入表示,而不是傳遞input_ids
。如果您想對如何將input_ids
索引轉換為關聯向量進行比模型內部嵌入查詢矩陣更精細的控制,這會很有用。 - labels (形狀為
(batch_size, sequence_length)
的torch.LongTensor
,可選) — 用於計算掩碼語言模型損失的標籤。索引應在[0, ..., config.vocab_size]
或 -100 之間(參見input_ids
文件字串)。索引設定為-100
的令牌將被忽略(掩碼),損失僅針對標籤在[0, ..., config.vocab_size]
中的令牌計算。 - use_cache (
bool
, 可選) — 如果設定為True
,則返回past_key_values
鍵值狀態,可用於加速解碼(參見past_key_values
)。 - output_attentions (
bool
, 可選) — 是否返回所有注意力層的注意力張量。更多詳情請參閱返回張量中的attentions
。 - output_hidden_states (
bool
, 可選) — 是否返回所有層的隱藏狀態。更多詳情請參閱返回張量中的hidden_states
。 - return_dict (
bool
, 可選) — 是否返回 ModelOutput 而不是普通的元組。 - pixel_values (形狀為
(batch_size, num_channels, image_size, image_size)
的torch.Tensor
,可選) — 對應輸入影像的張量。畫素值可以使用{image_processor_class}
獲取。有關詳情,請參閱{image_processor_class}.__call__
({processor_class}
使用{image_processor_class}
處理影像)。 - pixel_values_videos (形狀為 `(seq_length, num_channels * temporal_size * image_size * image_size)` 的
torch.FloatTensor
,可選) — 對應輸入影片的張量。畫素值可以使用 AutoImageProcessor 獲取。有關詳情,請參閱 Glm4vImageProcessor.call()。Glm4vProcessor 使用 Glm4vImageProcessor 處理影片。 - image_grid_thw (形狀為
(num_images, 3)
的torch.LongTensor
,可選) — LLM 中每張影像的特徵形狀的時間、高度和寬度。 - video_grid_thw (形狀為
(num_videos, 3)
的torch.LongTensor
,可選) — LLM 中每個影片的特徵形狀的時間、高度和寬度。 - rope_deltas (形狀為
(batch_size, )
的torch.LongTensor
,可選) — 序列長度與多模態旋轉位置編碼之間的旋轉位置編碼索引差。 - cache_position (形狀為
(sequence_length)
的torch.LongTensor
,可選) — 描述輸入序列令牌在序列中位置的索引。與position_ids
不同,此張量不受填充影響。它用於在正確位置更新快取並推斷完整的序列長度。
返回
transformers.models.glm4v.modeling_glm4v.Glm4vCausalLMOutputWithPast
或 tuple(torch.FloatTensor)
一個 transformers.models.glm4v.modeling_glm4v.Glm4vCausalLMOutputWithPast
或一個 torch.FloatTensor
的元組(如果傳入 return_dict=False
或當 config.return_dict=False
時),包含根據配置(Glm4vConfig)和輸入的不同元素。
-
loss (
torch.FloatTensor
形狀為(1,)
,可選,當提供labels
時返回) — 語言建模損失(用於下一個 token 預測)。 -
logits (形狀為
(batch_size, sequence_length, config.vocab_size)
的torch.FloatTensor
) — 語言建模頭部的預測分數(SoftMax 之前的每個詞彙標記的分數)。 -
past_key_values (
tuple(tuple(torch.FloatTensor))
, 可選, 當傳入use_cache=True
或當config.use_cache=True
時返回) — 長度為config.n_layers
的tuple(torch.FloatTensor)
元組,每個元組包含 2 個形狀為(batch_size, num_heads, sequence_length, embed_size_per_head)
的張量。包含預計算的隱藏狀態(自注意力塊中的鍵和值),可用於(參見
past_key_values
輸入)加速順序解碼。 -
hidden_states (
tuple[torch.FloatTensor]
, 可選, 當傳入output_hidden_states=True
或當config.output_hidden_states=True
時返回) —torch.FloatTensor
的元組(如果模型有嵌入層,則一個用於嵌入層的輸出,加上每個層的一個輸出),形狀為(batch_size, sequence_length, hidden_size)
。模型在每個層輸出的隱藏狀態以及可選的初始嵌入輸出。
-
attentions (
tuple[torch.FloatTensor]
, 可選, 當傳入output_attentions=True
或當config.output_attentions=True
時返回) —torch.FloatTensor
的元組(每個層一個),形狀為(batch_size, num_heads, sequence_length, sequence_length)
。注意力 softmax 後的注意力權重,用於計算自注意力頭中的加權平均值。
-
rope_deltas (形狀為
(batch_size, )
的torch.LongTensor
,可選) — 序列長度與多模態旋轉位置編碼之間的旋轉位置編碼索引差。
Glm4vForConditionalGeneration 的前向方法,覆蓋了 __call__
特殊方法。
儘管前向傳播的配方需要在該函式中定義,但之後應該呼叫 Module
例項而不是此函式,因為前者負責執行預處理和後處理步驟,而後者則默默地忽略它們。
示例
>>> from PIL import Image
>>> import requests
>>> from transformers import AutoProcessor, Glm4vForConditionalGeneration
>>> model = Glm4vForConditionalGeneration.from_pretrained("THUDM/GLM-4.1V-9B-Thinking")
>>> processor = AutoProcessor.from_pretrained("THUDM/GLM-4.1V-9B-Thinking")
>>> messages = [
{
"role": "user",
"content": [
{"type": "image"},
{"type": "text", "text": "What is shown in this image?"},
],
},
]
>>> url = "https://www.ilankelman.org/stopsigns/australia.jpg"
>>> image = Image.open(requests.get(url, stream=True).raw)
>>> text = processor.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
>>> inputs = processor(text=[text], images=[image], vision_infos=[vision_infos])
>>> # Generate
>>> generate_ids = model.generate(inputs.input_ids, max_length=30)
>>> tokenizer.batch_decode(generate_ids, skip_special_tokens=True, clean_up_tokenization_spaces=False)[0]
"The image shows a street scene with a red stop sign in the foreground. In the background, there is a large red gate with Chinese characters ..."