Skip to main content

3d models

Skin Tokens API

Mencurangi karakter dengan tangan adalah pekerjaan spesialis yang lambat. Token Kulit melakukannya secara otomatis: mengirim mesh karakter GLB dan mendapatkan kembali GLB yang dilengkapi dengan kerangka yang terpasang dan bobot skinning per-vertex — $0.30 per tugas, tidak ada rigger dalam loop.

Mulai Sekarang!

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.

Apa Fungsi Token Skin

Satu titik akhir, satu tugas: mengubah mesh statis menjadi mesh yang dapat dianimasikan.

Rigging Tanpa Rigger

Kirimkan mesh karakter 3D dan Token Skin yang sesuai dengan kerangka dan selesaikan bobot skinning per vertex untuk Anda. Jaring yang datang secara statis membuat dapat dianimasikan, tanpa izin tali-temali manual.

GLB Masuk, GLB Keluar

Input adalah biner glTF 2.0 (GLB) yang valid hingga segitiga 80,000, diberikan sebagai URL atau URI data base64. Responsnya mengembalikan GLB yang dipasang di output.model_file yang berisi mesh asli, kerangka yang dipasang, dan bobot skinning.

Flat $0.30 Per Tugas

Setiap tugas rig memiliki biaya yang sama terlepas dari seberapa rumit meshnya, sehingga biaya untuk memasang seluruh perpustakaan karakter dapat diprediksi sebelum Anda memulai.

Asinkron menurut Desain

Buat tugas, lalu lakukan polling titik akhir pengambilan hingga mencapai status terminal. Tidak ada yang menghalangi thread permintaan Anda saat mesh sedang diproses. Pemberitahuan Webhook

Webhook Notifications

Menyediakan config.webhook_config.endpoint dan rahasia opsional untuk menerima panggilan balik ketika tugas selesai atau gagal. Hapus duplikat panggilan balik berdasarkan task_id dan ambil tugas untuk mengonfirmasi status akhir.

Pengidentifikasi Sambungan Stabil

Sambungan kerangka menggunakan pengidentifikasi bone_0 hingga bone_N yang stabil tanpa label semantik, yang membuat penamaan dan penargetan ulang humanoid tetap berada di bawah kendali saluran Anda sendiri, bukannya menebak-nebak konvensi.

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

Pertanyaan yang Sering Diajukan

Apa itu Skin Token API? Token Kulit

secara otomatis memasang jaring karakter 3D. Anda mengirimkan mesh GLB dan menerima GLB yang dilengkapi mesh asli, kerangka yang terpasang, dan bobot skinning per titik.

Jaring apa yang bisa saya kirim?

Biner glTF 2.0 yang valid (GLB) tidak lebih dari segitiga 80,000, disediakan baik sebagai URL yang dapat diakses publik atau sebagai URI data base64. Jaring humanoid yang bersih dalam pose netral umumnya menghasilkan rig yang paling andal.

Berapa biayanya?

$0.30 per tugas rig.

Apakah nama tulangnya?

No. Sambungan kerangka menggunakan pengidentifikasi bone_0 hingga bone_N yang stabil tanpa label semantik. Jika saluran pipa Anda memerlukan tulang humanoid yang diberi nama, petakan tulang tersebut dalam langkah penargetan ulang Anda sendiri.

Apakah API sinkron?

Tidak. Rigging adalah tugas asinkron: buat tugas, lalu lakukan polling pada titik akhir pengambilan hingga mencapai status terminal. Anda juga dapat mendaftarkan webhook untuk diberi tahu ketika tugas selesai atau gagal.

Apa fungsi parameter seed? Seed

bersifat opsional dan defaultnya adalah -1, yang menggunakan seed acak. Setel ke nilai tetap bila Anda menginginkan hasil berulang untuk jaring masukan yang sama.

Apa yang terjadi jika suatu tugas gagal?

Tugas mencapai status terminal gagal, yang Anda amati dengan melakukan polling pada titik akhir pengambilan atau melalui webhook Anda. Ambil tugas untuk mengonfirmasi keadaan akhir sebelum mencoba lagi.

More questions? See the API docs.