Auto-Rigmesh2rig
$0.30
Rig one GLB character mesh, up to 80,000 triangles.
Skin Tokens API
Riorganizzare un personaggio manualmente è un lavoro lento e specialistico. Skin Tokens lo fa automaticamente: invia una mesh di personaggi GLB e ricevi uno GLB truccato con uno scheletro adattato e pesi per la skin per vertice: $0.30 per attività, nessun rigger nel ciclo.
Skin Tokens API Pricing
Pay-as-you-go access through PiAPI.
Cosa fanno i token skin
Un endpoint, un lavoro: trasformare una mesh statica in una mesh animabile.
Rigging senza rigger
Invia una mesh di personaggi 3D e i token skin si adattano a uno scheletro e risolvono i pesi di skinning per vertice per te. Una mesh arrivata statica lascia animabile, senza passaggio di rigging manuale.
GLB Ingresso, GLB Uscita
L'input è un file binario glTF 2.0 (GLB) valido contenente fino a triangoli 80,000, fornito come URL accessibile pubblicamente o URI di dati base64. La risposta restituisce un GLB truccato in output.model_file contenente la mesh originale, lo scheletro adattato e i pesi di skinning.
Piatto $0.30 Per attività
Ogni attività di rigging costa lo stesso indipendentemente da quanto sia complessa la mesh, quindi il costo del rigging di un'intera libreria di personaggi è prevedibile prima di iniziare.
Asincrono in base alla progettazione
Creare un'attività, quindi interrogare l'endpoint di recupero finché non raggiunge uno stato terminale. Niente blocca il thread di richiesta mentre viene elaborata una mesh.
Notifiche webhook
Fornisci config.webhook_config.endpoint e un segreto facoltativo per ricevere una richiamata quando un'attività viene completata o fallisce. Deduplica i callback per task_id e recupera l'attività per confermare lo stato finale.
Identificatori di giunti stabili
I giunti scheletrici utilizzano identificatori stabili da bone_0 a bone_N senza etichette semantiche, che mantengono la denominazione e il retargeting umanoide sotto il controllo della propria pipeline anziché indovinare le convenzioni.
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/…
Domande frequenti
Che cosa sono i token skin API?
Skin Tokens monta automaticamente una mesh di personaggi 3D. Invii una mesh GLB e ricevi un GLB truccato contenente la mesh originale, uno scheletro adattato e pesi di skinning per vertice.
Che mesh posso inviare?
Un binario glTF 2.0 valido (GLB) di non più di triangoli 80,000, fornito come URL accessibile pubblicamente o come URI di dati base64. Una mesh umanoide pulita in una posa neutra generalmente produce l'attrezzatura più affidabile.
Quanto costa?
$0.30 per attività dell'attrezzatura.
Le ossa hanno un nome?
No. Le articolazioni scheletriche utilizzano identificatori stabili da bone_0 a bone_N senza etichette semantiche. Se la tua pipeline necessita di ossa umanoidi con nome, mappale nella tua fase di retargeting.
API è sincrono?
No. Il rigging è un'attività asincrona: crea l'attività, quindi esegui il polling dell'endpoint di recupero finché non raggiunge uno stato terminale. Puoi anche registrare un webhook per ricevere una notifica quando l'attività viene completata o fallisce.
Cosa fa il parametro seed? Il seme
è facoltativo e il valore predefinito è -1, che utilizza un seme casuale. Impostalo su un valore fisso quando desideri un risultato ripetibile per la stessa mesh di input.
Cosa succede se un'attività fallisce?
L'attività raggiunge uno stato di errore del terminale, che puoi osservare eseguendo il polling dell'endpoint di recupero o tramite il webhook. Recupera l'attività per confermare lo stato finale prima di riprovare.
More questions? See the API docs.