Auto-Rigmesh2rig
$0.30
Rig one GLB character mesh, up to 80,000 triangles.
Skin Tokens API
Создание персонажа вручную — это медленная работа специалиста. Skin Tokens делает это автоматически: отправляет сетку символов GLB и возвращает настроенный GLB с установленным скелетом и весами скининга для каждой вершины — $0.30 на задачу, без риггера в цикле.
Skin Tokens API Pricing
Pay-as-you-go access through PiAPI.
Что делают токены скинов
Одна конечная точка, одна задача: превратить статическую сетку в анимационную.
Оснастка без риггера
Отправьте трехмерную сетку персонажа, а Skin Tokens соответствует скелету и определяет веса скининга для каждой вершины. Меш, статический, остается анимируемым без необходимости ручной настройки.
GLB Вход, GLB Выход
Входные данные представляют собой действительный двоичный файл glTF 2.0 (GLB), содержащий до 80, 000 треугольников, заданный как общедоступный URL или URI данных в формате Base64. Ответ возвращает оснащенный GLB в файле output.model_file, содержащий исходную сетку, подогнанный скелет и веса скиннинга.
Плоский $0.30 за задачу
Каждая задача оснастки стоит одинаково, независимо от сложности сетки, поэтому стоимость оснастки всей библиотеки персонажей можно предсказать еще до ее начала.
Асинхронный дизайн
Создайте задачу, затем опрашивайте конечную точку выборки, пока она не достигнет состояния терминала. Ничто не блокирует ваш поток запросов во время обработки сетки.
Уведомления веб-перехватчика
Укажите config.webhook_config.endpoint и необязательный секретный ключ для получения обратного вызова при завершении или сбое задачи. Устраните дубликаты обратных вызовов по идентификатору задачи и получите задачу для подтверждения конечного состояния.
Стабильные идентификаторы суставов
Скелетные суставы используют стабильные идентификаторы от костей от костей_0 до костей_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" }curl 'https://api.piapi.ai/api/v1/task/{task_id}' \
-H 'X-API-Key: YOUR_API_KEY'
# poll until status = completed
{
"data": {
"status": "completed",
"output": {
"model_file": "https://img.theapi.app/ephemeral/…"
}
}
}$ npm install -g piapi-cli $ piapi run skin-tokens-api \ model=YOUR_GLB_URL \ seed=-1 \ bone_names=original ✓ Task completed! https://img.theapi.app/ephemeral/…
Часто задаваемые вопросы
Что такое скин-токены API?
Skin Tokens автоматически создает трехмерную сетку персонажей. Вы отправляете сетку GLB и получаете оснащенную GLB, содержащую исходную сетку, подогнанный скелет и веса скининга для каждой вершины.
Какую сетку я могу отправить?
Действительный двоичный файл glTF 2.0 (GLB), содержащий не более треугольников 80, 000, предоставленный либо в виде общедоступного URL, либо в виде URI данных в формате Base64. Чистая гуманоидная сетка в нейтральной позе обычно дает наиболее надежный риг.
Сколько это стоит?
$0.30 для каждой задачи буровой установки.
Есть ли у костей названия?
Нет. В суставах скелета используются идентификаторы от кости_0 до кости_N без семантических меток. Если вашему конвейеру нужны именованные кости гуманоидов, сопоставьте их на своем этапе ретаргетинга.
Синхронен ли API?
Нет. Оснащение — это асинхронная задача: создайте задачу, затем опрашивайте конечную точку выборки, пока она не достигнет состояния терминала. Вы также можете зарегистрировать веб-перехватчик, который будет получать уведомления о завершении или сбое задачи.
Что делает параметр начального числа? Начальное значение
является необязательным и по умолчанию имеет значение -1, которое использует случайное начальное значение. Установите фиксированное значение, если вы хотите получить повторяемый результат для одной и той же входной сетки.
Что произойдет, если задача не удастся выполнить?
Задача достигает состояния сбоя терминала, которое можно наблюдать либо путем опроса конечной точки выборки, либо через веб-перехватчик. Получите задачу, чтобы подтвердить окончательное состояние перед повторной попыткой.
More questions? See the API docs.