Auto-Rigmesh2rig
$0.30
Rig one GLB character mesh, up to 80,000 triangles.
Skin Tokens API
Montar un personaje a mano es un trabajo lento y especializado. Skin Tokens lo hace automáticamente: envía una malla de personajes GLB y recupera un GLB manipulado con un esqueleto ajustado y pesos de skinning por vértice: $0.30 por tarea, sin rigger en el bucle.
Skin Tokens API Pricing
Pay-as-you-go access through PiAPI.
Qué hacen los Skin Tokens
Un punto final, un trabajo: convertir una malla estática en una animable.
Aparejo sin aparejador
Envíe una malla de personaje 3D y los tokens de aspecto se ajustan a un esqueleto y resuelven los pesos de revestimiento por vértice por usted. Una malla que llega estática sale animable, sin paso de rigging manual.
GLB Entrada, GLB Salida
La entrada es un binario glTF 2.0 válido (GLB) de hasta triángulos 80,000, proporcionado como un URL de acceso público o un URI de datos base64. La respuesta devuelve un GLB manipulado en output.model_file que contiene la malla original, el esqueleto ajustado y los pesos de revestimiento.
Plano $0.30 Por tarea
Cada tarea de montaje cuesta lo mismo independientemente de cuán compleja sea la malla, por lo que el costo de montar una biblioteca de caracteres completa es predecible antes de comenzar.
Asincrónico por diseño
Cree una tarea y luego sondee el punto final de recuperación hasta que alcance un estado terminal. Nada bloquea el hilo de su solicitud mientras se procesa una malla. Notificaciones de webhook
Webhook Notifications
Proporcione config.webhook_config.endpoint y un secreto opcional para recibir una devolución de llamada cuando una tarea se completa o falla. Elimina las devoluciones de llamadas duplicadas por task_id y recupera la tarea para confirmar el estado final. Identificadores de articulaciones estables
Las articulaciones esqueléticas
utilizan identificadores estables bone_0 a bone_N sin etiquetas semánticas, lo que mantiene los nombres y la reorientación humanoide bajo el control de su propio canal en lugar de adivinar las convenciones.
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/…
Preguntas frecuentes
¿Qué son los Skin Tokens API? Los tokens de aspecto
montan automáticamente una malla de personajes 3D. Usted envía una malla GLB y recibe un GLB manipulado que contiene la malla original, un esqueleto ajustado y pesos de revestimiento por vértice.
¿Qué malla puedo enviar?
Un binario glTF 2.0 válido (GLB) de no más de triángulos 80,000, proporcionado como un URL de acceso público o como un URI de datos base64. Una malla humanoide limpia en una pose neutral generalmente produce la plataforma más confiable.
¿Cuánto cuesta?
$0.30 por tarea de equipo.
¿Tienen nombre los huesos?
No. Las articulaciones del esqueleto utilizan identificadores estables bone_0 a bone_N sin etiquetas semánticas. Si su canalización necesita huesos humanoides con nombre, mapeelos en su propio paso de retargeting.
¿Está sincronizado el API?
No. La manipulación es una tarea asincrónica: cree la tarea, luego sondee el punto final de recuperación hasta que alcance un estado terminal. También puede registrar un webhook para recibir una notificación cuando la tarea se complete o falle.
¿Qué hace el parámetro semilla? La semilla
es opcional y su valor predeterminado es -1, que utiliza una semilla aleatoria. Configúrelo en un valor fijo cuando desee un resultado repetible para la misma malla de entrada.
¿Qué sucede si una tarea falla?
La tarea alcanza un estado de error en la terminal, que usted observa ya sea sondeando el punto final de recuperación o a través de su webhook. Obtenga la tarea para confirmar el estado final antes de volver a intentarlo.
More questions? See the API docs.