Mesh Parça Tamamlama

POST /v3/mesh/complete

Bölümlere ayrılmış mesh parçalarını tamamlayın ve eksik bölgeleri onarı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	—	`task_` ile başlayan bir `mesh/segment` görevinin task_id’si
model	dize	Hayır	`v1.0-20250506`	Tamamlama modeli sürümü (mevcut tek sürüm)
part_names	dize[]	Hayır	Tüm parçalar	Tamamlanacak parça adlarının listesi. Atlanırsa tüm parçalar tamamlanır
completion_mode	dize	Hayır	`ai_completion`	Tamamlama modu: `ai_completion` (AI difüzyon tabanlı tamamlama, varsayılan) veya `quick_cap` (AI olmadan hızlı delik doldurma)

Örnekler İste

AI tamamlama (varsayılan)

curl -X POST https://openapi.tripo3d.ai/v3/mesh/complete \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "part_names": ["head", "body"]
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/mesh/complete"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "part_names": ["head", "body"]
}

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

const url = "https://openapi.tripo3d.ai/v3/mesh/complete";

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

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

Hızlı kapak

curl -X POST https://openapi.tripo3d.ai/v3/mesh/complete \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "completion_mode": "quick_cap"
  }'

payload = {
    "input": "task_abc123",
    "completion_mode": "quick_cap"
}

body: JSON.stringify({
  input: "task_abc123",
  completion_mode: "quick_cap"
})

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	Tamamlanma 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 `mesh/segment` görevine karşılık geldiğini doğrulayın
400	2007	Kaynak görev durumu başarılı değil	Tamamlamaya başlamadan önce kaynak görevin tamamlanmasını bekleyin
403	2010	Yetersiz kredi	Kredileri şarj edin ve yeniden deneyin