အကြောင်းအရာသို့ ကျော်ရန်

TRELLIS.2 LoRA Inference

ပေါင်းစည်းရန်

မော်ဒယ် id 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"

ဤတောင်းဆိုချက်: ၀.၂၅ $ ၂၅၀ API ခရက်ဒစ် ဤစာမျက်နှာတွင် လုပ်ဆောင်ရန်

API ကီး ရယူရန်
Microsoft ပုံမှ 3D

ဖွဲ့စည်းပုံ၊ ဂျီဩမေတြီနှင့် မျက်နှာပြင်အသားပေးအတွက် စိတ်ကြိုက် LoRA adapter များကို အသုံးပြုနိုင်သည့် Trellis 2 image-to-3D

Microsoft · 3D

သင့်ပထမဆုံးရလဒ် ဤနေရာတွင် ပေါ်လာမည်

အောက်တွင် တောင်းဆိုချက်တစ်ခု တည်ဆောက်ပြီး သင့် API ကီးဖြင့် လုပ်ဆောင်ပါ။ ထွက်ရလဒ်များကို ကျွန်ုပ်တို့၏ သိုလှောင်မှုသို့ ကူးယူပြီး အမြဲတမ်း သို့မဟုတ် ၇ ရက် အခမဲ့ သိမ်းထားသည်။

တောင်းဆိုမှုတစ်ခု တည်ဆောက်ရန်

ထိန်းချုပ်မှုများကို မော်ဒယ် schema မှ အလိုအလျောက်ဖန်တီးသည်။ ၎င်းတို့ကို ပြောင်းလဲသည်နှင့် code နှင့် စျေးနှုန်းတို့လည်း ပြောင်းလဲမည်။

•လိုအပ်သည် image_url
ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ်

3D မော်ဒယ်အဖြစ် ပြောင်းရန် မူလပုံ URL။

resolution မူလ 512

ဖန်တီးမှု ရုပ်ထွက်အရည်အသွေး။ 1024 ကို ရွေးချယ်ပါက cascade pipeline ကို အသုံးပြုသည်။ ပေးထားသော LoRA adapter များကို လေ့ကျင့်ထားသည့် ရုပ်ထွက်အရည်အသွေးကို ရွေးချယ်ရမည်ဖြစ်ပြီး တူညီရန် လိုအပ်သည်။

အဆင့်မြင့် 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

texture denoiser အတွက် သီးသန့်လေ့ကျင့်ထားသော safetensors ဖော်မတ်ရှိ ရွေးချယ်နိုင်သော LoRA checkpoint။

texture_size မူလ 2048

GLB export တွင် ထည့်သွင်းထားသော texture များ၏ ရုပ်ထွက်အရည်အသွေး။

sparse structure denoiser အတွက် သီးသန့်လေ့ကျင့်ထားသော safetensors ဖော်မတ်ရှိ ရွေးချယ်နိုင်သော LoRA checkpoint။

geometry denoiser အတွက် သီးသန့်လေ့ကျင့်ထားသော safetensors ဖော်မတ်ရှိ ရွေးချယ်နိုင်သော LoRA checkpoint။

မူလ 7.5

sparse-structure ဖန်တီးမှုအတွင်း classifier-free guidance ၏ အင်အား။

မူလ 0.7

sparse-structure ဖန်တီးမှုအတွင်း guidance rescaling။ တန်ဖိုးကြီးလေ ထွက်ရလဒ် ပိုမိုတည်ငြိမ်လေ ဖြစ်သည်။

မူလ 0.6

sparse-structure guidance စတင်သည့် denoising တိုးတက်မှု၏ အချိုးအစား။

မူလ 1

sparse-structure guidance ရပ်တန့်မည့်အချိန်ကို သတ်မှတ်ရန် `ss_guidance_interval_start` နှင့် တူညီသော သို့မဟုတ် ပိုမြင့်သော denoising အချိုးအစားကို အသုံးပြုသည်။

မူလ 12

sparse-structure ဖန်တီးမှုအတွင်း အသုံးပြုသည့် denoising အဆင့်အရေအတွက်။

မူလ 5

sparse-structure ဖန်တီးမှုအတွင်း noise schedule ၏ ပြတ်သားမှု။

မူလ 7.5

shape ဖန်တီးမှုအတွင်း classifier-free guidance ၏ အင်အား။

မူလ 0.5

shape ဖန်တီးမှုအတွင်း guidance တွင် အသုံးပြုသော rescaling။ geometry တွင် noise များပါက တန်ဖိုးကို မြှင့်ပါ။

