Auto-Rigmesh2rig
$0.30
Rig one GLB character mesh, up to 80,000 triangles.
Skin Tokens API
Ręczne ustawianie postaci to powolna, specjalistyczna praca. Skin Tokens robi to automatycznie: wyślij siatkę postaci GLB i odbierz uzbrojony GLB z dopasowanym szkieletem i obciążnikami skórującymi na wierzchołki — $0.30 na zadanie, bez riggera w pętli.
Skin Tokens API Pricing
Pay-as-you-go access through PiAPI.
Co robią tokeny skórek
Jeden punkt końcowy, jedno zadanie: przekształcenie statycznej siatki w animowaną.
Olinowanie bez riggera
Prześlij siatkę postaci 3D, a żetony skórek dopasowują się do szkieletu i rozwiązują za Ciebie ciężary skórowania poszczególnych wierzchołków. Siatka, która przybyła statycznie, pozostawia animację, bez ręcznego przejścia olinowania.
GLB wejście, GLB wyjście
Dane wejściowe to prawidłowy plik binarny glTF 2.0 (GLB) składający się z maksymalnie trójkątów 80, 000, podanych jako publicznie dostępny URL lub identyfikator URI danych base64. Odpowiedź zwraca sfałszowany plik GLB w pliku wynikowym.model_file, zawierający oryginalną siatkę, dopasowany szkielet i obciążniki skórowania.
Flat $0.30 na zadanie
Każde zadanie związane z platformą kosztuje tyle samo, niezależnie od tego, jak złożona jest siatka, więc koszt wyposażenia całej biblioteki postaci można przewidzieć przed rozpoczęciem.
Projekt asynchroniczny
Utwórz zadanie, a następnie odpytuj punkt końcowy pobierania, aż osiągnie stan terminala. Nic nie blokuje wątku żądania podczas przetwarzania siatki. Powiadomienia webhooka
Webhook Notifications
Podaj plik config.webhook_config.endpoint i opcjonalny klucz tajny, aby otrzymać wywołanie zwrotne po ukończeniu zadania lub niepowodzeniu. Usuń duplikaty wywołań zwrotnych według task_id i pobierz zadanie, aby potwierdzić stan końcowy.
Stabilne identyfikatory stawów
Połączenia szkieletowe wykorzystują stabilne identyfikatory od kości od 0 do kości_N bez etykiet semantycznych, dzięki czemu nazewnictwo i humanoidalne retargetowanie pozostają pod kontrolą własnego potoku, zamiast zgadywać według konwencji.
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/…
Często zadawane pytania
Co to są tokeny skórki API? Tokeny skórki
automatycznie tworzą siatkę postaci 3D. Przesyłasz siatkę GLB i otrzymujesz uzbrojoną siatkę GLB zawierającą oryginalną siatkę, dopasowany szkielet i obciążniki wierzchołkowe.
Jaką siatkę mogę wysłać?
Prawidłowy plik binarny glTF 2.0 (GLB) składający się z nie więcej niż trójkątów 80,000, dostarczany jako publicznie dostępny URL lub jako URI danych base64. Czysta humanoidalna siatka w neutralnej pozie generalnie daje najbardziej niezawodny zestaw.
Ile to kosztuje?
$0.30 na zadanie platformy.
Czy kości mają nazwy?
Nie. W stawach szkieletowych używane są stabilne identyfikatory „bone_0” do „bone_N” bez etykiet semantycznych. Jeśli Twój rurociąg potrzebuje nazwanych kości humanoidalnych, zmapuj je na własnym etapie retargetingu.
Czy API jest synchroniczny?
Nie. Rigging jest zadaniem asynchronicznym: utwórz zadanie, a następnie odpytuj punkt końcowy pobierania, aż osiągnie stan terminala. Możesz także zarejestrować webhooka, aby otrzymywać powiadomienia o zakończeniu zadania lub niepowodzeniu.
Do czego służy parametr nasion? Ziarno
jest opcjonalne i domyślnie wynosi -1, które wykorzystuje losowe ziarno. Ustaw tę wartość na stałą, jeśli chcesz uzyskać powtarzalny wynik dla tej samej siatki wejściowej.
Co się stanie, jeśli zadanie się nie powiedzie?
Zadanie osiąga stan awarii terminala, który można zaobserwować albo poprzez odpytywanie punktu końcowego pobierania, albo za pośrednictwem elementu webhook. Pobierz zadanie, aby potwierdzić stan końcowy przed ponowną próbą.
More questions? See the API docs.