Çoklu Görünümden 3D Modele

POST /v3/generation/multiview-to-model

Çoklu görünüm görüntülerinden bir 3D model 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}`

Parametre	Tür	Gerekli	Varsayılan	Açıklama
inputs	nesne[] \	dize[4]	Evet	-
model	dize	Hayır	`v3.1-20260211`	AI model sürümü. Desteklenen değerler: `v3.1-20260211` (varsayılan; en yeni, en iyi kalite), `v3.0-20250812` (kararlı, gelişmiş özellikler), `v2.5-20250123` (dengeli)
face_limit	tamsayı	Hayır	Uyarlanabilir	Çıkış için maksimum poligon sayısı
texture	boolean	Hayır	`true`	Doku haritalarını etkinleştir
pbr	boolean	Hayır	`true`	PBR malzemelerini etkinleştirin. Etkinleştirildiğinde, `texture`, `true`’ye zorlanır
texture_seed	tamsayı	Hayır	Rastgele	Doku üretimi için rastgele tohum
texture_quality	dize	Hayır	`standard`	Doku kalitesi. Desteklenen değerler: `fast` (`texture_version=v3.5-20260815` gerektirir), `standard`, `detailed`, `extreme`
texture_version	dize	Hayır	model’den türetilir	Doku modelini geometriden bağımsız olarak sabitler. Desteklenen değerler: `v3.5-20260815`, `v3.0-20250812`, `v2.5-20250123`. Belirtilmezse geometri `model` değerinden türetilir (v2.5 geometrisi → `v2.5-20250123`, aksi halde `v3.0-20250812`)
delight	boolean	Hayır	`true`	Dokulandırmadan önce referans görüntüdeki pişmiş aydınlatmayı kaldırır. Yalnızca `texture_version=v3.5-20260815` olduğunda dikkate alınır
geometry_quality	dize	Hayır	`standard`	Geometri kalitesi. `standard` (dengeli), `detailed` (Ultra mod)
auto_size	boolean	Hayır	`false`	Modeli metre cinsinden gerçek dünya boyutlarına otomatik olarak ölçeklendirin
quad	boolean	Hayır	`false`	Dörtlü bir mesh çıktısı alın. Etkinleştirildiğinde, çıkış formatı FBX olarak zorlanır
smart_low_poly	boolean	Hayır	`false`	El yapımı topoloji stiliyle düşük polikli bir model oluşturun
generate_parts	boolean	Hayır	`false`	Düzenlenebilir bölümlere ayrılmış parçalar oluşturun. `texture`, `pbr`, `quad` veya `smart_low_poly` ile uyumlu değil — aşağıdaki nota bakın
compress	dize	Hayır	-	Sıkıştırma türü. `geometry` (meshopt sıkıştırması)
export_orientation	dize	Hayır	`+x`	İhracat yönlendirmesi. Mevcut değerler: `-x`, `-y`, `+y`

generate_parts hakkında notlar:

texture, pbr, quad veya smart_low_poly ile uyumlu değildir:

texture=true veya pbr=true — varsayılan olarak true olan textureın atlanması dahil — istek 1004 hata koduyla reddedilir.
quad=true — quad yok sayılır; döndürülen parçalar üçgen ağlardır.
smart_low_poly=true — smart_low_poly önceliklidir ve parçalar üretilMEZ.

Parça üretmek için texture=false ve pbr=false ayarlayın ve quad veya smart_low_poly göndermeyin.

export_orientation hakkında notlar:

Yalnızca bu üretim için geçerlidir. Model sonraki işleme görevlerinde (doku, rig, yeniden hedefleme, dönüştürme, …) kullanılacaksa bu parametreyi ayarlamamanız önerilir.
Ayarlandığında, sonraki işleme modelin yanlış yönü nedeniyle nihai sonucu etkileyebilir, ancak görev yine de status: success bildirir — hata oluşmaz. Dikkatli kullanın.
Modeli sonradan işlemeyi planlıyorsanız bu parametreyi boş bırakın ve son adımda /v3/models/convert aracılığıyla yönü dönüştürün.

Aşağıdaki parametreler yalnızca model >= v3.0-20250812 olduğunda geçerlidir: texture_quality, geometry_quality, auto_size, quad, smart_low_poly, generate_parts, compress.

giriş formatları

görünüm anahtarı (önerilir)

Her dizi öğesi, front, left, back veya right arasında tam olarak bir anahtara sahip bir nesnedir. Sıra önemli değil; sunucu [front, left, back, right] olarak standart hale getirilir. front gereklidir; en az iki görünüm boş olmamalıdır.

URL’lerle:

JSON

{
  "inputs": [
    {"front": "https://example.com/front.png"},
    {"back": "https://example.com/back.png"},
    {"right": "https://example.com/right.png"}
  ],
  "model": "v3.1-20260211",
  "texture": false,
  "geometry_quality": "detailed"
}

file_tokens ile (API Yükleme Dosyası aracılığıyla elde edilir):

JSON

{
  "inputs": [
    {"front": "3154b4b0-4647-4032-aa82-827441ae92ef"},
    {"back": "58ea3eab-6a08-4deb-98f9-e60f1802954d"},
    {"right": "584b0e07-8576-4eb4-bf49-2e149e0252f6"}
  ],
  "model": "v3.1-20260211",
  "texture": false,
  "geometry_quality": "detailed"
}

eski konumsal

[front, left, back, right] sırasına göre tam olarak dört dize. Bir görünümü atlamak için boş bir "" dizesi kullanın.

JSON

{
  "inputs": [
    "file_front_token",
    "",
    "https://example.com/back.png",
    "https://example.com/right.png"
  ]
}

task_id (çoklu görüntüleme görevini yeniden kullanın)

3B oluşturma için 4 görünüm çıkışını yeniden kullanmak üzere önceki bir generate_multiview_image veya edit_multiview_image görevinin ID’sini iletin. inputs, bir task_id nesnesine sahip tek öğeli bir dizi olmalıdır; görünüm anahtarı veya konumsal yuvalarla karıştırmayın. Kaynak görev success durumunda olmalıdır.

JSON

{
  "inputs": [
    {"task_id": "550e8400-e29b-41d4-a716-446655440000"}
  ],
  "model": "v3.1-20260211",
  "texture": true,
  "pbr": true
}

Örnekler İste

curl -X POST https://openapi.tripo3d.ai/v3/generation/multiview-to-model \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "inputs": [
      "https://example.com/front.png",
      "https://example.com/back.png",
      "https://example.com/left.png",
      "https://example.com/right.png"
    ],
    "model": "v3.1-20260211",
    "texture": true,
    "pbr": true,
    "texture_quality": "detailed"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/multiview-to-model"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "inputs": [
        "https://example.com/front.png",
        "https://example.com/back.png",
        "https://example.com/left.png",
        "https://example.com/right.png"
    ],
    "model": "v3.1-20260211",
    "texture": True,
    "pbr": True,
    "texture_quality": "detailed"
}

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

const url = "https://openapi.tripo3d.ai/v3/generation/multiview-to-model";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    inputs: [
      "https://example.com/front.png",
      "https://example.com/back.png",
      "https://example.com/left.png",
      "https://example.com/right.png"
    ],
    model: "v3.1-20260211",
    texture: true,
    pbr: true,
    texture_quality: "detailed"
  })
});

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

Yanıt

Başarı Yanıtı

JSON

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"
  }
}

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 sıklığı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	2003	Giriş dosyası boş	Yüklenen dosyanın boş olmadığını veya URL’nin erişilebilir olduğunu doğrulayın
400	2004	Desteklenmeyen dosya türü	Desteklenen bir resim formatı kullanın (PNG, JPEG, WebP)
400	2008	Giriş içerik politikasını ihlal ediyor	Giriş resmini değiştirin ve politikayı ihlal eden içeriği kaldırın
403	2010	Yetersiz kredi	Kredi ekleyin ve yeniden deneyin
400	2015	Model sürümü kullanımdan kaldırıldı	`model`’yi şu anda desteklenen bir sürüme yükseltin
400	2018	Model yeniden düzenlenemeyecek kadar karmaşık	`face_limit`’yi düşürün veya girişi basitleştirin