0

0

如何使用Telethon从Telegram消息中删除图片

心靈之曲

心靈之曲

发布时间:2025-11-20 11:39:21

|

220人浏览过

|

来源于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删除一条或多条消息。这是移除消息中图片的有效手段,因为它会彻底移除包含图片的原消息。

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

传媒公司模板(RTCMS)1.0
传媒公司模板(RTCMS)1.0

传媒企业网站系统使用热腾CMS(RTCMS),根据网站板块定制的栏目,如果修改栏目,需要修改模板相应的标签。站点内容均可在后台网站基本设置中添加。全站可生成HTML,安装默认动态浏览。并可以独立设置SEO标题、关键字、描述信息。源码包中带有少量测试数据,安装时可选择演示安装或全新安装。如果全新安装,后台内容充实后,首页才能完全显示出来。(全新安装后可以删除演示数据用到的图片,目录在https://

下载

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准确无误。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

746

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

634

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

758

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

617

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1261

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

705

2023.08.11

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

6

2026.01.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.6万人学习

Django 教程
Django 教程

共28课时 | 3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号