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 或 URIbase 形式給出資料。回應在 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)，以可公開存取的 ZXQPROTECTXZZ 或 URIbaseT處於中立姿勢的乾淨的人形網格通常會產生最可靠的裝備。 [URL]

多少錢？

$0.30 每個裝備任務。

骨頭有名字嗎？

否。骨骼關節使用穩定的bone_0 到bone_N 標識符，沒有語義標籤。如果您的管道需要命名人形骨骼，請在您自己的重定向步驟中將它們映射。

API是否同步？

否。 Rigging 是一項非同步任務：建立任務，然後輪詢取得端點，直到達到最終狀態。您也可以註冊一個 Webhook，以便在任務完成或失敗時收到通知。

種子參數有什麼作用？

種子是可選的，預設為 -1，它使用隨機種子。當您希望相同輸入網格獲得可重複的結果時，請將其設為固定值。

如果任務失敗會發生什麼事？

任務達到終端失敗狀態，您可以透過輪詢取得端點或透過 Webhook 觀察到該狀態。重試之前獲取任務以確認最終狀態。

More questions? See the API docs.