- name
- ali-feishu-sender
- description
- |
Feishu Media Sender
Send multimedia messages to Feishu with proper formatting: inline images, voice bubbles, video players, rich text, and cards.
Dependencies
ffmpegatD:\ffmpeg\bin\ffmpeg.exe(for audio conversion, video fix)ffprobeatD:\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
| Function | Message Type | Key Features |
|---|---|---|
send_text(text) | text | Plain text |
send_image(filepath) | image | Inline embed, auto-detect mime |
send_audio(filepath) | audio | Voice bubble, auto→opus, auto duration |
send_video(filepath, cover_image=None) | media | Inline player, faststart, auto duration |
send_rich_text(title, elements) | post | Rich text with embedded media |
send_card(title, elements) | interactive | Card with header color |
All functions accept optional: open_id, token, app_id, app_secret.
Key Rules (learned from testing)
- Audio: Must be opus format, must include
duration(ms). Auto-converts non-opus via ffmpeg. - Video: Must upload as
file_type=mp4, must includeduration(ms). Script auto-applies-movflags +faststart. - Video message type: Use
msg_type=media(notvideo), content usesfile_key+ optionalimage_keyfor cover. - Image in video:
image_keyis the cover thumbnail. Without it, video has no preview frame. - Rich text media: Use
{'tag': 'media', 'file_key': '...', 'image_key': '...'}as an independent paragraph. - 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