Mesh Semantik Segmentasyonu

POST /v3/mesh/segment

3B model üzerinde anlamsal bölümleme gerçekleştirin ve modeli otomatik olarak anlamsal parçalara bölün. v1 (geometri tabanlı, varsayılan) ve v2’yi (anlamsal etiketleme + geometri, Beta) destekler.

/v3/mesh/smartsegment ile farkı: bu API yalnızca mevcut modeli segmentlere ayırır. SmartSegment uçtan uca bir işlem hattıdır (varlık → otomatik modelleme → segmentasyon).

İ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_id, file_token veya URL’yi kabul eder
model	dize	Hayır	`v1.0-20250506`	Sürüm: `v1.0-20250506` (varsayılan) / `v2.0-20260430` (Beta)
segmentation_granularity	dize	Hayır	`balanced`	yalnızca v2. Ayrıntı düzeyi: `simple` / `balanced` / `detailed`
split_by_connectivity	boolean	Hayır	`true`	Yalnızca v2. Bağlı bileşenlere göre ayrılıp ayrılmayacağı
ref_image	dize	Hayır	—	Yalnızca v2. Referans resim: `file_token` veya URL. `ref_image` sağlandığında, `segmentation_granularity` ve `split_by_connectivity` dikkate alınmaz

v1 vs v2

Boyut	v1 (`v1.0-20250506`)	v2 (`v2.0-20260430`, Beta)
Yöntem	Geometri / topoloji	Anlamsal etiketleme + geometri
`segmentation_granularity`	Desteklenmiyor	`simple` / `balanced` / `detailed`
`split_by_connectivity`	Desteklenmiyor	Desteklenir, varsayılan `true`
`ref_image`	Desteklenmiyor (ayarlanmışsa hata)	İsteğe bağlı `file_token` veya URL

Örnekler İste

curl — v1 (varsayılan)

Bash

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

curl — v2 (parçacık modu)

Bash

curl -X POST https://openapi.tripo3d.ai/v3/mesh/segment \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "model": "v2.0-20260430",
    "input": "task_abc123",
    "segmentation_granularity": "balanced",
    "split_by_connectivity": true
  }'

curl — v2 (ref_image modu, ayrıntı düzeyi ve split_by_connectivity göz ardı edilir)

Bash

curl -X POST https://openapi.tripo3d.ai/v3/mesh/segment \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "model": "v2.0-20260430",
    "input": "task_abc123",
    "ref_image": "file_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/mesh/segment"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "model": "v2.0-20260430",
    "input": "task_abc123",
    "ref_image": "file_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

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

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

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    model: "v2.0-20260430",
    input: "task_abc123",
    ref_image: "file_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  })
});

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	Segmentasyon 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	1004	Geçersiz parametre (örn. v1 üzerinde ref_image)	Model sürümünü ve parametre kombinasyonunu onaylayın
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	Segmentasyona başlamadan önce kaynak görevin tamamlanmasını bekleyin
403	2010	Yetersiz kredi	Kredileri şarj edin ve yeniden deneyin