မူလ 0.6

shape-stage guidance စတင်သည့် denoising အချိုးအစား။

မူလ 1

shape-stage guidance ရပ်တန့်မည့်နေရာ။ shape_slat_guidance_interval_start ထက် မနိမ့်သော denoising အချိုးအစားဖြင့် ဖော်ပြသည်။

မူလ 12

shape ဖန်တီးမှုအတွင်း denoising အဆင့်အရေအတွက်။

မူလ 3

shape ဖန်တီးမှုအတွင်း noise schedule ၏ ပြတ်သားမှု။

မူလ 1

texture ဖန်တီးမှုအတွင်း classifier-free guidance ၏ အင်အား။

မူလ 0

texture ဖန်တီးမှုအတွင်း guidance တွင် အသုံးပြုသော rescaling။ texture တွင် noise များပါက တန်ဖိုးကို မြှင့်ပါ။

မူလ 0.6

texture-stage guidance စတင်သည့် denoising အချိုးအစား။

မူလ 0.9

texture-stage guidance ရပ်တန့်မည့်နေရာ။ tex_slat_guidance_interval_start ထက် မနိမ့်သော denoising အချိုးအစားဖြင့် ဖော်ပြသည်။

မူလ 12

texture ဖန်တီးမှုအတွင်း denoising အဆင့်အရေအတွက်။

မူလ 3

texture ဖန်တီးမှုအတွင်း noise schedule ၏ ပြတ်သားမှု။

မူလ 500000

GLB export တွင် လိုချင်သော vertex အရေအတွက်။

ဖန်တီးမှုကို ထပ်တူပြန်လုပ်နိုင်စေသော ကျပန်း seed။

POST /run/trellis-2-lora?wait=20 ကုန်ကျစရိတ် → ၀.၂၅ $
# 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"

ဤတောင်းဆိုချက်ကို လုပ်ဆောင်ရန်

သင့် key သည် ဤဘရောက်ဇာထဲတွင်သာ ရှိမည်ဖြစ်ပြီး Doitong API သို့သာ ပို့မည်။ Remember ကို အမှန်ခြစ်ထားမှသာ (localStorage) တွင် သိမ်းမည်။ API ကီး ရယူရန်

TRELLIS.2 LoRA Inference အကြောင်း

`image_url` မှ GLB တစ်ခုကို ဖန်တီးပြီး `sparse_structure_lora_url`၊ `geometry_lora_url` နှင့် `texture_lora_url` တို့မှတစ်ဆင့် safetensors LoRA များကို ရွေးချယ်အသုံးပြုနိုင်သည်။ `resolution` သည် 512 သို့မဟုတ် 1024 ဖြစ်ပြီး adapter များ၏ လေ့ကျင့်ရေး ရုပ်ထွက်အရည်အသွေးနှင့် ကိုက်ညီရမည်။ အဆင့်တစ်ခုချင်းစီအတွက် လမ်းညွှန်မှုနှင့် အဆင့် ထိန်းချုပ်ချက်များ၊ `decimation_target` နှင့် `texture_size` တို့လည်း ပါဝင်သည်။

ပါရာမီတာများ

စံအမည် သို့မဟုတ် မူရင်းအမည် တစ်ခုခုကိုသာ ပို့ပါ၊ နှစ်ခုလုံး မပို့ပါနှင့်။ စံအမည်များ

