Skip to main content

3d models

Skin Tokens API

Монтаж персонажа вручну - повільна робота спеціаліста. Skin Tokens робить це автоматично: надішліть символьну сітку GLB і отримайте назад сфальсифікований GLB із підігнаним скелетом і вагою для кожного вершини — $0.30 за кожне завдання, жодного монтажника в циклі.

Почати!

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 Tokens

Одна кінцева точка, одне завдання: перетворіть статичну сітку на анімовану.

Такелаж без монтажника

Надішліть сітку 3D-персонажа, а жетони шкіри підходять для скелета та вирішують для вас ваги для кожної вершини. Сітка, яка прибула в статичному стані, залишається анімованою без проходу ручного монтажу.

GLB Вхід, GLB Вихід

Вхідні дані – це дійсний двійковий файл glTF 2.0 (GLB) із максимум трикутниками 80,000, наданий як загальнодоступний URL або URI даних base64. Відповідь повертає сфальсифікований GLB у файлі output.model_file, що містить оригінальну сітку, підігнаний скелет і ваги для зняття шкіри.

Flat $0.30 За завдання

Кожне завдання rig коштує однаково, незалежно від того, наскільки складною є сітка, тому вартість кріплення цілої бібліотеки символів можна передбачити ще до початку.

Асинхронний за дизайном

Створіть завдання, потім опитуйте кінцеву точку отримання, доки вона не досягне стану терміналу. Ніщо не блокує ваш потік запитів під час обробки сітки. Сповіщення

Webhook

Укажіть config.webhook_config.endpoint і необов’язковий секрет для отримання зворотного виклику, коли завдання завершується або не виконується. Видалити дублікати зворотних викликів за task_id і отримати завдання, щоб підтвердити остаточний стан. Стабільні ідентифікатори з’єднань

З’єднання скелетів

використовують стабільні ідентифікатори від bone_0 до 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" }

Часті запитання

Що таке токени шкіри API?

Skin Tokens автоматично створює 3D-сітку персонажа. Ви надсилаєте сітку GLB і отримуєте сфальсифіковану сітку GLB, яка містить оригінальну сітку, підігнаний скелет і обважнювачі для кожної вершини.

Яку сітку я можу надіслати?

Дійсний двійковий файл glTF 2.0 (GLB) із не більше трикутників 80,000, наданий як загальнодоступний URL або як URI даних base64. Чиста гуманоїдна сітка в нейтральній позі зазвичай дає найнадійнішу установку.

Скільки це коштує?

$0.30 на завдання установки.

Чи названі кістки?

Ні. З’єднання скелета використовують стабільні ідентифікатори bone_0–bone_N без семантичних позначок. Якщо ваш конвеєр потребує іменованих гуманоїдних кісток, відобразіть їх у власному кроці перенацілювання.

Чи є API синхронним?

Ні. Монтаж — це асинхронне завдання: створіть завдання, потім опитуйте кінцеву точку отримання, доки вона не досягне кінцевого стану. Ви також можете зареєструвати вебхук, щоб отримувати сповіщення про завершення чи невдачу завдання.

Що робить початковий параметр? Початкове число

є необов’язковим і за умовчанням має значення -1, яке використовує випадкове початкове значення. Встановіть його на фіксоване значення, якщо ви хочете отримати повторюваний результат для тієї самої вхідної сітки.

Що станеться, якщо завдання не вдасться?

Завдання досягає невдалого стану терміналу, який ви спостерігаєте шляхом опитування кінцевої точки отримання або через вебхук. Отримайте завдання, щоб підтвердити остаточний стан перед повторною спробою.

More questions? See the API docs.