如何使用Telethon从Telegram消息中删除图片-Python教程-PHP中文网

如何使用telethon从telegram消息中删除图片

本文详细介绍了在Python中使用Telethon库从Telegram消息中删除图片的方法。针对用户尝试使用`event.edit(file=None)`无效的问题，我们明确指出，直接移除消息中图片而保留文本的功能并非通过`event.edit`实现。核心解决方案是利用`client.delete_messages`方法来删除包含图片的原消息，并通过示例代码演示了如何初始化客户端、获取消息、判断媒体类型并执行删除操作，确保用户能有效管理消息中的媒体内容。

Telethon消息中图片删除的专业指南

在使用Telethon库处理Telegram消息时，开发者经常会遇到需要从已发送消息中移除图片的需求。常见的误解是尝试通过event.edit(file=None)来达到这一目的。然而，event.edit方法主要用于修改消息的文本内容或替换媒体文件，而非直接“删除”媒体而保留文本。当消息中包含图片时，若要彻底移除该图片，最直接且有效的方法是删除整条消息。

理解消息编辑与删除的差异

Telethon的event.edit方法允许您修改消息的某些属性，例如文本内容或替换其附加的媒体文件。当您尝试将file参数设置为None时，系统并不会理解为“移除现有文件”，而是可能忽略该参数或导致其他非预期行为。对于包含媒体（如图片）的消息，如果目标是使图片消失，同时不关心消息文本是否也一并删除，那么使用删除消息的API是更为直接和推荐的做法。

核心解决方案：删除包含图片的消息

Telethon库提供了client.delete_messages方法，允许您根据聊天ID和消息ID删除一条或多条消息。这是移除消息中图片的有效手段，因为它会彻底移除包含图片的原消息。

以下是实现此功能的详细步骤和示例代码：

Python Hardener

通过完整的安全审查、代码整洁重构、健壮的错误处理、正确的日志记录以及完整的文档字符串覆盖，强化 Python 脚本。

下载

1. 初始化Telethon客户端

首先，您需要使用您的API凭据初始化Telethon客户端。确保您已经从Telegram获取了api_id和api_hash。

from telethon.sync import TelegramClient
from telethon.tl.types import Message

# 替换为您的API凭据和手机号码
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER' # 首次运行时用于登录

client = TelegramClient('session_name', api_id, api_hash)

2. 定义删除图片消息的函数

创建一个异步函数，该函数接收聊天ID和消息ID作为参数。在该函数内部，我们将执行以下操作：

通过client.get_messages获取指定的消息对象。
检查消息是否包含媒体（即图片或视频）。
如果包含媒体，则使用client.delete_messages删除该消息。

async def remove_image_from_message(chat_id: int | str, message_id: int):
    """
    从指定聊天中删除包含图片的消息。

    Args:
        chat_id: 聊天ID（可以是整数或用户名字符串）。
        message_id: 要删除的消息的ID。
    """
    try:
        # 获取指定的消息
        message: Message = await client.get_messages(chat_id, ids=message_id)

        if message and message.media:
            # 如果消息存在且包含媒体（图片、视频等），则删除该消息
            await client.delete_messages(chat_id, message_id)
            print(f"消息 (ID: {message_id}) 中的图片已成功移除（消息已删除）。")
        elif message and not message.media:
            print(f"指定消息 (ID: {message_id}) 不包含图片或任何媒体。")
        else:
            print(f"未找到指定消息 (ID: {message_id})。")
    except Exception as e:
        print(f"删除图片消息时发生错误: {e}")

3. 运行主程序

在main函数中启动客户端，调用remove_image_from_message函数，然后断开客户端连接。

async def main():
    await client.start(phone_number)

    # 替换为实际的聊天ID和消息ID
    # chat_id 可以是整数（如群组ID）或字符串（如用户名 '@username'）
    target_chat_id = 'YOUR_CHAT_ID' 
    target_message_id = 123  # 替换为包含图片的消息ID

    await remove_image_from_message(target_chat_id, target_message_id)

    await client.disconnect()

