Skip to main content

3d models

Skin Tokens API

Met de hand een personage optuigen is langzaam specialistisch werk. Skin Tokens doet het automatisch: stuur een GLB-karaktermesh en krijg een opgetuigde GLB terug met een passend skelet en per-vertex skinning-gewichten - $0.30 per taak, geen rigger in de lus.

Aan de slag!

Skin Tokens API Pricing

Pay-as-you-go access through PiAPI.

Auto-Rigmesh2rig

$0.30

Rig one GLB character mesh, up to 80,000 triangles.

Wat Skin Tokens doet

Eén eindpunt, één taak: verander een statische mesh in een animeerbare mesh.

Rigging zonder rigger

Dien een 3D-personagemesh en skintokens in die op een skelet passen en lossen de gewichten voor het villen per hoekpunt voor u op. Een gaas dat statisch is aangekomen, kan worden geanimeerd, zonder handmatige rigging-pas.

GLB In, GLB Uit

Invoer is een geldig binair glTF 2.0 binair getal (GLB) van maximaal 80,000-driehoeken, gegeven als een openbaar toegankelijke URL of een base64-gegevens-URI. Het antwoord retourneert een opgetuigde GLB op output.model_file met daarin de originele mesh, het passende skelet en de skinning-gewichten.

Flat $0.30 Per taak

Elke rig-taak kost hetzelfde, ongeacht hoe complex de mesh is, dus de kosten voor het riggen van een volledige karakterbibliotheek zijn voorspelbaar voordat u begint.

Asynchroon door ontwerp

Maak een taak en poll vervolgens het ophaaleindpunt totdat het een terminalstatus bereikt. Niets blokkeert uw verzoekthread terwijl een mesh wordt verwerkt.

Webhook-meldingen

Geef config.webhook_config.endpoint en een optioneel geheim op om teruggebeld te worden wanneer een taak is voltooid of mislukt. Ontdubbel callbacks op task_id en haal de taak op om de eindstatus te bevestigen.

Stabiele gewrichtsidentificatoren

Skeletgewrichten gebruiken stabiele bone_0 tot en met bone_N-identifiers zonder semantische labels, waardoor naamgeving en humanoïde retargeting onder de controle van uw eigen pijplijn blijven in plaats van te gissen naar conventies.

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" }

Veelgestelde vragen

Wat zijn de skintokens API?

Skin Tokens tuigt automatisch een 3D-karaktermesh op. U dient een GLB mesh in en ontvangt een opgetuigde GLB met de originele mesh, een passend skelet en per-vertex skinning-gewichten.

Welke mesh kan ik versturen?

Een geldige glTF 2.0 binair bestand (GLB) van niet meer dan 80,000-driehoeken, aangeboden als een openbaar toegankelijke URL of als een base64-gegevens-URI. Een schoon mensachtig gaas in een neutrale houding levert over het algemeen de meest betrouwbare uitrusting op.

Hoeveel kost het?

$0.30 per rigtaak.

Hebben de botten een naam?

Nee. Skeletgewrichten gebruiken stabiele identificaties van bone_0 tot en met bone_N zonder semantische labels. Als uw pijplijn humanoïde botten nodig heeft, breng deze dan in kaart in uw eigen retargetingstap.

Is de API synchroon?

Nee. Rigging is een asynchrone taak: maak de taak en poll vervolgens het ophaaleindpunt totdat het een terminalstatus bereikt. U kunt ook een webhook registreren, zodat u op de hoogte wordt gesteld wanneer de taak is voltooid of mislukt.

Wat doet de zaadparameter?

-zaad is optioneel en is standaard ingesteld op -1, dat een willekeurig zaad gebruikt. Stel deze in op een vaste waarde als u een herhaalbaar resultaat wilt voor hetzelfde invoergaas.

Wat gebeurt er als een taak mislukt?

De taak bereikt de status 'terminal mislukt', wat u kunt waarnemen door het ophaaleindpunt te pollen of via uw webhook. Haal de taak op om de eindstatus te bevestigen voordat u het opnieuw probeert.

More questions? See the API docs.