Spine 3.8 · Headless Render API

把骨骼动画渲染成 PNG / GIF，
按次计费，agent 可直接调用。

纯 CPU 无头渲染，JSON 进、图片出。为 AI agent 设计：既提供 HTTP 接口，也提供标准 MCP 端点；人类可以用命令行客户端一条命令出图。

注册领取 25 积分试用查看接入方式下载 CLI（Win / Linux）

注册送 25 积分（= 5 次单帧 / 1 次 GIF）渲染失败不扣费重试幂等，不会重复扣费 10 积分 = 1 元已收录于 MCP 官方 Registry：top.lain42/spine-render

真实渲染输出

以下均为本服务实际产出（明日方舟角色素材，透明背景）。

按次定价

积分钱包结算，充值 1 元 = 10 积分。失败不扣费；同一请求 ID 重试永不重复扣费。

操作	端点	价格	说明
解析骨骼	`describe`	免费	版本 / 骨骼数 / 动画列表
单帧渲染	`frame`	5 积分（¥0.5）	透明背景 PNG，指定动画与时间
动画渲染	`animate`	20 积分（¥2）	GIF，自选帧数（4–96）与帧率（2–30）

画布 64–1024px；骨架 ≤10MB、图集 ≤2MB、页图 ≤4 张；输出 ≤24MB；单次渲染超时 120 秒。服务串行执行，高峰排队。支持 --anchor footline:0.8 的 PRTS wiki 战斗小人构图。

三种接入方式

同一个账户令牌（studio-billing Bearer Token）通行全部通道。

HTTP

任意语言 curl 可调

POST JSON（素材 base64）→ 返回图片 base64。适合脚本与后端集成。

MCP

AI agent 直连

标准 Streamable HTTP MCP 端点，四工具即插即用，agent 可自主渲染并计费。

CLI

一条命令出图

官方客户端 Windows/Linux，本地免费渲染与云端计费渲染共用一套参数。

1 · 获取令牌

# 注册（自动赠送 25 体验积分）后登录拿 token
curl -X POST https://lain42.top/studio/api/login \
  -H 'Content-Type: application/json' \
  -d '{"username":"you","password":"..."}'
# -> {"ok":true,"token":"eyJ...","signup_bonus":{"points":25}}

2 · HTTP 调用（单帧 5 积分）

curl -s -X POST https://lain42.top/studio/render/frame \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"atlas":"<base64>","skel":"<base64>",
       "pages":[{"name":"a.png","png":"<base64>"}],
       "animation":"Idle","time":0.5,"width":512,"height":512,
       "request_id":"my-id-1"}'
# 响应含 image_base64 / balance / charged；余额不足返回 402（带充值指引）

3 · MCP 直连（agent 首选）

{
  "mcpServers": {
    "spine-render": {
      "type": "http",
      "url": "https://lain42.top/studio/render/mcp-server/mcp",
      "headers": {"Authorization": "Bearer <token>"}
    }
  }
}
# 工具：spine_render_pricing / spine_describe / spine_render_frame / spine_render_animate

4 · 命令行客户端

# 下载：github.com/lilyco-42/lyco-ai-toolkit/releases （spine-render-v0.1.1）
export SPINE_RENDER_TOKEN=eyJ...
lyco-spine-render render skadi.atlas skadi.skel out.png \
    --remote --animation Skill_1_Begin --time 0.5
lyco-spine-render animate skadi.atlas skadi.skel out.gif \
    --remote --animation Idle --frames 24 --fps 12
# 不加 --remote 则为完全本地的免费渲染

5 · 桌面客户端（lyco-spine-viewer）

# Windows 桌面应用（exe / MSI 安装包，含图形界面）
https://github.com/lilyco-42/lyco-ai-toolkit/releases/tag/v0.3.3

# 本地预览与导出永远免费；填好令牌后，界面里的
# 「云端单帧 (5分)」「云端 GIF (20分)」按钮会把素材送到本服务计费渲染，
# 产物写到骨架文件同目录。余额不足时会提示充值档位与入口。

充值

10 积分 = 1 元。注册即送 25 积分；用完后按档位充值，付款自动到账。

积分档位

¥1 / 5 / 6 / 10 / 30 / 45 / 100 / 200 / 300 / 1000

对应 10 / 50 / 60 / 100 / 300 / 450 / 1000 / 2000 / 3000 / 10000 积分。支持支付宝与微信（经爱发电安全支付）。

自动到账

付款后约 1 分钟入账

下单后跳转支付，到账自动完成；可在账户内主动查单。充值积分不可提现，仅用于消费服务。

curl -s -X POST https://lain42.top/studio/api/payments/afdian/intents \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"product":"points_cny_10","reference":"my-recharge-001"}'
# -> {"checkout_url":"https://afdian.com/order/create?...", "points_credit":100}

为什么用托管渲染

免环境

不用装运行时、不用处理图集依赖；上传素材即刻出图，服务器直出透明底 PNG/GIF。

为 agent 而生

JSON 协议 + MCP 端点，模型可自行判断动画名、渲染并结算，无需人工点按。

结果可预期

失败不扣费、重试幂等、余额与账单实时可查；定价与限额公开透明。

把骨骼动画渲染成 PNG / GIF，按次计费，agent 可直接调用。