İçeriğe geç

TRELLIS.2 LoRA Inference

Entegre et

Model kimliği trellis-2-lora
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bu istek: $0,25 250 API kredisi Bu sayfada çalıştır

API anahtarı al
Microsoft Görselden 3D'ye

Yapı, geometri ve doku için özel LoRA adaptörleri uygulayabilen Trellis 2 görüntüden 3D üretimi

Microsoft · 3D

İlk sonucunuz burada görünecek

Aşağıda bir istek oluşturun ve API anahtarınızla çalıştırın. Çıktılar depolamamıza kopyalanır ve sonsuza kadar veya ücretsiz olarak 7 gün boyunca saklanır.

İstek oluştur

Kontroller model şemasından oluşturulur. Değerleri değiştirdikçe kod ve fiyat güncellenir.

•gerekli image_url
Dosyayı bırakın veya

3D modele dönüştürülecek kaynak görsel URL'si.

resolution varsayılan 512

Üretim çözünürlüğü; 1024, cascade işlem hattını seçer. Sağlanan LoRA adaptörlerini eğitmek için kullanılan çözünürlüğü seçin; eşleşme gerekir.

Gelişmiş texture_lora_url · texture_size · sparse_structure_lora_url · geometry_lora_url · ss_guidance_strength · ss_guidance_rescale · ss_guidance_interval_start · ss_guidance_interval_end · ss_sampling_steps · ss_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_guidance_interval_start · shape_slat_guidance_interval_end · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_guidance_interval_start · tex_slat_guidance_interval_end · tex_slat_sampling_steps · tex_slat_rescale_t · decimation_target · seed · enable_safety_checker

Yalnızca doku gürültü gidericisi için özel olarak eğitilmiş, safetensors biçimindeki isteğe bağlı LoRA checkpoint'i.

texture_size varsayılan 2048

GLB dışa aktarımına işlenen dokuların çözünürlüğü.

Yalnızca seyrek yapı gürültü gidericisi için özel olarak eğitilmiş, safetensors biçimindeki isteğe bağlı LoRA checkpoint'i.

Yalnızca geometri gürültü gidericisi için özel olarak eğitilmiş, safetensors biçimindeki isteğe bağlı LoRA checkpoint'i.

varsayılan 7.5

Seyrek yapı üretimi sırasında sınıflandırıcısız yönlendirme gücü.

varsayılan 0.7

Seyrek yapı üretimi sırasında yönlendirme yeniden ölçeklendirmesi. Daha büyük değerler çıktıyı daha kararlı hale getirir.

varsayılan 0.6

Seyrek yapı yönlendirmesinin başladığı gürültü giderme ilerlemesi kesri.

varsayılan 1

Seyrek yapı yönlendirmesinin ne zaman duracağını belirtmek için `ss_guidance_interval_start` değerine eşit veya daha büyük bir gürültü giderme kesri kullanın.

varsayılan 12

Seyrek yapı üretimi sırasında kullanılan gürültü giderme adımı sayısı.

varsayılan 5

Seyrek yapı üretimi sırasında gürültü zamanlamasının keskinliği.

varsayılan 7.5

Şekil üretimi sırasında sınıflandırıcısız yönlendirme gücü.

varsayılan 0.5

Şekil üretimi sırasında yönlendirmeye uygulanan yeniden ölçeklendirme; geometri gürültülü göründüğünde artırın.

varsayılan 0.6

Şekil aşaması yönlendirmesinin başladığı gürültü giderme kesri.

varsayılan 1

shape_slat_guidance_interval_start değerinden küçük olmayan bir gürültü giderme kesri olarak ifade edilen şekil aşaması yönlendirme durma noktası.

varsayılan 12

Şekil üretimi sırasında kullanılan gürültü giderme adımı sayısı.

varsayılan 3

Şekil üretimi sırasında gürültü zamanlamasının keskinliği.

varsayılan 1

Doku üretimi sırasında sınıflandırıcısız yönlendirme gücü.

varsayılan 0

Doku üretimi sırasında yönlendirmeye uygulanan yeniden ölçeklendirme; dokular gürültülü göründüğünde artırın.

varsayılan 0.6

Doku aşaması yönlendirmesinin başladığı gürültü giderme kesri.

varsayılan 0.9

tex_slat_guidance_interval_start değerinden küçük olmayan bir gürültü giderme kesri olarak ifade edilen doku aşaması yönlendirme durma noktası.

varsayılan 12

