Skip to main content
PiAPI
Workspace
PiAPI

Resources

CLIAPI DocsBilling
Credits$—
Theme

3d models

Skin Tokens API

手工操纵角色是一项缓慢的专业工作。 Skin Tokens 会自动执行此操作：发送 GLB 角色网格体，并返回带有装配骨架和每个顶点蒙皮权重的已装配 GLB - 每个任务 $0.30，循环中没有装配工。

立即开始！

Skin Tokens API Pricing

Pay-as-you-go access through PiAPI.

Auto-Rigmesh2rig

$0.30

Rig one GLB character mesh, up to 80,000 triangles.

Get Started
API docsFull pricing

皮肤令牌的用途

一个端点，一项工作：将静态网格物体转变为可动画网格物体。

无需绑定器进行绑定

提交 3D 角色网格，蒙皮令牌适合骨架并为您解决每个顶点蒙皮权重。静态网格体可进行动画处理，无需手动装配通道。

GLB 输入，GLB 输出

输入是最多 80、000 三角形的有效 glTF 2.0 二进制 (GLB)，以可公开访问的 URL 或 base64 数据 URI 形式给出。响应在 output.model_file 处返回一个装配好的 GLB，其中包含原始网格、拟合骨架和蒙皮权重。

Flat $0.30 每个任务

无论网格有多复杂，每个装备任务的成本都是相同的，因此在开始之前装备整个角色库的成本是可预测的。

设计异步

创建一个任务，然后轮询获取端点，直到它达到最终状态。在处理网格时，没有任何东西会阻止您的请求线程。

Webhook 通知

提供 config.webhook_config.endpoint 和一个可选的密钥，以便在任务完成或失败时接收回调。通过task_id去重复回调并获取任务以确认最终状态。

稳定的关节标识符

骨骼关节使用稳定的骨头_0 到骨头_N 标识符，没有语义标签，这使命名和人形重定向处于您自己的管道的控制之下，而不是猜测约定。

Get started

Create your API key

Sign up and grab an API key from the PiAPI workspace — free credits are included on sign-up.

Top up credits

Add credits on the billing page when you are ready to scale beyond the free tier.

Call the API

POST your first task following the API docs, then poll the task until the result is ready.

Iterate in the playground

Prototype prompts and settings in the the playground above before wiring them into your product.

curl -X POST 'https://api.piapi.ai/api/v1/task' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "Qubico/skin-tokens",
    "task_type": "rig",
    "input": {
      "model": "YOUR_GLB_URL",
      "seed": -1,
      "bone_names": "original"
    }
  }'

# → { "task_id": "9d5a…", "status": "pending" }

常见问题

什么是皮肤代币 API？

皮肤令牌自动装配 3D 角色网格。您提交 GLB 网格体并收到一个已装配的 GLB，其中包含原始网格体、拟合骨架和每个顶点蒙皮权重。

我可以发送什么网格？

不超过 80、000 三角形的有效 glTF 2.0 二进制 (GLB)，以可公开访问的 URL 或 base64 数据 URI 的形式提供。处于中立姿势的干净的人形网格通常会产生最可靠的装备。

多少钱？

$0.30 每个装备任务。

骨头有名字吗？

否。骨骼关节使用稳定的bone_0 到bone_N 标识符，没有语义标签。如果您的管道需要命名人形骨骼，请在您自己的重定向步骤中映射它们。

API是否同步？

否。 Rigging 是一项异步任务：创建任务，然后轮询获取端点，直到达到最终状态。您还可以注册一个 Webhook，以便在任务完成或失败时收到通知。

种子参数有什么作用？

种子是可选的，默认为 -1，它使用随机种子。当您希望同一输入网格获得可重复的结果时，请将其设置为固定值。

如果任务失败会发生什么？

任务达到终端失败状态，您可以通过轮询获取端点或通过 Webhook 观察到该状态。重试之前获取任务以确认最终状态。

More questions? See the API docs.