Auto-Rigmesh2rig
$0.30
Rig one GLB character mesh, up to 80,000 triangles.
Skin Tokens API
손으로 캐릭터를 리깅하는 것은 전문적인 작업으로 시간이 많이 소요됩니다. 스킨 토큰은 이 작업을 자동으로 수행합니다. GLB 캐릭터 메시를 보내고 적합한 뼈대와 정점별 스키닝 가중치를 사용하여 조작된 GLB를 다시 가져옵니다. 작업당 $0.30, 루프에는 리거가 없습니다.
Skin Tokens API Pricing
Pay-as-you-go access through PiAPI.
스킨 토큰이 수행하는 작업
하나의 끝점, 하나의 작업: 정적 메쉬를 애니메이션 가능한 메쉬로 전환합니다.
리거 없이 리깅하기
3D 캐릭터 메시를 제출하면 스킨 토큰이 뼈대에 맞춰지고 버텍스당 스키닝 가중치를 해결해 줍니다. 정적 상태로 도착한 메시는 수동 리깅 패스 없이 애니메이션이 가능합니다.
GLB 입력, GLB 출력
입력은 공개적으로 액세스 가능한 URL 또는 base64 데이터 URI로 제공되는 최대 80,000 삼각형의 유효한 glTF 2.0 바이너리(GLB)입니다. 응답은 원래 메시, 피팅된 뼈대 및 스키닝 가중치를 포함하는 출력.model_file에 조작된 GLB를 반환합니다.
플랫 $0.30 작업당
모든 리그 작업 비용은 메시의 복잡성에 관계없이 동일하므로 시작하기 전에 전체 캐릭터 라이브러리를 리깅하는 비용을 예측할 수 있습니다.
설계에 따른 비동기식
작업을 생성한 다음 터미널 상태에 도달할 때까지 가져오기 끝점을 폴링합니다. 메시가 처리되는 동안 요청 스레드를 차단하는 것은 없습니다.
웹훅 알림
작업이 완료되거나 실패할 때 콜백을 수신하려면 config.webhook_config.endpoint 및 선택적 비밀을 제공하세요. task_id별로 콜백을 중복 제거하고 작업을 가져와 최종 상태를 확인합니다.
안정적인 관절 식별자
뼈대 관절은 의미 체계 라벨이 없는 안정적인 뼈_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란 무엇입니까?
스킨 토큰은 3D 캐릭터 메시를 자동으로 조작합니다. GLB 메시를 제출하고 원본 메시, 적합한 뼈대 및 정점당 스키닝 가중치가 포함된 리깅된 GLB를 받습니다.
어떤 메시를 보낼 수 있나요?
80,000 삼각형 이하의 유효한 glTF 2.0 바이너리(GLB)는 공개적으로 액세스 가능한 URL 또는 base64 데이터 URI로 제공됩니다. 중립 자세의 깨끗한 휴머노이드 메시는 일반적으로 가장 안정적인 리그를 생성합니다.
비용은 얼마입니까? 장비 작업당
$0.30.
뼈 이름이 지정되어 있나요?
아니요. 뼈대 관절은 의미 라벨 없이 안정적인 뼈_0부터 뼈_N 식별자를 사용합니다. 파이프라인에 이름이 지정된 휴머노이드 뼈대가 필요한 경우 자체 대상 변경 단계에서 이를 매핑하세요.
API는 동기식입니까?
아니요. 리깅은 비동기 작업입니다. 작업을 생성한 다음 터미널 상태에 도달할 때까지 가져오기 끝점을 폴링합니다. 작업이 완료되거나 실패할 때 알림을 받도록 웹후크를 등록할 수도 있습니다.
시드 매개변수의 기능은 무엇입니까?
시드는 선택 사항이며 기본값은 무작위 시드를 사용하는 -1입니다. 동일한 입력 메시에 대해 반복 가능한 결과를 원할 경우 고정 값으로 설정하십시오.
작업이 실패하면 어떻게 됩니까?
작업이 터미널 실패 상태에 도달했으며, 이는 페치 엔드포인트를 폴링하거나 웹후크를 통해 관찰됩니다. 재시도하기 전에 작업을 가져와서 최종 상태를 확인하세요.
More questions? See the API docs.