Telegram Bot是构建自动化服务和互动体验的利器，而发送照片是其中最常见的需求之一。无论是通知截图、商品展示还是状态监控，调用官方API的sendPhoto方法都能高效完成。本文将从零开始，通过详细参数解析和可运行代码示例，帮助开发者快速掌握Telegram Bot发送照片的全部要点。
一、Telegram Bot API与sendPhoto方法概述
Telegram Bot API是一套基于HTTP的接口，允许开发者通过简单的请求控制Bot行为。sendPhoto方法用于向指定聊天发送图片，支持两种图片来源：一是通过URL传图，二是直接上传文件。理解该方法是构建富媒体Bot的基础。
官方接口地址为：https://api.telegram.org/bot<token>/sendPhoto，其中<token>替换为你的Bot令牌。
二、sendPhoto API参数详解
调用sendPhoto时，必须传递chat_id和photo。此外，还可选配多个增强功能：
- chat_id（必填）：聊天标识，可为用户ID、群组ID或频道ID（负数）。
- photo（必填）：图片文件ID（从其他API获得）、HTTP URL或multipart form-data上传的文件。
- caption（可选）：图片说明，支持最多1024字符。
- parse_mode（可选）：caption格式，支持HTML或MarkdownV2。
- disable_notification（可选）：静默发送。
- reply_to_message_id（可选）：回复的消息ID。
- reply_markup（可选）：内联键盘等。
三、使用curl调用sendPhoto发送照片
curl是测试API的快速工具。以下两种方式分别演示URL传图和文件上传。
通过URL发送
curl -s -X POST "https://api.telegram.org/bot<TOKEN>/sendPhoto" -F chat_id=123456789 -F photo="https://example.com/photo.jpg"上传本地文件
curl -s -X POST "https://api.telegram.org/bot<TOKEN>/sendPhoto" -F chat_id=123456789 -F photo=@/path/to/photo.jpg注意：使用@符号指定文件路径，且该路径为本地绝对路径。
四、使用Python调用sendPhoto发送照片
Python与requests库的组合是最流行的开发方式。下面给出两个实用示例。
使用URL发送
import requests
token = "YOUR_BOT_TOKEN"
chat_id = "123456789"
photo_url = "https://example.com/photo.jpg"
url = f"https://api.telegram.org/bot/sendPhoto"
params = {"chat_id": chat_id, "photo": photo_url}
resp = requests.post(url, params=params)
print(resp.json())上传本地文件
import requests
token = "YOUR_BOT_TOKEN"
chat_id = "123456789"
file_path = "/path/to/photo.jpg"
url = f"https://api.telegram.org/bot/sendPhoto"
with open(file_path, "rb") as f:
files = {"photo": f}
data = {"chat_id": chat_id}
resp = requests.post(url, data=data, files=files)
print(resp.json())五、常见错误与解决方案
在实际调用中，开发者可能会遇到以下问题：
- 400 Bad Request: chat_id is empty：确认chat_id参数非空且正确。
- 404 Not Found：检查token是否有效，或方法名拼写。
- 图片过大：Telegram对上传文件大小有限制，最大20MB（普通Bot）。可压缩图片或使用文件ID。
- 网络超时：使用requests时设置timeout，并增加重试机制。
六、最佳实践与性能优化
为了提高效率和可靠性，建议遵循以下原则：
- 优先复用文件ID：同一张图片重复发送时，使用文件ID可大幅节省流量和上传时间。
- 错误重试：针对429（限流）和5xx错误，实施指数退避策略。
- 异步处理：使用异步框架（如asyncio）可同时服务多个会话。
- 安全保护：切勿在日志中泄露Bot token，传输时使用HTTPS。
总结
通过本文的API调用实例，您已经掌握了Telegram Bot发送照片的核心技能。从参数解读到实际代码，再到错误排查，完整的实战路径有助于您快速构建自己的图片推送服务。后续可进一步探索caption格式化、内联键盘等功能，让Bot体验更加丰富。请始终参考官方文档，确保开发符合最新规范。