Akıllı UV

POST /v3/mesh/uv

Bir 3D modelin UV’lerini yeniden açar ve mevcut dokuları, rigging’i ve animasyonları yeni düzene eşler.

Her görev 20 kredidir. Sonuçta model_url ve UV düzeni önizlemesi uv_render_url bulunur. Giriş modeli 80.000 eşdeğer üçgeni aşmamalıdır (bir dörtgen iki sayılır); daha büyük modeller oluşturma sırasında kabul edilir ancak görev başarısız olur ve krediler iade edilir.

İ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	—	Model kaynağı. task_id, file_token veya URL kabul eder
model	dize	Hayır	`default`	Akıllı UV model sürümü. Yalnızca `default` desteklenir
bake	boolean	Hayır	`true`	Mevcut dokuları yeni UV düzenine bake eder. `false` ise yalnızca UV’li geometri döndürülür
export_orientation	dize	Hayır	—	Dışa aktarılan modelin yönü: `+x`, `-x`, `+y` veya `-y`
compress	dize	Hayır	—	Sıkıştırma türü. `geometry`: meshopt sıkıştırması

Örnekler İste

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

import requests

url = "https://openapi.tripo3d.ai/v3/mesh/uv"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "bake": True
}

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

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

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

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	İlerlemeyi ve sonucu sorgulamak için benzersiz görev kimliği

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	1004	Geçersiz parametre veya giriş	Parametre adlarını, değerleri ve giriş kaynağını kontrol edin
403	2010	Yetersiz kredi	Kredileri şarj edin ve yeniden deneyin