Feishu 媒体发送器

向 Feishu 发送格式规范的多媒体消息：内联图片、语音气泡、视频播放器、富文本及卡片。

依赖项

• ffmpeg 位于 D:ffmpegbinffmpeg.exe（用于音频转码、视频修复）
• ffprobe 位于 D:ffmpegbinffprobe.exe（用于时长检测）
• Python 3.7 或更高版本
• Feishu 应用凭据（已在脚本默认配置中预先设置）

快速参考

运行脚本 scripts/feishu_media.py：

import sys; sys.path.insert(0, r'/scripts'); from feishu_media import *

可用函数

所有函数均支持以下可选参数：open_id、token、app_id、app_secret。

关键规则（经实测总结）

1. 音频：必须为 opus 格式，且必须提供 duration（单位：毫秒）。非 opus 文件将通过 ffmpeg 自动转码。
2. 视频：上传时需指定 file_type=mp4，且必须提供 duration（单位：毫秒）。脚本会自动应用 -movflags +faststart 参数优化首帧加载。
3. 视频消息类型：应使用 msg_type=media（而非 video），内容体中使用 file_key 字段，并可选传入 image_key 指定封面图。
4. 视频封面图：image_key 即为视频预览缩略图。若未提供，视频将无预览帧。
5. 富文本中的媒体：以独立段落形式使用 {'tag': 'media', 'file_key': '...', 'image_key': '...'} 结构。
6. 文件上传类型：opus（音频）、mp4（视频）、stream（通用文件）、pdf、doc、xls、ppt。

示例：向 Feishu 发送 MiniMax 内容

# 图片
send_image('minimax-output/kitten.png')

# TTS 语音气泡（自动将 mp3 转为 opus）
send_audio('minimax-output/greeting.mp3')

# 带封面的视频（自动 faststart + 时长提取）
send_video('minimax-output/kitten_video.mp4', cover_image='minimax-output/kitten.png')

# 含视频的富文本
send_rich_text('阿离的报告', [
    [{'tag': 'text', 'text': '一舞剑气动四方~'}],
    [{'tag': 'media', 'file_key': 'file_xxx', 'image_key': 'img_xxx'}],
])

命令行使用方式

python scripts/feishu_media.py text "Hello"
python scripts/feishu_media.py image photo.png
python scripts/feishu_media.py audio greeting.mp3
python scripts/feishu_media.py video clip.mp4 --cover thumb.png