Telegram Stickers — Telegram 贴纸

Telegram贴纸规格（官方 — core.telegram.org） 类型 格式 分辨率 透明 最大时长 最大文件大小 静态 PNG 或 WebP 512×512 必须 — 512 KB 视频 WebM VP9 (yuva420p) 512×512 必须 3 秒 256 KB 动画 TGS (Lottie) 512×512 必须 3 秒 64 KB TGS =矢量图，只能使用原始分层矢量图稿，不能从光栅/PNG图像转换。对于NFT/照片艺术，请使用WebM视频贴纸。

快速入门 — 一键脚本 对于大多数请求，请使用sticker.py，它可以处理整个流程的一条命令： # 静态PNG贴纸 python3 scripts/sticker.py # 动画WebM贴纸 python3 scripts/sticker.py --animate sway # 温和的左右摇晃 python3 scripts/sticker.py --animate bounce # 有力的弹跳 python3 scripts/sticker.py --animate shake # 快速的抖动 # 跳过上传（仅本地文件） python3 scripts/sticker.py --animate sway --no-upload 输出：_sticker.png（静态）或_.webm + tmpfiles.org下载URL（动画）。

单独脚本 当您需要细粒度控制或批量处理时，请使用这些脚本。

• 背景去除 + 调整大小 → PNG

python3 scripts/make_sticker.py [output.png] 使用rembg u2net模型（第一次运行后缓存到~/.u2net/u2net.onnx，约170MB下载） 裁剪到内容 → 缩略图到512×512 → 居中于透明画布 → 保存为PNG 如果输出超过512KB，则发出警告

• 生成动画帧

python3 scripts/animate_sway.py [--fps 24] [--duration 2.0] [--shift 18] [--angle 4] [--outdir frames_sway] python3 scripts/animate_bounce.py [--fps 24] [--duration 1.5] [--height 20] [--outdir frames_bounce] python3 scripts/animate_shake.py [--fps 24] [--duration 1.0] [--intensity 10] [--outdir frames_shake] 输入必须是处理过的512×512透明PNG（make_sticker.py的输出）。

• 编码帧 → WebM + 上传

python3 scripts/make_webm.py [output.webm] [--fps 24] [--duration 2.0] [--no-upload] 使用VP9 WebM编码透明背景（yuva420p） 验证时长≤3s和大小≤256KB 自动上传到tmpfiles.org，打印直接下载URL（有效期约1小时） 不要添加-loop 0 — GIF标志，它会破坏WebM

上传到Telegram 生成文件后，通过tmpfiles.org上传（已经由make_webm.py / sticker.py处理）： curl -s -F "file=@sticker.png" https://tmpfiles.org/api/v1/upload # 返回JSON → 在tmpfiles.org/后插入/dl/以获取直接下载URL 请参阅references/stickers-bot-guide.md以获取@Stickers bot的完整步骤。 关键规则：始终将贴纸文件作为文档发送到@Stickers bot，而不是作为照片。Telegram会将照片压缩为JPEG并破坏透明度。

@Stickers Bot — 快速参考 包类型 机器人命令 文件格式 静态 /newpack PNG作为文档 视频贴纸 /newvideo WebM作为文档 静态和视频包是分开的，不能在一个包中混合类型。

依赖项 pip install "rembg[cpu]" Pillow numpy # ffmpeg with libvpx-vp9（系统范围内安装） sticker.py在启动时运行依赖项检查，并在缺少任何依赖项时打印安装提示。