Skip to main content
PiAPI
Workspace
PiAPI

Resources

CLIAPI DocsBilling
Credits$—
Theme

3d models

Skin Tokens API

キャラクターを手作業でリギングするのは、専門家の手間がかかる作業です。スキン トークンはこれを自動的に実行します。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

スキン トークンの機能

1 つのエンドポイント、1 つのジョブ: 静的メッシュをアニメーション化可能なメッシュに変換します。

リガーを使用しないリギング

3D キャラクター メッシュを送信すると、スキン トークンがスケルトンに適合し、頂点ごとのスキニング ウェイトを解決します。静的に到着したメッシュは、手動のリギング パスなしでアニメート可能になります。

GLB 入力、GLB 出力

入力は、パブリックにアクセス可能な URL または Base64 データ URI として指定される、最大 80、000 三角形の有効な glTF 2.0 バイナリ (GLB) です。応答は、元のメッシュ、フィットしたスケルトン、スキニング ウェイトを含むリグ付き GLB を出力.model_file に返します。

フラット $0.30 タスクごと

メッシュの複雑さに関係なく、すべてのリグ タスクのコストは同じであるため、キャラクタ ライブラリ全体のリグにかかる​​コストは開始前に予測できます。

設計により非同期

タスクを作成し、終了状態に達するまでフェッチ エンドポイントをポーリングします。メッシュの処理中、リクエスト スレッドをブロックするものは何もありません。

Webhook 通知

config.webhook_config.endpoint と、タスクが完了または失敗したときにコールバックを受信するためのオプションのシークレットを指定します。 task_id によってコールバックの重複を排除し、タスクをフェッチして最終状態を確認します。

安定したジョイント識別子

スケルトン ジョイントは、セマンティック ラベルのない安定したbone_0からbone_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 は同期ですか?

いいえ。リギングは非同期タスクです。タスクを作成し、終了状態に達するまでフェッチ エンドポイントをポーリングします。 Webhook を登録して、タスクが完了または失敗したときに通知を受け取ることもできます。

シード パラメータは何をしますか?

シードはオプションで、デフォルトは -1 で、ランダム シードが使用されます。同じ入力メッシュに対して再現可能な結果が必要な場合は、固定値に設定します。

タスクが失敗するとどうなりますか?

タスクは最終失敗状態に達します。これは、フェッチ エンドポイントをポーリングするか Webhook を通じて観察できます。再試行する前にタスクをフェッチして最終状態を確認します。

More questions? See the API docs.