Model Formatı Dönüştürme

POST /v3/models/convert

3B modeli başka bir formata dönüştü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

Temel Parametreler

Parametre	Tür	Gerekli	Varsayılan	Açıklama
input	dize	Evet	-	Modeli kaynağı. `task_` ile başlayan task_id veya `file_` ile başlayan file_token’yi kabul eder
format	dize	Evet	-	Hedef formatı. Mevcut değerler: `GLTF`, `USDZ`, `FBX`, `OBJ`, `STL`, `3MF`. 3MF: Tek renkli 3D.

Mesh Seçenekleri

Parametre	Tür	Gerekli	Varsayılan	Açıklama
quad	boolean	Hayır	`false`	Dörtlü yeniden işleme
force_symmetry	boolean	Hayır	`false`	Simetriyi zorla. Yalnızca `quad`, `true` olduğunda geçerlidir
face_limit	tamsayı	Hayır	-	Maksimum poligon sayısı. Atlanırsa orijinal yüz sayısı korunur
flatten_bottom	boolean	Hayır	`false`	Alt kısmı düzleştirin
flatten_bottom_threshold	şamandıra	Hayır	`0.01`	Düzleştirme derinliği eşiği

Doku Seçenekleri

Parametre	Tür	Gerekli	Varsayılan	Açıklama
texture_size	tamsayı	Hayır	`4096`	Doku boyutunu piksel cinsinden dağıt
texture_format	dize	Hayır	`JPEG`	Doku formatı. Mevcut değerler: `BMP`, `DPX`, `HDR`, `JPEG`, `PNG`, `TARGA`, `TIFF`, `WEBP`
bake	boolean	Hayır	`true`	Gelişmiş malzemeleri temel dokulara dönüştürün
pack_uv	boolean	Hayır	`false`	Tüm UV’leri birleşik bir düzende paketleyin
export_vertex_colors	boolean	Hayır	`false`	Köşe renklerini dahil edin. Yalnızca `OBJ` ve `GLTF` formatları için geçerlidir

Dışa Aktarma Seçenekleri

Parametre	Tür	Gerekli	Varsayılan	Açıklama
pivot_to_center_bottom	boolean	Hayır	`false`	Pivotu alt merkeze taşıyın
scale_factor	şamandıra	Hayır	`1`	Ölçek faktörü
with_animation	boolean	Hayır	`true`	İskelet ve animasyon verilerini dahil et
animate_in_place	boolean	Hayır	`false`	Yerinde animasyon
part_names	dize[]	Hayır	-	Mesh/segment verilerinden dışa aktarılacak parçaların adları
export_orientation	dize	Hayır	`+x`	İhracat yönlendirmesi. Mevcut değerler: `-x`, `-y`, `+y`
fbx_preset	dize	Hayır	`blender`	Uyumluluk için FBX ön ayarı. Mevcut değerler: `blender`, `3dsmax`, `mixamo`, `bake_scale`

Örnekler İste

curl -X POST https://openapi.tripo3d.ai/v3/models/convert \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "format": "FBX",
    "quad": true,
    "face_limit": 8000,
    "texture_size": 2048,
    "texture_format": "PNG",
    "pivot_to_center_bottom": true,
    "fbx_preset": "blender"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/models/convert"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "format": "FBX",
    "quad": True,
    "face_limit": 8000,
    "texture_size": 2048,
    "texture_format": "PNG",
    "pivot_to_center_bottom": True,
    "fbx_preset": "blender"
}

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

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

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    format: "FBX",
    quad: true,
    face_limit: 8000,
    texture_size: 2048,
    texture_format: "PNG",
    pivot_to_center_bottom: true,
    fbx_preset: "blender"
  })
});

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ı	Dönüştürmeye başlamadan önce kaynak görevin tamamlanmasını bekleyin
403	2010	Yetersiz kredi	Kredileri tamamlayın ve yeniden deneyin