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:

python

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

Available Functions#

FunctionMessage TypeKey Featuressend_text(text)textPlain textsend_image(filepath)imageInline embed, auto-detect mimesend_audio(filepath)audioVoice bubble, auto→opus, auto durationsend_video(filepath, cover_image=None)mediaInline player, faststart, auto durationsend_rich_text(title, elements)postRich text with embedded mediasend_card(title, elements)interactiveCard with header color

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#

python

# 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#

bash

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