if __name__ == '__main__':
    # 运行主异步函数
    client.loop.run_until_complete(main())

完整示例代码

from telethon.sync import TelegramClient
from telethon.tl.types import Message

# --- 配置信息 ---
# 替换为您的API凭据，可在 my.telegram.org 获取
api_id = 'YOUR_API_ID' 
api_hash = 'YOUR_API_HASH'
# 您的手机号码，首次运行时用于登录
phone_number = 'YOUR_PHONE_NUMBER' 

# 替换为实际的聊天ID和消息ID
# chat_id 可以是整数（如群组ID）或字符串（如用户名 '@username'）
TARGET_CHAT_ID = 'YOUR_CHAT_ID' 
TARGET_MESSAGE_ID = 123  # 替换为包含图片的消息ID

# 初始化Telethon客户端
# 'session_name' 是会话文件的名称，用于保存登录状态
client = TelegramClient('session_name', api_id, api_hash)

async def remove_image_from_message(chat_id: int | str, message_id: int):
    """
    从指定聊天中删除包含图片的消息。
    如果消息存在且包含媒体，则删除该消息。

    Args:
        chat_id: 聊天ID（可以是整数或用户名字符串）。
        message_id: 要删除的消息的ID。
    """
    try:
        # 获取指定的消息
        # client.get_messages 返回一个消息列表，即使只请求一个ID
        messages = await client.get_messages(chat_id, ids=message_id)
        message: Message = messages[0] if messages else None

        if message:
            if message.media:
                # 如果消息存在且包含媒体（图片、视频等），则删除该消息
                await client.delete_messages(chat_id, message_id)
                print(f"消息 (ID: {message_id}) 中的图片已成功移除（消息已删除）。")
            else:
                print(f"指定消息 (ID: {message_id}) 不包含图片或任何媒体。")
        else:
            print(f"未找到指定消息 (ID: {message_id})。")
    except Exception as e:
        print(f"删除图片消息时发生错误: {e}")

async def main():
    """
    主函数，用于启动客户端并执行删除操作。
    """
    print("正在启动Telethon客户端...")
    await client.start(phone_number)
    print("客户端已启动。")

    await remove_image_from_message(TARGET_CHAT_ID, TARGET_MESSAGE_ID)

    print("正在断开客户端连接...")
    await client.disconnect()
    print("客户端已断开。")

if __name__ == '__main__':
    client.loop.run_until_complete(main())

注意事项

API凭据和权限： 确保您的api_id和api_hash是正确的，并且您的Telegram账户拥有删除消息的权限（例如，在群组中您必须是管理员）。
聊天ID和消息ID： 务必替换示例中的YOUR_CHAT_ID和YOUR_MESSAGE_ID为实际的数值。聊天ID可以是整数（对于私人聊天、群组或频道）或字符串（对于用户名，如@username）。消息ID可以通过检查消息的URL或使用Telethon的调试工具获取。
彻底删除： client.delete_messages操作是不可逆的，它会彻底从聊天中移除消息及其所有内容（包括文本和媒体）。
仅移除图片，保留文本： 如果您的需求是“仅移除图片但保留消息文本”，那么直接删除消息的方案可能不适用。在这种情况下，您需要执行一个更复杂的操作：
1. 获取原始消息的文本内容。
2. 删除原始消息。
3. 重新发送一条只包含文本的新消息。这种方法虽然可行，但会改变消息ID和时间戳。

总结

通过本教程，您应该已经掌握了使用Telethon从Telegram消息中删除图片的核心方法。关键在于理解event.edit与client.delete_messages之间的功能差异，并选择后者来达到彻底移除包含图片消息的目的。在实际应用中，请务必谨慎操作删除功能，并确保您的API凭据和目标ID准确无误。