Telegram Bot API 发送图片代码详解

在当今即时通讯工具中，Telegram 以其强大的 Bot API 功能而备受开发者青睐。通过 Telegram Bot，我们可以实现自动化消息推送、用户交互等多种功能，其中发送图片是最基础且常用的操作之一。本文将详细介绍如何使用 Telegram Bot API 发送图片，涵盖多种实现方式和代码示例。

首先，我们需要明确 Telegram Bot API 提供了两种主要方法来发送图片：通过 sendPhoto 接口发送本地或网络图片，以及通过 sendMediaGroup 接口发送多张图片。核心步骤包括：获取 Bot Token、确定目标聊天 ID、构建请求并处理响应。以下是一个使用 Python 和 requests 库发送网络图片的示例：

import requests

def send_telegram_photo(bot_token, chat_id, image_url, caption=None):

    api_url = f"https://api.telegram.org/bot{bot_token}/sendPhoto"

    payload = {

        'chat_id': chat_id,

        'photo': image_url

    }

    if caption:

        payload['caption'] = caption



    response = requests.post(api_url, data=payload)

    return response.json()

# 使用示例

bot_token = "YOUR_BOT_TOKEN"

chat_id = "TARGET_CHAT_ID"

image_url = "https://example.com/image.jpg"

send_telegram_photo(bot_token, chat_id, image_url, caption="这是一张示例图片")

若需发送本地图片，则需以二进制文件形式上传。以下代码展示了如何通过 multipart/form-data 格式发送本地图片文件：

def send_local_photo(bot_token, chat_id, file_path, caption=None):



    api_url = f"https://api.telegram.org/bot{bot_token}/sendPhoto"

    with open(file_path, 'rb') as image_file:

        files = {'photo': image_file}

        payload = {'chat_id': chat_id}

        if caption:

            payload['caption'] = caption

        response = requests.post(api_url, files=files, data=payload)

    return response.json()

除了直接使用 HTTP 请求，开发者还可以利用现成的 SDK 来简化操作。例如，使用 Python-telegram-bot 库发送图片的代码更加简洁：

from telegram import Bot

bot = Bot(token="YOUR_BOT_TOKEN")

# 发送网络图片

bot.send_photo(chat_id=chat_id, photo=image_url, caption="示例")

# 发送本地图片

with open('local_image.jpg', 'rb') as photo:

    bot.send_photo(chat_id=chat_id, photo=photo, caption="本地图片")

在实际应用中，我们还需考虑错误处理、图片格式支持（JPEG、PNG、GIF 等）、文件大小限制（Telegram 允许最大 10MB 的图片）以及异步发送等进阶话题。通过合理设置 caption 参数，我们还能为图片添加描述文字，甚至使用 parse_mode 参数支持 Markdown 或 HTML 格式文本。

总之，Telegram Bot API 为图片发送提供了灵活而强大的支持。无论是简单的通知推送，还是复杂的交互场景，掌握图片发送代码都是构建高效 Telegram 机器人的重要基石。开发者可以根据具体需求选择适合的方法，并结合官方文档不断优化功能实现。