咔咔表情投稿指南
生成静态表情、动态 GIF、投稿素材和下载包的流程说明。
基本流程
- 上传照片或填写表情包想法。
- 生成静态 3x4 表情合集。
- 系统抠图并切成 12 张 240x240 PNG。
- 在结果页继续生成动态 GIF 或微信投稿素材。
- 下载单张素材、下载清单或 ZIP 包。
积分规则
- 静态表情包(12 张): 20 积分。
- 在已完成作品上追加动态 GIF: 24 积分。
- 动态与静态一次下单(套装): 动态部分按 20 积分计。
- 微信投稿素材包: 10 积分; 与静态一次下单时按 8 积分计。
- 注册赠送 30 积分, 每日登录再送 5 积分。
- 积分不足时, 任务会在创建前被拒绝。
- 供应商或 worker 失败时, 系统释放预扣的积分, 不会扣费。
动态 GIF
动态 GIF 使用 Grok 视频模型和外部 worker:
- 模型:
grok-imagine-video-1-5-preview - 参数:
duration=3,aspect_ratio=3:4,resolution=720p - 输出: 12 张单表情 GIF、合集 GIF、preview MP4、manifest
浏览器 API 只创建和查询任务, 不在 Vercel route handler 内执行 ffmpeg。
投稿素材
投稿素材归属于同一个 sticker set 项目, 包含:
- 名称和介绍。
- 版权说明。
- 横幅、封面、图标。
- 赞赏引导和赞赏致谢图。
当前商业版已具备任务、状态、资产、下载清单和 ZIP 导出结构。live 模式会用
sharp 从静态表情生成微信投稿尺寸 PNG；后续可接 KIE 进一步增强投稿图视觉质量。
公开广场
表情包默认私密。用户将作品设为公开后会进入 Gallery 审核队列。管理员可通过
/api/admin/kakameme/gallery 审核、拒绝、归档、精选和排序。公开 Gallery 只展示已审核通过且保持公开状态的作品, 不暴露未授权原图。
API 调用
用户可以在 /settings/apikeys 创建 API key。应用内使用的静态生成任务 API
同时支持登录 session 和 API key, API key 可放在 Authorization: Bearer <key>
或 x-api-key header 中。
创建静态表情任务:
curl -X POST "$NEXT_PUBLIC_BASE_URL/api/generation-jobs" \
-H "Authorization: Bearer $KAKAMEME_API_KEY" \
-H "Content-Type: application/json" \
-d '{"userIdea":"一只开心写代码的柯基","visibility":"private"}'也可以上传照片生成(sourceImageUrl 传可公开访问的图片地址),
并通过 requestedOutputs 在同一个任务里一并请求动态 GIF 和投稿素材
(静态完成后自动追加,按套装价计费):
curl -X POST "$NEXT_PUBLIC_BASE_URL/api/generation-jobs" \
-H "Authorization: Bearer $KAKAMEME_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sourceImageUrl": "https://example.com/photo.jpeg",
"userIdea": "呆萌主题",
"visibility": "private",
"requestedOutputs": ["static", "dynamic", "submission"]
}'查询任务状态和生成资产:
curl "$NEXT_PUBLIC_BASE_URL/api/generation-jobs/job_123" \
-H "Authorization: Bearer $KAKAMEME_API_KEY"注意:
- 每把 API key 默认限流 6 次/分钟,超出会返回 429,等窗口重置后重试。
- 动态 GIF 只能在创建任务时通过
requestedOutputs一并请求; 对已完成的作品单独补动态或重新生成,目前仅支持在网页结果页操作。
登录用户还可以通过 GET /api/sticker-sets/[id]/assets 查询项目素材清单。
保存角色与版权保护
用户可以在结果工作台把当前角色保存到 saved_characters, 便于后续复用。也可以为表情包开启版权保护。版权保护不是法律承诺; 它会标记项目为受保护状态, 并让公开 Gallery 不暴露原始上传图或完整 prompt。
问题报告
结果工作台包含“报告问题”入口。报告会写入 issue_reports, 记录问题类型、状态、描述、作品 id、可选任务 id 和轻量上下文。对生成内容不满意时, 先进入报告问题与人工/规则审核流程, 不做自动退费。
常见问题
为什么我的任务显示失败?
查看结果页的失败提示。后台会记录 failed step、provider、model、provider task id 和错误摘要。
失败会扣积分吗?
不会。成功任务确认扣费, 失败任务自动释放预扣的积分。
下载支持哪些格式?
默认下载 API 返回稳定文件名和 URL 清单。结果页的 ZIP 下载会调用
/api/sticker-sets/[id]/download?format=zip, 同步打包当前静态、动态和投稿素材。