InputMediaPhoto#

class pyrogram.types.InputMediaPhoto[source]#

A photo to be sent.

Parameters:

  • media (str | io.BytesIO) – Photo to send. Pass a file_id as string to send a photo that exists on the Telegram servers or pass a file path as string to upload a new photo that exists on your local machine or pass a binary file-like object with its attribute “.name” set for in-memory uploads or pass an HTTP URL as a string for Telegram to get a photo from the Internet.

    Note

    The photo must be at most 10 MB in size. The photo’s width and height must not exceed 10000 in total. The photo’s width and height ratio must be at most 20.

  • caption (str, optional) – Caption of the photo to be sent, 0-1024 characters. If not specified, the original caption is kept. Pass “” (empty string) to remove the caption.

  • parse_mode (ParseMode, optional) – By default, texts are parsed using both Markdown and HTML styles. You can combine both syntaxes together.

  • caption_entities (List of MessageEntity) – List of special entities that appear in the caption, which can be specified instead of parse_mode.

  • show_caption_above_media (bool, optional) – Pass True, if the caption must be shown above the message media.

  • has_spoiler (bool, optional) – Pass True if the photo needs to be covered with a spoiler animation.

  • is_high_quality (bool, optional) – Pass True to locally compress the photo to High Definition quality (up to 2560x2560 resolution). Pass False to locally compress the photo to Standard Definition quality (up to 1280x1280 resolution). Pass None to bypass local compression entirely and upload the original file unaltered.

    Note

    This local compression feature requires the Pillow library to be installed and only applies when uploading local file paths or in-memory objects.