📖 QQ表情包生成器 API 文档

⚡ 一、快捷链接（推荐，浏览器直接打开）

无需任何代码，把链接粘到浏览器就能直接看到动图，也适合直接发给别人：

http://192.168.0.103:8000/output/input=模板ID&qq1=QQ号

示例

http://192.168.0.103:8000/output/input=nod&qq1=3344715423

可选参数

参数	说明	示例
input	模板ID（必填）	nod / jump / spin
qq1	QQ号（必填）	3344715423
qq2	第二个QQ号（仅双人模板需要）	qq2=123456
size	头像大小（50~640）	size=300
format	输出格式	format=webp
duration	每帧毫秒数（越小越快）	duration=40
amplitude	点头/摇头幅度	amplitude=30
jump_height	跳动高度	jump_height=100
intensity	抖动强度	intensity=12

💡 例如加速摇头：/output/input=shake_head&qq1=3344715423&duration=40&litude=30

🤩 二、梗图模板（meme-generator，几百个预制表情）

链接里直接写中文关键词就能用经典梗图，无需记英文ID：

单人梗图

http://192.168.0.103:8000/output/input=摸头&qq1=3344715423

双人梗图（两个QQ头像互动）

http://192.168.0.103:8000/output/input=贴贴&qq1=3344715423&qq2=123456

带文字

http://192.168.0.103:8000/output/input=鲁迅说&qq1=3344715423&texts=这话说得真对

常用关键词示例

摸头、贴贴、敲、捏脸、蹭、拍、抱抱、踩、炖、吸、嗦、rua、搓、顶、
王境泽、吴京、乌鸦哥、红温、典中典、震惊、无语、喜报、结婚、离婚、
原神、科目三、猫猫举牌、可达鸭、鲁迅说、罗永浩说、击剑、举牌、5000兆、高血压

💡 完整关键词列表：GET /api/templates 的 memes 字段（含每个模板的 keywords / 需要的头像数 / 文字数）

⚠️ 首次使用某个梗图时会自动下载素材（需联网），稍等几秒即可

🔌 三、API 接口

获取所有可用模板列表，返回 JSON。

生成表情包，直接返回图片二进制（GIF/WebP/PNG）。

curl -X POST "http://localhost:8000/api/generate" \
  -H "Content-Type: application/json" \
  -d '{"qq": "3344715423", "template": "nod"}' \
  --output emoji.gif

生成表情包并保存，返回可访问的 URL 链接。

curl -X POST "http://localhost:8000/api/generate-url?base_url=http://192.168.0.103:8000" \
  -H "Content-Type: application/json" \
  -d '{"qq": "3344715423", "template": "jump"}'

📦 四、请求参数说明（POST /api/generate）

参数	类型	默认	说明
qq	string	必填	QQ号
template	string	必填	模板ID
avatar_size	int	200	头像尺寸 50~640
circle_avatar	bool	true	是否圆形裁剪
output_format	string	gif	gif / webp / png / apng
duration	int	模板默认	每帧毫秒数
amplitude	int	模板默认	动作幅度
jump_height	int	模板默认	跳动高度
intensity	int	模板默认	抖动强度
loop	int	0	循环次数（0=无限）

🎭 五、可用模板

ID	名称	分类	说明
nod	点头	动作类	头像轻轻点头，适合「同意」「嗯嗯」场景
shake_head	摇头	动作类	头像左右摇摆，适合「不要」「不不不」场景
jump	上下跳动	动作类	头像上下弹跳，带落地压缩效果，适合「开心」「耶」场景
spin	旋转	动作类	头像360度旋转，适合「晕」「转圈」场景
breathe	呼吸/心跳	动作类	头像缓慢放大缩小，适合「期待」「紧张」场景
shake	鬼畜抖动	动作类	头像快速随机抖动+旋转，适合「不要啊」「崩溃」场景
shock	震惊	表情类	头像快速放大再缩小，适合「什么?!」「震惊」场景
side_jump	左右横跳	动作类	头像左右快速横跳，适合「挑衅」「来呀」场景
custom	自定义帧序列	高级	高级用户自定义每一帧的位置、缩放、旋转、透明度