Skin Tokens-Get task

Overview

Retrieve the current status and result of a Skin Tokens rigging task using the task_id returned by the create endpoint. Poll this endpoint until the task reaches a terminal state.

Task states

pending: the task is queued.

processing: rigging is in progress.

completed: the rigged GLB URL is available at data.output.model_file.

failed: the task did not complete; inspect data.error.

Output

A completed task returns the original mesh with a fitted skeleton and skinning weights as a GLB. Skeleton joints use stable bone_0 through bone_N identifiers without semantic labels.

Billing

Fetching a task does not incur a separate task charge.

Responses

🟢200OK

application/json

OK-Successful Response

Bodyapplication/json

Example

{
    "code": 200,
    "data": {
        "task_id": "900340d8-766d-4a78-b721-3417461ed9dd",
        "model": "Qubico/skin-tokens",
        "task_type": "rig",
        "status": "completed",
        "input": {
            "model": "https://example.com/models/your-character.glb",
            "seed": -1
        },
        "output": {
            "model_file": "https://img.theapi.app/temp/58274ee0-5a98-404f-b84a-1aec4d85be21.glb"
        },
        "meta": {
            "created_at": "2026-08-19T02:53:31Z",
            "started_at": "2026-08-19T02:53:33Z",
            "ended_at": "2026-08-19T02:54:09Z"
        },
        "error": {
            "code": 0,
            "message": ""
        }
    },
    "message": "success"
}

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Skin Tokens-Get task

Overview#

Task states#

Output#

Billing#

Request

Request Code Samples

Responses

Overview

Task states

Output

Billing