Skip to main content
PiAPI
Workspace
PiAPI

Resources

CLIAPI DocsBilling
Credits$—
Theme

3d models

Skin Tokens API

Việc tạo nhân vật bằng tay là một công việc chuyên môn chậm chạp. Mã thông báo Skin thực hiện điều đó một cách tự động: gửi lưới ký tự GLB và nhận lại GLB đã được trang bị với bộ xương vừa vặn và trọng lượng lột da trên mỗi đỉnh — $0.30 cho mỗi nhiệm vụ, không có trình gian lận trong vòng lặp.

Bắt đầu ngay!

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.

Get Started
API docsFull pricing

What Skin Tokens Does

làm những loại Skin Token nào Một điểm cuối, một công việc: biến lưới tĩnh thành lưới có thể hoạt hình.

Rigging không cần Rigger

Gửi lưới ký tự 3D và Skin Token phù hợp với bộ xương và giải quyết các trọng số lột da trên mỗi đỉnh cho bạn. Lưới có dạng tĩnh sẽ có thể hoạt hình mà không cần quá trình gian lận thủ công.

GLB Vào, GLB Ra

Đầu vào là một nhị phân glTF 2.0 (GLB) hợp lệ có tối đa các tam giác 80,000, được cung cấp dưới dạng URL có thể truy cập công khai hoặc URI dữ liệu base64. Phản hồi trả về một GLB được gian lận ở đầu ra.model_file chứa lưới ban đầu, khung được trang bị và trọng lượng lột da.

Flat $0.30 mỗi nhiệm vụ

Mọi nhiệm vụ giàn khoan đều có chi phí như nhau bất kể lưới phức tạp đến mức nào, do đó, chi phí trang bị toàn bộ thư viện ký tự có thể dự đoán được trước khi bạn bắt đầu.

Không đồng bộ theo thiết kế

Tạo một tác vụ, sau đó thăm dò điểm cuối tìm nạp cho đến khi nó đạt đến trạng thái cuối. Không có gì chặn chuỗi yêu cầu của bạn trong khi lưới đang được xử lý. Thông báo Webhook

Webhook Notifications

Cung cấp config.webhook_config.endpoint và một bí mật tùy chọn để nhận lệnh gọi lại khi một tác vụ hoàn thành hoặc không thành công. Loại bỏ các lệnh gọi lại trùng lặp theo task_id và tìm nạp tác vụ để xác nhận trạng thái cuối cùng.

Mã định danh khớp ổn định

Khớp xương sử dụng mã định danh từ xương_0 đến xương_N ổn định không có nhãn ngữ nghĩa, giúp việc đặt tên và nhắm mục tiêu lại theo hình người dưới sự kiểm soát của đường ống của riêng bạn thay vì đoán theo quy ước.

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

Câu hỏi thường gặp

Skin Token API là gì?

Skin Token tự động tạo lưới ký tự 3D. Bạn gửi lưới GLB và nhận được GLB được trang bị chứa lưới ban đầu, khung vừa vặn và trọng lượng gọt vỏ trên mỗi đỉnh.

Tôi có thể gửi lưới gì?

Một nhị phân glTF 2.0 hợp lệ (GLB) không quá các tam giác 80,000, được cung cấp dưới dạng URL có thể truy cập công khai hoặc dưới dạng URI dữ liệu base64. Một lưới hình người sạch sẽ ở tư thế trung lập thường tạo ra giàn khoan đáng tin cậy nhất.

Giá bao nhiêu?

$0.30 cho mỗi nhiệm vụ giàn khoan.

Các xương có được đặt tên không?

Số Các khớp xương sử dụng các định danh xương_0 ổn định đến xương_N mà không có nhãn ngữ nghĩa. Nếu quy trình của bạn cần xương hình người được đặt tên, hãy ánh xạ chúng trong bước nhắm mục tiêu lại của riêng bạn.

API có đồng bộ không?

No. Rigging là một tác vụ không đồng bộ: tạo tác vụ, sau đó thăm dò điểm cuối tìm nạp cho đến khi nó đạt đến trạng thái cuối. Bạn cũng có thể đăng ký webhook để được thông báo khi tác vụ hoàn thành hoặc không thành công.

Tham số hạt giống có tác dụng gì? Hạt giống

là tùy chọn và mặc định là -1, sử dụng hạt giống ngẫu nhiên. Đặt nó thành một giá trị cố định khi bạn muốn có kết quả lặp lại cho cùng một lưới đầu vào.

Điều gì xảy ra nếu một tác vụ thất bại?

Tác vụ đạt đến trạng thái không thành công ở thiết bị đầu cuối. Bạn có thể quan sát thấy trạng thái này bằng cách thăm dò điểm cuối tìm nạp hoặc thông qua webhook của mình. Tìm nạp tác vụ để xác nhận trạng thái cuối cùng trước khi thử lại.

More questions? See the API docs.