အမည်အမျိုးအစား မူလတန်ဖိုးခွင့်ပြုထားသည် ဖော်ပြချက်
image_urlလိုအပ်သည် image
အမျိုးအစားurl · image
3D မော်ဒယ်အဖြစ် ပြောင်းရန် မူလပုံ URL။
sparse_structure_lora_urlရွေးချယ်နိုင်သည်
အမျိုးအစားstring | null
sparse structure denoiser အတွက် သီးသန့်လေ့ကျင့်ထားသော safetensors ဖော်မတ်ရှိ ရွေးချယ်နိုင်သော LoRA checkpoint။
geometry_lora_urlရွေးချယ်နိုင်သည်
အမျိုးအစားstring | null
geometry denoiser အတွက် သီးသန့်လေ့ကျင့်ထားသော safetensors ဖော်မတ်ရှိ ရွေးချယ်နိုင်သော LoRA checkpoint။
texture_lora_urlရွေးချယ်နိုင်သည်
အမျိုးအစားstring | null
texture denoiser အတွက် သီးသန့်လေ့ကျင့်ထားသော safetensors ဖော်မတ်ရှိ ရွေးချယ်နိုင်သော LoRA checkpoint။
seedရွေးချယ်နိုင်သည်
အမျိုးအစားinteger | null
ဖန်တီးမှုကို ထပ်တူပြန်လုပ်နိုင်စေသော ကျပန်း seed။
resolutionရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုး512
5121024
ဖန်တီးမှု ရုပ်ထွက်အရည်အသွေး။ 1024 ကို ရွေးချယ်ပါက cascade pipeline ကို အသုံးပြုသည်။ ပေးထားသော LoRA adapter များကို လေ့ကျင့်ထားသည့် ရုပ်ထွက်အရည်အသွေးကို ရွေးချယ်ရမည်ဖြစ်ပြီး တူညီရန် လိုအပ်သည်။
ss_guidance_strengthရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး7.5
၀ – ၁၀
sparse-structure ဖန်တီးမှုအတွင်း classifier-free guidance ၏ အင်အား။
ss_guidance_rescaleရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး0.7
၀ – ၁
sparse-structure ဖန်တီးမှုအတွင်း guidance rescaling။ တန်ဖိုးကြီးလေ ထွက်ရလဒ် ပိုမိုတည်ငြိမ်လေ ဖြစ်သည်။
ss_guidance_interval_startရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး0.6
၀ – ၁
sparse-structure guidance စတင်သည့် denoising တိုးတက်မှု၏ အချိုးအစား။
ss_guidance_interval_endရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး1
၀ – ၁
sparse-structure guidance ရပ်တန့်မည့်အချိန်ကို သတ်မှတ်ရန် `ss_guidance_interval_start` နှင့် တူညီသော သို့မဟုတ် ပိုမြင့်သော denoising အချိုးအစားကို အသုံးပြုသည်။
ss_sampling_stepsရွေးချယ်နိုင်သည်
အမျိုးအစားinteger
မူလတန်ဖိုး12
၁ – ၅၀
sparse-structure ဖန်တီးမှုအတွင်း အသုံးပြုသည့် denoising အဆင့်အရေအတွက်။
ss_rescale_tရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး5
၁ – ၆
sparse-structure ဖန်တီးမှုအတွင်း noise schedule ၏ ပြတ်သားမှု။
shape_slat_guidance_strengthရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး7.5
၀ – ၁၀
shape ဖန်တီးမှုအတွင်း classifier-free guidance ၏ အင်အား။
shape_slat_guidance_rescaleရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး0.5
၀ – ၁
shape ဖန်တီးမှုအတွင်း guidance တွင် အသုံးပြုသော rescaling။ geometry တွင် noise များပါက တန်ဖိုးကို မြှင့်ပါ။
shape_slat_guidance_interval_startရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး0.6
၀ – ၁
shape-stage guidance စတင်သည့် denoising အချိုးအစား။
shape_slat_guidance_interval_endရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး1
၀ – ၁
shape-stage guidance ရပ်တန့်မည့်နေရာ။ shape_slat_guidance_interval_start ထက် မနိမ့်သော denoising အချိုးအစားဖြင့် ဖော်ပြသည်။
shape_slat_sampling_stepsရွေးချယ်နိုင်သည်
အမျိုးအစားinteger
မူလတန်ဖိုး12
၁ – ၅၀
shape ဖန်တီးမှုအတွင်း denoising အဆင့်အရေအတွက်။
shape_slat_rescale_tရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး3
၁ – ၆
shape ဖန်တီးမှုအတွင်း noise schedule ၏ ပြတ်သားမှု။
tex_slat_guidance_strengthရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး1
၀ – ၁၀
texture ဖန်တီးမှုအတွင်း classifier-free guidance ၏ အင်အား။
tex_slat_guidance_rescaleရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး0
၀ – ၁
texture ဖန်တီးမှုအတွင်း guidance တွင် အသုံးပြုသော rescaling။ texture တွင် noise များပါက တန်ဖိုးကို မြှင့်ပါ။
tex_slat_guidance_interval_startရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး0.6
၀ – ၁
texture-stage guidance စတင်သည့် denoising အချိုးအစား။
tex_slat_guidance_interval_endရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး0.9
၀ – ၁
texture-stage guidance ရပ်တန့်မည့်နေရာ။ tex_slat_guidance_interval_start ထက် မနိမ့်သော denoising အချိုးအစားဖြင့် ဖော်ပြသည်။
tex_slat_sampling_stepsရွေးချယ်နိုင်သည်
အမျိုးအစားinteger
မူလတန်ဖိုး12
၁ – ၅၀
texture ဖန်တီးမှုအတွင်း denoising အဆင့်အရေအတွက်။
tex_slat_rescale_tရွေးချယ်နိုင်သည်
အမျိုးအစားnumber
မူလတန်ဖိုး3
၁ – ၆
texture ဖန်တီးမှုအတွင်း noise schedule ၏ ပြတ်သားမှု။
decimation_targetရွေးချယ်နိုင်သည်
အမျိုးအစားinteger
မူလတန်ဖိုး500000
၅,၀၀၀ – ၂,၀၀၀,၀၀၀
GLB export တွင် လိုချင်သော vertex အရေအတွက်။
texture_sizeရွေးချယ်နိုင်သည်
အမျိုးအစားenum
မူလတန်ဖိုး2048
102420484096
GLB export တွင် ထည့်သွင်းထားသော texture များ၏ ရုပ်ထွက်အရည်အသွေး။
enable_safety_checkerရွေးချယ်နိုင်သည်
အမျိုးအစားboolean
မူလတန်ဖိုးtrue
caller က ခွင့်ပြုချက်ရှိပါက false သတ်မှတ်ခြင်းဖြင့် စစ်ဆေးမှုကို လျှော့ချနိုင်သည်။
လိုအပ်သည် စံအမည်၊ ထို့အပြင် လက်ခံသည်

