统一鉴权
所有 /v1/ 接口都必须携带 Bearer API Key。
Authorization: Bearer mz_live_你的_API_Key不要把 Key 写进网页前端、公开仓库或客户端应用；请由你的服务端发起调用。
Quick start
三步接入
- 01
创建 API Key
回到首页，使用 QQ 登录后在“账号中心”创建 API Key。完整 Key 只显示一次。
- 02
查询模板与参数
先请求模板列表获取固定编号，再通过模板详情获取它需要的图片、文字和可选参数。
- 03
提交生成请求
以
multipart/form-data上传图片和文本；接口直接返回生成后的图片二进制。
API reference
接口说明
模板列表
GET /v1/templates
返回可用模板的固定 id、key、中文名称、关键词和标签。id 从 1 开始永久固定，新增模板只会追加新编号。
curl "https://memez.icu/v1/templates" \
-H "Authorization: Bearer mz_live_你的_API_Key"模板详情
GET /v1/memes/{id_or_key}/info
可使用固定编号或英文 key。生成前请读取 params_type，其中包含图片和文字的最小、最大数量，以及 args 的结构。
curl "https://memez.icu/v1/memes/13/info" \
-H "Authorization: Bearer mz_live_你的_API_Key"生成表情包
POST /v1/memes/{id_or_key}/，响应体就是图片二进制；可使用固定编号或英文 key。以下示例用编号 13 将结果保存为 meme.png。
curl -X POST "https://memez.icu/v1/memes/13/" \
-H "Authorization: Bearer mz_live_你的_API_Key" \
-F "images=@face.png" \
-F "texts=给你看个傻子" \
-F 'args={}' \
--output meme.png生成请求字段
| 字段 | 类型 | 说明 |
|---|---|---|
images | 文件，可重复 | 按模板详情要求上传 0 至多张图片，顺序即图片使用顺序。 |
texts | 字符串，可重复 | 按模板详情要求传入 0 至多行文字，顺序即文字使用顺序。 |
args | JSON 字符串 | 模板没有附加参数时传 {}；有参数时以详情接口返回的结构为准。 |
网页中的“QQ 头像”便捷功能不属于 /v1/ API；API 调用请直接上传你已获授权使用的图片。
Limits & errors
限额、错误与排查
默认限额
每个 API Key 每分钟最多 30 次调用，每天最多 100 次生成调用。生成调用无论成功或失败均会计入当天额度。
常见响应
401：缺少、无效或已停用的 API Key。422：模板不存在，或图片、文字、参数不符合模板要求。429：调用频率或每日生成额度已达到限制。503：生成队列繁忙，请进行退避重试。
接入建议
生成前始终查询模板详情；收到 429 或 503 时使用指数退避重试；不要在日志中记录完整 API Key。