Doku üretimi sırasında kullanılan gürültü giderme adımı sayısı.

varsayılan 3

Doku üretimi sırasında gürültü zamanlamasının keskinliği.

varsayılan 500000

GLB dışa aktarımında istenen köşe sayısı.

Üretimi tekrarlanabilir kılan rastgele seed.

POST /run/trellis-2-lora?wait=20 fiyat → $0,25
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/trellis-2-lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Bu isteği çalıştır

Anahtarınız bu tarayıcıda kalır: yalnızca Doitong API'ye gönderilir ve yalnızca Hatırla seçeneğini işaretlerseniz localStorage'a kaydedilir. API anahtarı al

TRELLIS.2 LoRA Inference hakkında

`sparse_structure_lora_url`, `geometry_lora_url` ve `texture_lora_url` üzerinden isteğe bağlı safetensors LoRA'ları uygulayarak `image_url` adresinden GLB üretir. `resolution` 512 veya 1024'tür ve adaptörlerin eğitim çözünürlüğüyle eşleşmelidir. Aşama başına yönlendirme ve adım kontrolleri, `decimation_target` ve `texture_size` de sunulur.

Parametreler

Kanonik adı veya yerel adı gönderin; ikisini birden göndermeyin. Kanonik adlar

AdTür Varsayılanİzin verilen Açıklama
image_urlgerekli image
Türurl · image
3D modele dönüştürülecek kaynak görsel URL'si.
sparse_structure_lora_urlisteğe bağlı
Türstring | null
Yalnızca seyrek yapı gürültü gidericisi için özel olarak eğitilmiş, safetensors biçimindeki isteğe bağlı LoRA checkpoint'i.
geometry_lora_urlisteğe bağlı
Türstring | null
Yalnızca geometri gürültü gidericisi için özel olarak eğitilmiş, safetensors biçimindeki isteğe bağlı LoRA checkpoint'i.
texture_lora_urlisteğe bağlı
Türstring | null
Yalnızca doku gürültü gidericisi için özel olarak eğitilmiş, safetensors biçimindeki isteğe bağlı LoRA checkpoint'i.
seedisteğe bağlı
Türinteger | null
Üretimi tekrarlanabilir kılan rastgele seed.
resolutionisteğe bağlı
Türenum
Varsayılan512
5121024
Üretim çözünürlüğü; 1024, cascade işlem hattını seçer. Sağlanan LoRA adaptörlerini eğitmek için kullanılan çözünürlüğü seçin; eşleşme gerekir.
ss_guidance_strengthisteğe bağlı
Türnumber
Varsayılan7.5
0 – 10
Seyrek yapı üretimi sırasında sınıflandırıcısız yönlendirme gücü.
ss_guidance_rescaleisteğe bağlı
Türnumber
Varsayılan0.7
0 – 1
Seyrek yapı üretimi sırasında yönlendirme yeniden ölçeklendirmesi. Daha büyük değerler çıktıyı daha kararlı hale getirir.
ss_guidance_interval_startisteğe bağlı
Türnumber
Varsayılan0.6
0 – 1
Seyrek yapı yönlendirmesinin başladığı gürültü giderme ilerlemesi kesri.
ss_guidance_interval_endisteğe bağlı
Türnumber
Varsayılan1
0 – 1
Seyrek yapı yönlendirmesinin ne zaman duracağını belirtmek için `ss_guidance_interval_start` değerine eşit veya daha büyük bir gürültü giderme kesri kullanın.
ss_sampling_stepsisteğe bağlı
Türinteger
Varsayılan12
1 – 50
Seyrek yapı üretimi sırasında kullanılan gürültü giderme adımı sayısı.
ss_rescale_tisteğe bağlı
Türnumber
Varsayılan5
1 – 6
Seyrek yapı üretimi sırasında gürültü zamanlamasının keskinliği.
shape_slat_guidance_strengthisteğe bağlı
Türnumber
Varsayılan7.5
0 – 10
Şekil üretimi sırasında sınıflandırıcısız yönlendirme gücü.
shape_slat_guidance_rescaleisteğe bağlı
Türnumber
Varsayılan0.5
0 – 1
Şekil üretimi sırasında yönlendirmeye uygulanan yeniden ölçeklendirme; geometri gürültülü göründüğünde artırın.
shape_slat_guidance_interval_startisteğe bağlı
Türnumber
Varsayılan0.6
0 – 1
Şekil aşaması yönlendirmesinin başladığı gürültü giderme kesri.
shape_slat_guidance_interval_endisteğe bağlı
Türnumber
Varsayılan1
0 – 1
shape_slat_guidance_interval_start değerinden küçük olmayan bir gürültü giderme kesri olarak ifade edilen şekil aşaması yönlendirme durma noktası.
shape_slat_sampling_stepsisteğe bağlı
Türinteger
Varsayılan12
1 – 50
Şekil üretimi sırasında kullanılan gürültü giderme adımı sayısı.
shape_slat_rescale_tisteğe bağlı
Türnumber
Varsayılan3
1 – 6
Şekil üretimi sırasında gürültü zamanlamasının keskinliği.
tex_slat_guidance_strengthisteğe bağlı
Türnumber
Varsayılan1
0 – 10
Doku üretimi sırasında sınıflandırıcısız yönlendirme gücü.
tex_slat_guidance_rescaleisteğe bağlı
Türnumber
Varsayılan0
0 – 1
Doku üretimi sırasında yönlendirmeye uygulanan yeniden ölçeklendirme; dokular gürültülü göründüğünde artırın.
tex_slat_guidance_interval_startisteğe bağlı
Türnumber
Varsayılan0.6
0 – 1
Doku aşaması yönlendirmesinin başladığı gürültü giderme kesri.
tex_slat_guidance_interval_endisteğe bağlı
Türnumber
Varsayılan0.9
0 – 1
tex_slat_guidance_interval_start değerinden küçük olmayan bir gürültü giderme kesri olarak ifade edilen doku aşaması yönlendirme durma noktası.
tex_slat_sampling_stepsisteğe bağlı
Türinteger
Varsayılan12
1 – 50
Doku üretimi sırasında kullanılan gürültü giderme adımı sayısı.
tex_slat_rescale_tisteğe bağlı
Türnumber
Varsayılan3
1 – 6
Doku üretimi sırasında gürültü zamanlamasının keskinliği.
decimation_targetisteğe bağlı
Türinteger
Varsayılan500000
5.000 – 2.000.000
GLB dışa aktarımında istenen köşe sayısı.
texture_sizeisteğe bağlı
Türenum
Varsayılan2048
102420484096
GLB dışa aktarımına işlenen dokuların çözünürlüğü.
enable_safety_checkeristeğe bağlı
Türboolean
Varsayılantrue
Çağıran yetkiliyse false ayarlanarak tarama gevşetilebilir.
gerekli Kanonik ad, bu ad da kabul edilir