ဖိုင်ပါရာမီတာများသည် အများပြည်သူသုံး https:// URL၊ 10 MB အထိ data: URI သို့မဟုတ် အပ်လုဒ်လုပ်ထားသောဖိုင်၏ file_url ကို လက်ခံသည်။ ဖိုင်များ

ထွက်ရလဒ်

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"
  }
}
သင့်ဖိုင်များ၊ သင့်ရွေးချယ်မှုoutputs[].url တိုင်းသည် ကျွန်ုပ်တို့၏ သိုလှောင်မှုရှိ မိတ္တူဖြစ်သည်- အမြဲတမ်း (GB-month အလိုက် ငွေပေးရသည်) သို့မဟုတ် ၇ ရက် အခမဲ့၊ သင့်အကောင့်ဆက်တင် သို့မဟုတ် ?storage= ဖြင့် သိမ်းထားသည်။
မော်ဒယ်တိုင်းတွင် ပုံစံတူပုံ၊ ဗီဒီယိုနှင့် အသံတို့အတွက် type၊ url၊ content_type၊ width၊ height နှင့် duration။ output သည် မော်ဒယ်ကိုယ်တိုင်၏ ရလဒ် object ဖြစ်သည်။
ထွက်ရလဒ်၏ Fields များ
model_glb
object {url, content_type, file_name, file_size}ဖန်တီးထားသော 3D မော်ဒယ်ပါဝင်သည့် GLB ဖိုင်။
seed
integerဖန်တီးစဉ် အသုံးပြုထားသော seed။
resolution
integerဖန်တီးမှု ပြုလုပ်ခဲ့သည့် ရုပ်ထွက်အရည်အသွေး။
sparse_structure_lora_url
string | nullဖန်တီးမှုအတွင်း အသုံးပြုခဲ့သော sparse-structure LoRA checkpoint (အသုံးပြုထားပါက)။
geometry_lora_url
string | nullဖန်တီးမှုအတွင်း အသုံးပြုခဲ့သော geometry LoRA checkpoint (အသုံးပြုထားပါက)။
texture_lora_url
string | nullဖန်တီးမှုအတွင်း အသုံးပြုခဲ့သော texture LoRA checkpoint (အသုံးပြုထားပါက)။
decimation_target
integerGLB export တွင် အသုံးပြုထားသော vertex အရေအတွက် ရည်မှန်းချက်။
texture_size
integerGLB export တွင် ထည့်သွင်းထားသော texture များ၏ ရုပ်ထွက်အရည်အသွေး။

AI အေးဂျင့်များအတွက်- ဤစာမျက်နှာ၏ Markdown ကို ဤနေရာတွင် ရရှိနိုင်သည် https://doitong.com/my/developers/models/trellis-2-lora.md. မော်ဒယ်များနှင့် လမ်းညွှန်များအားလုံး: https://doitong.com/developers/llms.txt