Metni 3D Modele Dönüştürme

POST /v3/generation/text-to-model

Metin isteminden bir 3B 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}`

Talep Gövdesi

Parametre	Tür	Gerekli	Varsayılan	Açıklama
prompt	dize	Evet	-	Metin istemi, en fazla 1024 karakter
model	dize	Hayır	`tripo-v3.1`	AI model versiyonu. Desteklenen değerler: `tripo-p1`, `tripo-turbo`, `tripo-v3.1`, `tripo-v3.0`, `tripo-v2.5`, `tripo-v2.0`
negative_prompt	dize	Hayır	-	Olumsuz bilgi istemi, en fazla 255 karakter
model_seed	tamsayı	Hayır	Rastgele	Geometri üretimi için rastgele tohum
image_seed	tamsayı	Hayır	Rastgele	Metinden resme aşaması için rastgele tohum
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: `standard`, `detailed`, `extreme`
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=true`, `pbr=true` ve `quad=true` ile karşılıklı olarak özel
compress	dize	Hayır	-	Sıkıştırma türü. `geometry` (meshopt sıkıştırması)

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

Örnekler İste

-cmd">curl -X POST https://openapi.tripo3d.ai/v3/generation/text class="hl-flag">-to-model \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "prompt": "A cat wearing a spacesuit",
    "model": "tripo-v3.1",
    "texture": true,
    "pbr": true,
    "texture_quality": "detailed"}'

import requests

url = "https://openapi.tripo3d.ai/v3/generation/text-to-model"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "prompt": "A cat wearing a spacesuit",
    "model": "tripo-v3.1",
    "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/text-to-model";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    prompt: "A cat wearing a spacesuit",
    model: "tripo-v3.1",
    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	2008	Giriş içerik politikasını ihlal ediyor	İstemi gözden geçirin ve politikayı ihlal eden açıklamaları 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ş istemini basitleştirin