Dosya parametreleri herkese açık bir https:// URL'si, 10 MB'a kadar bir data: URI'si veya yüklenen bir dosyanın file_url değerini kabul eder. Dosyalar

Çıktı

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "trellis-2-lora",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 250,
    "usd": "0.25",
    "charged": 250,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "seed": 42,
    "resolution": 1,
    "sparse_structure_lora_url": "string",
    "geometry_lora_url": "string",
    "texture_lora_url": "string",
    "decimation_target": 1,
    "texture_size": 1
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Dosyalarınız, seçiminizHer outputs[].url, depolamamızdaki bir kopyadır: sonsuza kadar (GB-ay başına ücretli) veya ücretsiz olarak 7 gün boyunca, hesap ayarınızla ya da ?storage= ile saklanır.
Her modelde aynı yapıGörüntüler, video ve ses için type, url, content_type, width, height ve duration aynıdır. output, modelin kendi sonuç nesnesidir.
Çıktı alanları
model_glb
object {url, content_type, file_name, file_size}Üretilen 3D modeli içeren GLB dosyası.
seed
integerÜretim sırasında uygulanan seed.
resolution
integerÜretimin gerçekleştirildiği çözünürlük.
sparse_structure_lora_url
string | nullÜretim sırasında kullanılan seyrek yapı LoRA checkpoint'i (uygulandıysa).
geometry_lora_url
string | nullÜretim sırasında kullanılan geometri LoRA checkpoint'i (uygulandıysa).
texture_lora_url
string | nullÜretim sırasında kullanılan doku LoRA checkpoint'i (uygulandıysa).
decimation_target
integerGLB dışa aktarımına uygulanan köşe sayısı hedefi.
texture_size
integerGLB dışa aktarımına işlenen dokuların çözünürlüğü.

AI aracıları için: bu sayfanın Markdown biçimi şurada: https://doitong.com/tr/developers/models/trellis-2-lora.md. Tüm modeller ve kılavuzlar: https://doitong.com/developers/llms.txt