Feishu Media Sender

Send multimedia messages to Feishu with proper formatting: inline images, voice bubbles, video players, rich text, and cards.

Dependencies

• ffmpeg at D:\ffmpeg\bin\ffmpeg.exe (for audio conversion, video fix)
• ffprobe at D:\ffmpeg\bin\ffprobe.exe (for duration detection)
• Python 3.7+
• Feishu app credentials (pre-configured in script defaults)

Quick Reference

Run the script at scripts/feishu_media.py:

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

Available Functions

All functions accept optional: open_id, token, app_id, app_secret.

Key Rules (learned from testing)

1. Audio: Must be opus format, must include duration (ms). Auto-converts non-opus via ffmpeg.
2. Video: Must upload as file_type=mp4, must include duration (ms). Script auto-applies -movflags +faststart.
3. Video message type: Use msg_type=media (not video), content uses file_key + optional image_key for cover.
4. Image in video: image_key is the cover thumbnail. Without it, video has no preview frame.
5. Rich text media: Use {'tag': 'media', 'file_key': '...', 'image_key': '...'} as an independent paragraph.
6. File upload types: opus (audio), mp4 (video), stream (generic file), pdf, doc, xls, ppt.

Example: Send MiniMax content to Feishu

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

# TTS voice bubble (auto converts mp3→opus)
send_audio('minimax-output/greeting.mp3')

# Video with cover (auto faststart + duration)
send_video('minimax-output/kitten_video.mp4', cover_image='minimax-output/kitten.png')

# Rich text with video
send_rich_text('阿离的报告', [
    [{'tag': 'text', 'text': '一舞剑气动四方~'}],
    [{'tag': 'media', 'file_key': 'file_xxx', 'image_key': 'img_xxx'}],
])

CLI Usage

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