Telethon中从Telegram消息移除图片的方法指南_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Telethon中从Telegram消息移除图片的方法指南

2025-11-17

浏览次数：次

返回列表

Telethon中从Telegram消息移除图片的方法指南

本文详细介绍了在telethon框架下，如何有效地从telegram消息中移除图片。针对 `event.edit` 方法无法直接删除媒体附件的局限性，本教程阐述了通过 `client.delete_messages` 方法删除包含图片的原始消息，从而实现“移除”图片的目的。文章提供了完整的代码示例、操作步骤及注意事项，旨在帮助开发者理解并正确处理telethon中的消息媒体管理。

Telethon中消息图片移除的策略与实践

在使用Telethon库与Telegram API交互时，开发者常会遇到需要管理消息内容，包括移除已发送图片的需求。然而，直接通过 event.edit 方法并设置 file=None 来移除消息中的图片是不可行的。event.edit 主要用于修改消息的文本内容、解析模式、按钮布局等非媒体属性。要从Telegram消息中“移除”图片，最直接且有效的方法是删除包含该图片的原始消息。

理解 event.edit 的局限性

在Telethon中，event.edit 方法通常用于响应事件（如回调查询 CallbackQuery）时，修改与该事件关联的特定消息。例如，修改一个按钮消息的文本或更新其按钮布局。

@client.on(events.CallbackQuery(func=lambda e: e.data == b"code"))
async def add_ads(event: CallbackQuery.Event):
    # 这段代码尝试通过event.edit移除图片，但不会成功
    # await event.edit(file=None) 
    # event.edit 主要用于编辑文本、解析模式或按钮
    await event.edit("图片已移除（但实际上是无法通过此方法移除的）", buttons=None)

上述代码中，即使尝试 await event.edit(file=None)，也无法将消息中的图片移除。Telegram API的设计决定了媒体文件一旦附加到消息，就成为消息的一部分，无法独立于消息进行删除或修改。因此，要移除图片，必须删除整个消息。

核心方法：通过删除消息移除图片

要从Telegram消息中移除图片，正确的做法是使用 client.delete_messages 方法来删除包含该图片的消息。这相当于将带有图片的消息从聊天中完全移除。

Zyro AI Background Remover

Zyro推出的AI图片背景移除工具

145 查看详情 Zyro AI Background Remover

实践指南：使用Telethon删除含图片消息

以下是一个完整的Python示例，演示如何使用Telethon删除特定聊天中的含图片消息：

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

# 替换为您的API凭据和电话号码
api_id = 'YOUR_API_ID' 
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# 初始化Telegram客户端
client = TelegramClient('session_name', api_id, api_hash)

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

    Args:
        chat_id (int | str): 目标聊天的ID或用户名。
        message_id (int): 目标消息的ID。
    """
    try:
        # 启动客户端连接
        await client.start(phone=phone_number)

        # 获取指定消息
        # client.get_messages 可以获取单个或多个消息
        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"成功从聊天 {chat_id} 中删除了包含图片的消息 (ID: {message_id})。")
        elif message:
            print(f"指定消息 (ID: {message_id}) 不包含图片。")
        else:
            print(f"未找到指定消息 (ID: {message_id})。")

    except Exception as e:
        print(f"删除消息时发生错误: {e}")
    finally:
        # 确保客户端断开连接
        await client.disconnect()

async def main():
    # 替换为实际的聊天ID和消息ID
    # 聊天ID可以是整数（如用户ID、群组ID）或字符串（如群组用户名）
    target_chat_id = 'YOUR_CHAT_ID'  # 例如: -1001234567890 (群组ID) 或 'username'
    target_message_id = 123          # 替换为要删除的消息的ID

    await remove_image_from_message(target_chat_id, target_message_id)

if __name__ == '__main__':
    # 运行主函数
    import asyncio
    asyncio.run(main())

代码解释：

客户端初始化： 使用您的 api_id、api_hash 和 phone_number 初始化 TelegramClient。session_name 用于存储会话文件，避免每次运行都需重新认证。
remove_image_from_message 函数：
- 接受 chat_id 和 message_id 作为参数，用于定位目标消息。
- await client.start(phone=phone_number)：在执行操作前启动客户端连接。如果会话文件不存在，将提示您输入验证码。
- message: Message = await client.get_messages(chat_id, ids=message_id)：通过 chat_id 和 message_id 获取指定的消息对象。
- if message and message.media:：判断消息是否存在，并且 message.media 属性不为空，这意味着消息包含媒体文件（如图片、视频、文件等）。
- await client.delete_messages(chat_id, message_id)：如果消息符合条件，则调用此方法删除该消息。
- 错误处理：使用 try...except 块捕获可能发生的异常，提高程序的健壮性。
- finally 块确保在任何情况下都会断开客户端连接。
main 函数： 示例如何调用 remove_image_from_message，您需要替换 target_chat_id 和 target_message_id 为实际值。
运行脚本： if __name__ == '__main__': asyncio.run(main()) 确保脚本在直接运行时执行 main 函数。

注意事项与最佳实践

API凭据安全： 永远不要将您的 api_id 和 api_hash 硬编码在公开代码中，或共享给他人。建议使用环境变量或其他安全配置方式。
权限要求： 执行删除操作的Telethon客户端（用户或机器人）必须在目标聊天中拥有删除消息的权限。
消息ID和聊天ID的准确性： 确保 chat_id 和 message_id 正确无误。错误的ID可能导致操作失败或删除错误的消息。
消息存在性及媒体判断： 在删除前判断消息是否存在以及是否包含媒体是一个良好的实践，可以避免不必要的错误和误操作。
替代方案考量：
- 替换图片： 如果您的目标是替换消息中的图片，而不是完全删除，那么仍然需要先删除原消息，然后发送一条包含新图片的新消息。
- 将图片消息转为纯文本： 同样，您需要删除原图片消息，然后发送一条新的纯文本消息。
异步操作： Telethon是异步库，所有API调用都必须在 async 函数中使用 await 关键字。

总结

在Telethon中，直接通过 event.edit 方法移除消息中的图片是不支持的。要实现从Telegram消息中“移除”图片，开发者应采用删除包含该图片的消息的策略，即使用 client.delete_messages 方法。通过本文提供的代码示例和详细说明，您可以有效地在Telethon应用程序中管理消息中的媒体内容。务必注意权限、ID准确性以及错误处理，以确保操作的稳定性和安全性。