Skip to main content

3d models

Skin Tokens API

การประกอบตัวละครด้วยมือเป็นงานผู้เชี่ยวชาญที่ช้า Skin Tokens ดำเนินการโดยอัตโนมัติ: ส่ง GLB character mesh และรับ GLB ที่หุ้มไว้กลับมาพร้อมกับโครงกระดูกที่พอดีและน้ำหนักสกินต่อจุดยอด — $0.30 ต่องาน ไม่มี rigger ในลูป

เริ่มต้นเลย!

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.

Skin Token ทำอะไรบ้าง

จุดสิ้นสุดหนึ่งจุด หนึ่งงาน: เปลี่ยนเมชแบบคงที่ให้เป็นเมชแบบเคลื่อนไหวได้

Rigging โดยไม่ต้องใช้ Rigger

ส่งตาข่ายตัวละคร 3 มิติและโทเค็นสกินที่เหมาะกับโครงกระดูกและแก้ปัญหาน้ำหนักสกินนิ่งต่อจุดยอดสำหรับคุณ ตาข่ายที่มาถึงแบบคงที่ทำให้สามารถเคลื่อนไหวได้ โดยไม่ต้องผ่านเสื้อผ้าแบบแมนนวล

GLB เข้า, GLB ออก

อินพุตเป็นไบนารี glTF 2.0 (GLB) ที่ถูกต้องซึ่งมีขนาดไม่เกินสามเหลี่ยม 80,000 ซึ่งกำหนดให้เป็น URL ที่เข้าถึงได้แบบสาธารณะหรือ URI ข้อมูล base64 การตอบสนองจะส่งคืน GLB แบบหัวเรือใหญ่ที่ output.model_file ที่มีเมชดั้งเดิม โครงกระดูกที่พอดี และตุ้มน้ำหนักสกิน

Flat $0.30 ต่องาน

งาน rig ทุกงานมีราคาเท่ากันไม่ว่า mesh จะซับซ้อนแค่ไหน ดังนั้นจึงสามารถคาดเดาต้นทุนของ rigging ไลบรารีอักขระทั้งหมดได้ก่อนที่คุณจะเริ่มงาน

อะซิงโครนัสโดยการออกแบบ

สร้างงาน จากนั้นสำรวจจุดสิ้นสุดการดึงข้อมูลจนกว่าจะถึงสถานะเทอร์มินัล ไม่มีสิ่งใดบล็อกเธรดคำขอของคุณในขณะที่กำลังประมวลผล mesh การแจ้งเตือน Webhook ของ

Webhook Notifications

จัดหา config.webhook_config.endpoint และความลับทางเลือกเพื่อรับการติดต่อกลับเมื่องานเสร็จสมบูรณ์หรือล้มเหลว ยกเลิกการเรียกกลับซ้ำโดย Task_id และดึงข้อมูลงานเพื่อยืนยันสถานะสุดท้าย ตัวระบุข้อต่อที่เสถียรของ

ข้อต่อโครงกระดูกของ

ใช้ตัวระบุกระดูกที่เสถียรถึง bone_N โดยไม่มีป้ายกำกับความหมาย ซึ่งจะทำให้การตั้งชื่อและการกำหนดเป้าหมายใหม่แบบฮิวแมนนอยด์อยู่ภายใต้การควบคุมของไปป์ไลน์ของคุณเอง แทนที่จะคาดเดาตามแบบแผน

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

คำถามที่พบบ่อย

Skin Token คืออะไร API

Skin Tokens จะสร้างตาข่ายอักขระ 3 มิติโดยอัตโนมัติ คุณส่งตาข่าย GLB และได้รับ GLB แบบหัวเรือที่มีตาข่ายดั้งเดิม โครงกระดูกที่พอดี และตุ้มน้ำหนักสกินต่อจุดยอด

ฉันสามารถส่งตาข่ายอะไรได้บ้าง?

ไบนารี glTF 2.0 ที่ถูกต้อง (GLB) มีค่าไม่เกินสามเหลี่ยม 80,000 ซึ่งจัดให้มีเป็น URL ที่เข้าถึงได้โดยสาธารณะหรือเป็น URI ข้อมูล base64 ตาข่ายรูปทรงคล้ายมนุษย์ที่สะอาดในท่าที่เป็นกลางโดยทั่วไปจะสร้างแท่นขุดเจาะที่น่าเชื่อถือที่สุด

ราคาเท่าไหร่คะ?

$0.30 ต่องานแท่นขุดเจาะ

กระดูกมีชื่อหรือไม่?

หมายเลข ข้อต่อโครงกระดูกใช้ bone_0 ที่เสถียรผ่านตัวระบุ bone_N โดยไม่มีป้ายกำกับความหมาย หากไปป์ไลน์ของคุณต้องการกระดูกรูปทรงคล้ายมนุษย์ ให้แมปกระดูกเหล่านั้นในขั้นตอนการกำหนดเป้าหมายใหม่ของคุณเอง

API ซิงโครนัสหรือไม่

ไม่ การ Rigging เป็นงานอะซิงโครนัส: สร้างงาน จากนั้นสำรวจจุดสิ้นสุดการดึงข้อมูลจนกว่าจะถึงสถานะเทอร์มินัล คุณยังสามารถลงทะเบียน webhook เพื่อรับการแจ้งเตือนเมื่องานเสร็จสมบูรณ์หรือล้มเหลว

พารามิเตอร์ seed ทำหน้าที่อะไร? เมล็ด

เป็นทางเลือกและมีค่าเริ่มต้นเป็น -1 ซึ่งใช้เมล็ดแบบสุ่ม ตั้งค่าเป็นค่าคงที่เมื่อคุณต้องการผลลัพธ์ที่ทำซ้ำได้สำหรับอินพุตเมชเดียวกัน

จะเกิดอะไรขึ้นหากงานล้มเหลว

งานเข้าถึงสถานะเทอร์มินัลล้มเหลว ซึ่งคุณสังเกตได้จากการสำรวจจุดสิ้นสุดการดึงข้อมูลหรือผ่าน webhook ของคุณ ดึงข้อมูลงานเพื่อยืนยันสถานะสุดท้ายก่อนที่จะลองอีกครั้ง

More questions? See the API docs.