咔咔表情投稿指南

基本流程

上传照片或填写表情包想法。
新角色生成后先确认；不满意可写修改建议重新生成，上一版不会因失败丢失。
确认角色后，系统生成静态 3x4 合集并切成 12 张 240x240 PNG。
在同一作品页继续生成动态 GIF 或微信投稿素材。
下载单张素材、下载清单或 ZIP 包。

积分规则

生成或修改一次角色: 2 积分。
静态表情包(12 张): 18 积分。
在已完成作品上追加动态 GIF: 40 积分。
动态与静态一次下单(套装): 动态部分按 40 积分计。
微信投稿素材包: 10 积分; 与静态一次下单时按 8 积分计。
注册赠送 22 积分, 每日登录再送 1 积分。
积分不足时, 任务会在创建前被拒绝。
角色等待确认期间不预留静态积分；确认时重新检查余额。
供应商或 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 审核、拒绝、归档、精选和排序。只有已审核通过的 public 作品会进入发现列表、分类、推荐和推广，也不会暴露未授权原图。

用户将已审核通过的作品从 Gallery 下架后，作品会变为 unlisted。这只会把作品从 KakaMeme 站内发现入口移除，并不会让它变为私密；稳定详情页、公开素材、搜索引擎结果以及他人已持有的链接仍可能被访问。删除整个项目，或由管理员因审核或法律原因下架，是另外的操作；已经下载或缓存的副本无法收回。详情查询和详情 sitemap 会包含已审核通过的 public 或 unlisted 作品。

管理员拒绝或归档始终会覆盖用户可见性。取消 pending 只会让待审作品回到私密状态；取消 pending 不会产生可索引的 unlisted 页面。

API 调用

用户可以在 /settings/apikeys 创建 API key。应用内使用的静态生成任务 API 同时支持登录 session 和 API key。网页 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 查询项目素材清单。

咔咔表情投稿指南

基本流程

积分规则

动态 GIF

投稿素材

公开广场

API 调用

保存角色与版权保护

问题报告

常见问题

为什么我的任务显示失败?

失败会扣积分吗?

下载支持哪些格式?

目录