Chat.set_photo()

async Chat.set_photo()[source]

Bound method set_photo of Chat.

Use as a shortcut for:

await client.set_chat_photo(chat_id=chat_id, photo=photo)

Example

# Set chat photo using a local file
await chat.set_photo(photo="photo.jpg")

# Set chat photo using an existing Photo file_id
await chat.set_photo(photo=photo.file_id)


# Set chat video using a local file
await chat.set_photo(video="video.mp4")

# Set chat photo using an existing Video file_id
await chat.set_photo(video=video.file_id)
Parameters:
  • photo (str | BinaryIO, optional) – New chat photo. You can pass a Photo file_id, a file path to upload a new photo from your local machine or a binary file-like object with its attribute “.name” set for in-memory uploads.

  • video (str | BinaryIO, optional) – New chat video. You can pass a Video file_id, a file path to upload a new video from your local machine or a binary file-like object with its attribute “.name” set for in-memory uploads.

  • video_start_ts (float, optional) – The timestamp in seconds of the video frame to use as photo profile preview.

Returns:

bool – True on success.

Raises:
  • RPCError – In case of a Telegram RPC error.

  • ValueError – if a chat_id belongs to user.