Otomatik Rigging

POST /v3/animations/rig

3D modele otomatik olarak bir iskelet rig’i ekleyin.

İstek Parametreleri

Başlıkları Talep Et

Parametre	Tür	Gerekli	Varsayılan	Açıklama
Content-Type	dize	Evet	—	`application/json`
Authorization	dize	Evet	—	`Bearer {api_key}`

Talep Gövdesi

Parametre	Tür	Gerekli	Varsayılan	Açıklama
input	dize	Evet	—	Modeli kaynağı. `task_` ile başlayan task_id veya `file_` ile başlayan file_token’yi kabul eder
model	dize	Hayır	`v1.0-20240301`	Otomatik rigging modeli sürümü. Olası değerler: `v1.0-20240301` (yalnızca iki ayaklı), `v2.5-20260210` (insansı olmayanlar; iki ayaklılar desteklenir ancak önerilmez), `v3.0-20260909` (insansılar için önerilir; açıkça belirtilmelidir; v2.5 ile aynı animasyon ön ayarları)
rig_type	dize	Hayır	`biped`	Rigging türü. Önerilen değeri almak için önce `rig-check`’yi aramanızı öneririz. Olası değerler: `biped`, `quadruped`, `hexapod`, `octopod`, `avian`, `serpentine`, `aquatic`, `others`
spec	dize	Hayır	`tripo`	Rigging spesifikasyonu. Yalnızca `rig_type` `biped` olduğunda geçerlidir. Olası değerler: `tripo`, `mixamo`, `actorcore`, `unity`, `unreal`, `vrm`
out_format	dize	Hayır	`glb`	Çıkış formatı. Olası değerler: `glb`, `fbx`

Örnekler İste

curl -X POST https://openapi.tripo3d.ai/v3/animations/rig \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "model": "v3.0-20260909",
    "rig_type": "biped",
    "spec": "mixamo",
    "out_format": "glb"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/animations/rig"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "model": "v3.0-20260909",
    "rig_type": "biped",
    "spec": "mixamo",
    "out_format": "glb"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/animations/rig";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    model: "v3.0-20260909",
    rig_type: "biped",
    spec: "mixamo",
    out_format: "glb"
  })
});

const data = await response.json();
console.log(data);

Yanıt

Başarılı Yanıt

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_def456"
  }
}

Yanıt Alanları

Parametre	Tür	Açıklama
code	tamsayı	Durum kodu. `0` başarıyı gösterir
data.task_id	dize	Otomatik rigging ilerlemesini ve sonucunu yoklamak için kullanılan benzersiz görev tanımlayıcı

Hata Kodları

HTTP Durum Kodu	Hata Kodu	Açıklama	Tavsiye
429	2000	Üretim sınırı aşıldı	İstek oranını azaltın ve daha sonra yeniden deneyin
400	2002	Desteklenmeyen istek parametresi	İstek gövdesi parametre adlarını ve değer aralıklarını kontrol edin
400	2006	Geçersiz giriş kaynağı görev türü	task_id’nin bir 3D model görevine karşılık geldiğini doğrulayın
400	2007	Kaynak görev durumu başarılı değil	Otomatik rigging’e başlamadan önce kaynak görevin tamamlanmasını bekleyin
403	2010	Yetersiz kredi	Kredileri şarj edin ve yeniden deneyin