Model Yeniden Dokulandırma

POST /v3/models/texture

Mevcut bir model için doku haritalarını yeniden oluşturun.

İ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, `file_` ile başlayan bir file_token veya `http(s)://` ile başlayan bir URL’yi kabul eder
model	dize	Hayır	`v3.0-20250812`	Doku modeli sürümü. Desteklenen değerler: `v3.5-20260815`, `v3.0-20250812`, `v2.5-20250123`
texture_seed	tamsayı	Hayır	Rastgele	Doku üretimi için rastgele tohum
texture_quality	dize	Hayır	`standard`	Doku kalitesi. Mevcut değerler: `fast` (`model=v3.5-20260815` gerektirir), `standard`, `detailed`, `extreme`
pbr	boolean	Hayır	`true`	PBR malzemelerini etkinleştir
delight	boolean	Hayır	`true`	Dokulandırmadan önce referans görüntüdeki pişmiş aydınlatmayı kaldırır. Yalnızca `model=v3.5-20260815` olduğunda dikkate alınır

Örnekler İste

curl -X POST https://openapi.tripo3d.ai/v3/models/texture \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "texture_quality": "detailed",
    "pbr": true
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/models/texture"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "texture_quality": "detailed",
    "pbr": True
}

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

const url = "https://openapi.tripo3d.ai/v3/models/texture";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    texture_quality: "detailed",
    pbr: 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	Oluşturma ilerlemesini ve sonuçlarını sorgulamak 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 parametreleri	İ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` için görev türünün doğru olduğunu onaylayın
400	2007	Kaynak görevi başarıyla tamamlanmadı	Yeniden dokulandırmaya başlamadan önce kaynak görevin tamamlanmasını bekleyin
403	2010	Yetersiz kredi	Kredileri tamamlayın ve yeniden deneyin