用途:通过 Spriterrific 托管 HTTP API,把文本提示或参考图变成游戏可用的 2D 角色锚点与动画精灵表,适合有 API Key、不想本地部署 CLI 的用户。
主要能力:GET /api/v1/me 查余额;POST /api/v1/jobs 排队任务;GET /api/v1/jobs 列表与单任务详情;/frames 与 /picks 路由做密集帧缩略图提取、按帧重建精灵表并激活版本。任务类型含 character(主流程)、character variant(同角色换装/换朝向)、action(复用已有锚点加动画)。
用法:Base URL 默认 https://courteous-mouse-611.convex.site,可用 SPRITERRIFIC_API_BASE 覆盖;请求头需 Authorization: Bearer sk_...,并发送 X-Spriterrific-Skill-Version。Key 在 app.spriterrific.com 创建,缺失时向用户索取,不得编造。排队前先查余额并告知预计扣费:角色任务按 3×30+动作×100(sourcePrompt)或 2×30+动作×100(sourceImageUrl/变体)计,动作任务每动作 100 积分;失败或跳过步骤自动退款。
限制:sourceImageUrl 必须是直接返回图片字节的 https 链接,分享页会被拒;actionModes 不要发送,托管动作均为视频模式;动作任务不能改朝向,需先做变体任务;自定义动作须用小写 slug 并配 actionBaselines 与简短 actionContext;16-bit 街机风格暂未提供。视频提示词上限 4096 字符,actionContext 建议约 130 字符内。
更新:技能文件不会自动更新,响应中的 notice 需转告用户;可从 GitHub releases 下载 spriterrific-api-skill.zip 解压到项目根目录更新。