使用Telethon从Telegram消息中移除图片：理解与实践删除策略

新闻中心 NEWS CENTER

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

使用Telethon从Telegram消息中移除图片：理解与实践删除策略

2025-11-17

浏览次数：次

返回列表

使用Telethon从Telegram消息中移除图片：理解与实践删除策略

在使用telethon库处理telegram消息时，直接通过`event.edit(file=none)`移除已发送消息中的图片是不支持的。本文将详细介绍如何在telethon中正确地“移除”图片，其核心策略是删除包含图片的原消息。我们将提供一个完整的python代码示例，演示如何根据消息id获取并有条件地删除带有媒体内容的消息，并讨论相关注意事项。

理解Telethon消息编辑的限制

在使用Telethon库与Telegram API交互时，开发者常会遇到需要修改已发送消息的场景。event.edit方法是Telethon中用于编辑消息的常用工具，它可以更新消息文本、替换媒体文件，甚至修改按钮布局。然而，一个常见的误解是，可以通过设置file=None来直接从带有图片的现有消息中移除图片，同时保留消息文本。

实际上，Telethon的edit方法设计上并不支持“删除”消息中的特定媒体部分而不影响其他内容。当你尝试使用event.edit(file=None)时，Telegram API并不会理解为“移除图片”，而是可能导致错误或无任何效果，因为file参数通常用于指定新的媒体内容。要实现从消息中“移除”图片的效果，我们需要采用一种不同的策略。

核心策略：删除原消息

鉴于event.edit的限制，从Telegram消息中移除图片的最直接且有效的方法是删除包含图片的原消息。如果消息中除了图片还有文本内容，并且你希望保留这些文本，那么你需要先获取原消息的文本，然后删除原消息，最后发送一条新的、只包含文本且不带图片的消息。

本教程将重点演示如何识别并删除带有图片的消息。

Zyro AI Background Remover

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

145 查看详情 Zyro AI Background Remover

使用Telethon删除带有图片的消息

以下是一个详细的Python代码示例，展示了如何使用Telethon客户端连接到Telegram，并根据消息ID删除包含媒体（图片）的特定消息。

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

# 配置您的API凭据
# 请替换为您的实际API ID和API Hash
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 delete_image_message(chat_entity, message_id: int):
    """
    根据消息ID从指定聊天中删除包含图片的消息。
    如果消息不包含图片，则不执行删除操作。

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

        if message and message.media:
            # 如果消息存在且包含媒体（如图片），则删除该消息
            await client.delete_messages(chat_entity, message_id)
            print(f"成功从聊天 {chat_entity} 删除了ID为 {message_id} 的包含图片的消息。")
        elif message:
            print(f"ID为 {message_id} 的消息在聊天 {chat_entity} 中存在，但它不包含图片，未执行删除。")
        else:
            print(f"在聊天 {chat_entity} 中未找到ID为 {message_id} 的消息。")
    except Exception as e:
        print(f"删除消息时发生错误: {e}")

async def main():
    """
    主函数，用于启动客户端并执行删除操作示例。
    """
    print("正在连接到Telegram...")
    await client.start(phone_number=PHONE_NUMBER)
    print("连接成功！")

    # 替换为实际的聊天ID或用户名
    # 例如：-1001234567890 (频道或群组ID), 'username' (用户或频道用户名)
    target_chat_id = 'YOUR_CHAT_ID_OR_USERNAME'
    # 替换为要删除的实际消息ID
    target_message_id = 12345

    print(f"尝试删除聊天 {target_chat_id} 中ID为 {target_message_id} 的消息...")
    await delete_image_message(target_chat_id, target_message_id)

    print("操作完成，正在断开连接...")
    await client.disconnect()
    print("已断开连接。&quot;)

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

代码解析：

客户端初始化: 使用您的API_ID、API_HASH和PHONE_NUMBER初始化TelegramClient。session_name用于存储会话文件，以便后续登录无需再次验证。
delete_image_message函数:
- client.get_messages(chat_entity, ids=message_id): 这是获取特定消息的关键方法。chat_entity可以是聊天ID（通常为负数表示群组或频道）或用户的用户名。ids参数用于指定要获取的消息ID。
- if message and message.media:: 这一步检查消息是否成功获取，并且message.media属性是否存在。message.media会包含媒体对象（如MessageMediaPhoto、MessageMediaDocument等），如果消息包含图片或其他媒体，此条件为真。
- await client.delete_messages(chat_entity, message_id): 如果确认消息包含媒体，则调用此方法删除指定聊天中的消息。
main函数:
- 负责启动客户端 (client.start()) 和断开连接 (client.disconnect())。
- 您需要将target_chat_id和target_message_id替换为实际的值。

注意事项与最佳实践

API凭据安全: 务必保护您的API_ID和API_HASH。不要将其硬编码在公开的代码库中，可以考虑使用环境变量或配置文件。
权限要求: 执行删除操作需要您的Telegram账户在目标聊天中拥有删除消息的权限（例如，作为管理员或消息发送者本人）。
删除的不可逆性: 一旦消息被删除，它将从所有参与者的聊天记录中消失，且无法恢复。请谨慎操作。
获取聊天ID和消息ID:
- 聊天ID: 可以通过Telethon客户端获取，例如，当您收到一条消息时，event.chat_id或event.peer_id会提供。对于群组和频道，ID通常以-100开头。
- 消息ID: 任何消息都有一个唯一的ID，可以通过message.id获取。
保留文本内容: 如果您的目的是“移除图片但保留文本”，则需要在删除前获取消息文本 (message.text)，然后删除原消息，再使用client.send_message(chat_entity, text=message.text)发送一条新的纯文本消息。
错误处理: 示例代码中包含了基本的try-except块来捕获潜在的API错误，但在生产环境中，建议进行更详细的错误日志记录和处理。

总结

通过本教程，我们了解到在Telethon中无法直接通过event.edit(file=None)从消息中移除图片。正确的做法是利用client.delete_messages方法删除包含图片的原消息。如果需要保留文本内容，则应在删除前提取文本，并在删除后重新发送一条纯文本消息。掌握这一核心策略，将帮助您更灵活地管理Telegram消息中的媒体内容。

以上就是使用Telethon从Telegram消息中移除图片：理解与实践删除策略的详细内容，更多请关注其它相关文章！

# 连接到 # SEO优化对代码 # 湛江网站建设公司在哪里 # seo网站推广员就业前景如何 # 抖音关键词排名优化seo怎么做 # 许昌抖音seo搜索服务 # 产品推广营销运营流程 # 长安区口碑营销推广 # seo推广关键词提升排名平台 # 餐饮网站建设优化案例 # seo初学者如何应聘seo博客 # 是一个 # 不包含 # 如何做 # python # 群组 # 可以通过 # 客户端 # 您的 # 移除 # elif # 配置文件 # 环境变量 # ai # session # 工具 # 编码