Skin Tokens

Overview

Skin Tokens automatically rigs a 3D character mesh. Submit a GLB mesh and receive a rigged GLB with a skeleton and per-vertex skinning weights.

This is an asynchronous task: create a task, then poll the fetch endpoint until the task reaches a terminal state.

Input requirements

model must be Qubico/skin-tokens.

task_type must be rig.

input.model must be a valid glTF 2.0 binary (GLB), provided as a publicly accessible URL or a base64 data URI.

The input mesh must not exceed 80,000 triangles.

A clean humanoid mesh in a neutral pose generally produces the most reliable rig.

Output

When the task is complete, output.model_file contains a URL for the rigged GLB. The output contains the original mesh, a fitted skeleton, and skinning weights. Skeleton joints use stable bone_0 through bone_N identifiers without semantic labels.

Webhook notifications

You may provide config.webhook_config.endpoint and config.webhook_config.secret to receive a callback when the task reaches completed or failed. De-duplicate callbacks by task_id and fetch the task to confirm the final state.

Billing

$0.30 per rig task.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "model": "Qubico/skin-tokens",
    "task_type": "rig",
    "input": {
        "model": "https://example.com/models/your-character.glb",
        "seed": 42
    },
    "config": {
        "webhook_config": {
            "endpoint": "https://your-server.com/webhook/skin-tokens",
            "secret": "your-shared-secret"
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "code": 200,
    "data": {
        "task_id": "900340d8-766d-4a78-b721-3417461ed9dd",
        "model": "Qubico/skin-tokens",
        "task_type": "rig",
        "status": "pending",
        "input": {
            "model": "https://example.com/models/your-character.glb",
            "seed": -1
        },
        "output": null,
        "meta": {
            "created_at": "2026-08-19T02:53:31Z"
        },
        "error": {
            "code": 0,
            "message": ""
        }
    },
    "message": "success"
}

Overview#

Input requirements#

Output#

Webhook notifications#

Billing#