Rigging Uyumluluk Kontrolü

POST /v3/animations/rig-check

Bir modele rigging uygulanıp uygulanamayacağını kontrol edin ve önerilen rigging tipini döndürün.

İ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 bir task_id’yi, `file_` ile başlayan bir file_token’yi veya genel erişime açık bir model dosyası URL’sini kabul eder. Desteklenen biçimler: GLB, FBX, OBJ, STL (maks. 150 MB).

Örnekler İste

curl -X POST https://openapi.tripo3d.ai/v3/animations/rig-check \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/animations/rig-check"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123"
}

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

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

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123"
  })
});

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

Yanıt

Başarılı Yanıt

JSON

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

Görev Tamamlandıktan Sonra Çıktı

JSON

{
  "riggable": true,
  "rig_type": "biped"
}

Yanıt Alanları

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

çıktı Alanları

Parametre	Tür	Açıklama
riggable	boolean	Modele rigging uygulanıp uygulanamayacağı
rig_type	dize	Önerilen rigging türü. Olası değerler: `biped` (iki ayaklı), `quadruped` (dört ayaklı), `hexapod` (altı ayaklı), `octopod` (ahtapot), `avian` (kuş), `serpentine` (yılan gibi), `aquatic` (su)

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	Denetime başlamadan önce kaynak görevin tamamlanmasını bekleyin
403	2010	Yetersiz kredi	Kredileri şarj edin ve yeniden deneyin