Auto-Rigmesh2rig
$0.30
Rig one GLB character mesh, up to 80,000 triangles.
Skin Tokens API
Montar um personagem manualmente é um trabalho especializado e lento. Skin Tokens faz isso automaticamente: envie uma malha de caracteres GLB e receba de volta um GLB equipado com um esqueleto ajustado e pesos de skinning por vértice - $0.30 por tarefa, sem rigger no loop.
Skin Tokens API Pricing
Pay-as-you-go access through PiAPI.
O que os tokens de skin fazem
Um endpoint, um trabalho: transformar uma malha estática em uma malha animável.
Rigging sem um Rigger
Envie uma malha de personagem 3D e os Skin Tokens se ajustam a um esqueleto e resolvem os pesos de skinning por vértice para você. Uma malha que chegou estática sai animável, sem passagem manual de rigging.
GLB Entrada, GLB Saída
A entrada é um binário glTF 2.0 válido (GLB) de até triângulos 80,000, fornecido como um URL publicamente acessível ou um URI de dados base64. A resposta retorna um GLB manipulado em output.model_file contendo a malha original, o esqueleto ajustado e os pesos de skinning.
Flat $0.30 Por tarefa
Cada tarefa de rig custa o mesmo, independentemente da complexidade da malha, portanto, o custo de rigging de uma biblioteca de caracteres inteira é previsível antes de começar.
Assíncrono por Design
Crie uma tarefa e, em seguida, pesquise o terminal de busca até que ele atinja um estado terminal. Nada bloqueia seu thread de solicitação enquanto uma malha está sendo processada. Notificações de webhook
Webhook Notifications
Forneça config.webhook_config.endpoint e um segredo opcional para receber um retorno de chamada quando uma tarefa for concluída ou falhar. Elimine a duplicação de retornos de chamada por task_id e busque a tarefa para confirmar o estado final.
Identificadores de junta estável
As juntas de esqueleto usam identificadores bone_0 estáveis até bone_N sem rótulos semânticos, o que mantém a nomenclatura e o redirecionamento humanóide sob o controle do seu próprio pipeline, em vez de adivinhar as convenções.
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/…
Perguntas frequentes
O que são os tokens de skin API?
Skin Tokens configura automaticamente uma malha de personagens 3D. Você envia uma malha GLB e recebe um GLB equipado contendo a malha original, um esqueleto ajustado e pesos de skinning por vértice.
Que malha posso enviar?
Um binário glTF 2.0 válido (GLB) de não mais que triângulos 80,000, fornecido como um URL publicamente acessível ou como um URI de dados base64. Uma malha humanóide limpa em uma pose neutra geralmente produz o equipamento mais confiável.
Quanto custa?
$0.30 por tarefa de plataforma.
Os ossos têm nome?
Não. As articulações do esqueleto usam identificadores bone_0 estáveis através de bone_N sem rótulos semânticos. Se o seu pipeline precisar de ossos humanóides nomeados, mapeie-os em sua própria etapa de retargeting.
O API é síncrono?
Não. Rigging é uma tarefa assíncrona: crie a tarefa e, em seguida, pesquise o endpoint de busca até atingir um estado terminal. Você também pode registrar um webhook para ser notificado quando a tarefa for concluída ou falhar.
O que o parâmetro inicial faz? A semente
é opcional e o padrão é -1, que usa uma semente aleatória. Defina-o com um valor fixo quando desejar um resultado repetível para a mesma malha de entrada.
O que acontece se uma tarefa falhar?
A tarefa atinge um estado de falha de terminal, que você observa pesquisando o endpoint de busca ou por meio de seu webhook. Busque a tarefa para confirmar o estado final antes de tentar novamente.
More questions? See the API docs.