如何通过给定的Telegram URL链接编程下载视频到本地硬盘

前置要求 #

你需要提前准备好Telegram官方开放的api_id和api_hash，可通过Telegram开发者平台申请获得。

步骤1：安装依赖包 #

执行以下命令安装所需的Python库：

pip install pyrogram tgcrypto

步骤2：使用完整脚本 #

复制以下代码保存为tg_video_download.py，替换代码中API_ID和API_HASH为你自己申请的对应值：

from pyrogram import Client
import re

# 替换为你的个人API凭证
API_ID = 你的数字ID
API_HASH = "你的哈希字符串"

def parse_tg_link(link):
    link_pattern = r"https?://t\.me/([a-zA-Z0-9_]+)/(\d+)"
    res = re.match(link_pattern, link.strip())
    if not res:
        raise ValueError("输入的链接格式不符合要求")
    return res.group(1), int(res.group(2))

if __name__ == "__main__":
    tg_link = input("请输入Telegram消息链接：")
    channel_username, message_id = parse_tg_link(tg_link)
    
    with Client("download_session", API_ID, API_HASH) as client:
        message = client.get_messages(channel_username, message_ids=message_id)
        if not message.video:
            print("目标消息无视频内容")
            exit()
        print(f"正在下载视频：{message.video.file_name or '未命名视频'}，大小约{round(message.video.file_size/1024/1024, 2)}MB")
        save_path = client.download_media(message)
        print(f"下载完成，文件保存至：{save_path}")

步骤3：运行说明 #

• 首次运行脚本时，会提示你输入绑定Telegram账号的手机号（需带国家区号，如中国手机号前缀为+86）、验证码及两步验证密码（如有），验证完成后会自动生成会话文件，后续运行无需重复验证
• 输入格式为https://t.me/channelName/1234的消息链接后，脚本会自动检测视频并下载到脚本运行的同级目录

注意：你所使用的Telegram账号必须拥有目标频道的访问权限，私密频道需提前加入才可正常获取内容。请勿将脚本用于非法下载、传播侵权内容的场景。

内容的提问来源于stack exchange，提问作者Anthony