Auto-Rigmesh2rig
$0.30
Rig one GLB character mesh, up to 80,000 triangles.
Skin Tokens API
Einen Charakter von Hand zu manipulieren, ist eine langsame Spezialarbeit. Skin Tokens erledigt das automatisch: Senden Sie ein GLB-Charakternetz und erhalten Sie ein manipuliertes GLB mit einem angepassten Skelett und Skinning-Gewichten pro Scheitelpunkt zurück – $0.30 pro Aufgabe, kein Rigger in der Schleife.
Skin Tokens API Pricing
Pay-as-you-go access through PiAPI.
Was Skin-Tokens bewirken
Ein Endpunkt, ein Job: Verwandeln Sie ein statisches Netz in ein animierbares.
Rigging ohne Rigger
Senden Sie ein 3D-Charakternetz und Skin Tokens passt ein Skelett an und löst Skinning-Gewichte pro Scheitelpunkt für Sie. Ein Netz, das statisch angekommen ist, lässt sich animieren, ohne dass ein manueller Rigging-Vorgang erforderlich ist.
GLB Eingang, GLB Ausgang
Die Eingabe ist eine gültige glTF 2.0-Binärdatei (GLB) mit bis zu 80-, 000-Dreiecken, angegeben als öffentlich zugänglicher URL oder Base64-Daten-URI. Die Antwort gibt ein manipuliertes GLB in der Datei „output.model_file“ zurück, das das Originalnetz, das angepasste Skelett und die Skinning-Gewichte enthält.
Pauschal $0.30 pro Aufgabe
Jede Rig-Aufgabe kostet unabhängig von der Komplexität des Netzes das Gleiche, sodass die Kosten für das Rigging einer gesamten Charakterbibliothek vorhersehbar sind, bevor Sie beginnen.
Asynchron durch Design
Erstellen Sie eine Aufgabe und fragen Sie dann den Abrufendpunkt ab, bis er einen Endstatus erreicht. Nichts blockiert Ihren Anfragethread, während ein Mesh verarbeitet wird.
Webhook-Benachrichtigungen
Geben Sie config.webhook_config.endpoint und ein optionales Geheimnis an, um einen Rückruf zu erhalten, wenn eine Aufgabe abgeschlossen wird oder fehlschlägt. Deduplizieren Sie Rückrufe nach task_id und rufen Sie die Aufgabe ab, um den Endstatus zu bestätigen.
Stable Joint Identifiers
Skeleton Joints verwenden stabile Bone_0 bis Bone_N Identifikatoren ohne semantische Bezeichnungen, wodurch die Benennung und das humanoide Retargeting unter der Kontrolle Ihrer eigenen Pipeline bleibt, anstatt auf Konventionen zu raten.
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" }curl 'https://api.piapi.ai/api/v1/task/{task_id}' \
-H 'X-API-Key: YOUR_API_KEY'
# poll until status = completed
{
"data": {
"status": "completed",
"output": {
"model_file": "https://img.theapi.app/ephemeral/…"
}
}
}$ npm install -g piapi-cli $ piapi run skin-tokens-api \ model=YOUR_GLB_URL \ seed=-1 \ bone_names=original ✓ Task completed! https://img.theapi.app/ephemeral/…
Häufig gestellte Fragen
Was sind die Skin-Tokens API?
Skin Tokens manipuliert automatisch ein 3D-Charakternetz. Sie reichen ein GLB-Netz ein und erhalten ein manipuliertes GLB, das das Originalnetz, ein angepasstes Skelett und Skinning-Gewichte pro Scheitelpunkt enthält.
Welches Netz kann ich versenden?
Eine gültige glTF 2.0-Binärdatei (GLB) mit nicht mehr als 80-, 000-Dreiecken, bereitgestellt entweder als öffentlich zugänglicher URL oder als Base64-Daten-URI. Ein sauberes humanoides Netz in einer neutralen Pose ergibt im Allgemeinen das zuverlässigste Rig.
Wie viel kostet es?
$0.30 pro Rig-Aufgabe.
Sind die Knochen benannt?
Nein. Skelettgelenke verwenden stabile Bezeichner von Bone_0 bis Bone_N ohne semantische Bezeichnungen. Wenn Ihre Pipeline benannte humanoide Knochen benötigt, ordnen Sie diese in Ihrem eigenen Retargeting-Schritt zu.
Ist API synchron?
Nein. Rigging ist eine asynchrone Aufgabe: Erstellen Sie die Aufgabe und fragen Sie dann den Abrufendpunkt ab, bis er einen Endzustand erreicht. Sie können auch einen Webhook registrieren, um benachrichtigt zu werden, wenn die Aufgabe abgeschlossen ist oder fehlschlägt.
Was bewirkt der Seed-Parameter? Der
-Seed ist optional und wird standardmäßig auf -1 gesetzt, wobei ein zufälliger Seed verwendet wird. Legen Sie einen festen Wert fest, wenn Sie ein wiederholbares Ergebnis für dasselbe Eingabenetz wünschen.
Was passiert, wenn eine Aufgabe fehlschlägt?
Die Aufgabe erreicht einen Terminalfehlerstatus, den Sie entweder durch Abfragen des Abrufendpunkts oder über Ihren Webhook beobachten. Rufen Sie die Aufgabe ab, um den Endzustand zu bestätigen, bevor Sie es erneut versuchen.
More questions? See the API docs.