Bỏ qua đến nội dung

TRELLIS.2 LoRA Inference

Tích hợp

Id mô hình 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"

Yêu cầu này: 0,25 $ 250 tín dụng API Chạy trên trang này

Lấy khóa API
Microsoft Hình ảnh sang 3D

Trellis 2 chuyển hình ảnh thành 3D và có thể áp dụng các bộ điều hợp LoRA tùy chỉnh cho cấu trúc, hình học và kết cấu

Microsoft · 3D

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc image_url
Thả tệp hoặc

URL hình ảnh nguồn để chuyển đổi thành mô hình 3D.

resolution mặc định 512

Độ phân giải tạo sinh, trong đó 1024 chọn pipeline cascade. Chọn độ phân giải được dùng để huấn luyện các bộ điều hợp LoRA được cung cấp; bắt buộc phải khớp.

Nâng cao 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

Checkpoint LoRA tùy chọn ở định dạng safetensors, được huấn luyện riêng cho bộ khử nhiễu kết cấu.

texture_size mặc định 2048

Độ phân giải của kết cấu được nung vào bản xuất GLB.

Checkpoint LoRA tùy chọn ở định dạng safetensors, được huấn luyện riêng cho bộ khử nhiễu cấu trúc thưa.

Checkpoint LoRA tùy chọn ở định dạng safetensors, được huấn luyện riêng cho bộ khử nhiễu hình học.

mặc định 7.5

Cường độ hướng dẫn không dùng bộ phân loại trong quá trình tạo cấu trúc thưa.

mặc định 0.7

Tái tỷ lệ hướng dẫn trong quá trình tạo cấu trúc thưa. Giá trị lớn hơn giúp đầu ra ổn định hơn.

mặc định 0.6

Phân số tiến trình khử nhiễu tại đó bắt đầu hướng dẫn cấu trúc thưa.

mặc định 1

Dùng phân số khử nhiễu bằng hoặc lớn hơn `ss_guidance_interval_start` để chỉ định thời điểm dừng hướng dẫn cấu trúc thưa.

mặc định 12

Số bước khử nhiễu dùng trong quá trình tạo cấu trúc thưa.

mặc định 5

Độ sắc nét của lịch nhiễu trong quá trình tạo cấu trúc thưa.

mặc định 7.5

Cường độ hướng dẫn không dùng bộ phân loại trong quá trình tạo hình dạng.

mặc định 0.5

Tái tỷ lệ áp dụng cho hướng dẫn trong quá trình tạo hình dạng; tăng giá trị này khi hình học bị nhiễu.

mặc định 0.6

Phân số khử nhiễu tại đó bắt đầu hướng dẫn giai đoạn hình dạng.

mặc định 1

Điểm dừng hướng dẫn giai đoạn hình dạng, biểu thị dưới dạng phân số khử nhiễu không nhỏ hơn shape_slat_guidance_interval_start.

mặc định 12

Số bước khử nhiễu trong quá trình tạo hình dạng.

mặc định 3

Độ sắc nét của lịch nhiễu trong quá trình tạo hình dạng.

mặc định 1

Cường độ hướng dẫn không dùng bộ phân loại trong quá trình tạo kết cấu.

mặc định 0

Tái tỷ lệ áp dụng cho hướng dẫn trong quá trình tạo kết cấu; tăng giá trị này khi kết cấu bị nhiễu.

mặc định 0.6

Phân số khử nhiễu tại đó bắt đầu hướng dẫn giai đoạn kết cấu.

mặc định 0.9

Điểm dừng hướng dẫn giai đoạn kết cấu, biểu thị dưới dạng phân số khử nhiễu không nhỏ hơn tex_slat_guidance_interval_start.

mặc định 12

Số bước khử nhiễu trong quá trình tạo kết cấu.

mặc định 3

Độ sắc nét của lịch nhiễu trong quá trình tạo kết cấu.

mặc định 500000

Số đỉnh mong muốn trong bản xuất GLB.

Seed ngẫu nhiên giúp tái tạo kết quả tạo sinh.

POST /run/trellis-2-lora?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về TRELLIS.2 LoRA Inference

Tạo GLB từ `image_url`, tùy chọn áp dụng các LoRA safetensors thông qua `sparse_structure_lora_url`, `geometry_lora_url` và `texture_lora_url`. `resolution` là 512 hoặc 1024 và phải khớp với độ phân giải huấn luyện của các bộ điều hợp. Cũng cung cấp các điều khiển hướng dẫn và số bước theo từng giai đoạn, `decimation_target` và `texture_size`.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
image_urlbắt buộc image
Kiểuurl · image
URL hình ảnh nguồn để chuyển đổi thành mô hình 3D.
sparse_structure_lora_urltùy chọn
Kiểustring | null
Checkpoint LoRA tùy chọn ở định dạng safetensors, được huấn luyện riêng cho bộ khử nhiễu cấu trúc thưa.
geometry_lora_urltùy chọn
Kiểustring | null
Checkpoint LoRA tùy chọn ở định dạng safetensors, được huấn luyện riêng cho bộ khử nhiễu hình học.
texture_lora_urltùy chọn
Kiểustring | null
Checkpoint LoRA tùy chọn ở định dạng safetensors, được huấn luyện riêng cho bộ khử nhiễu kết cấu.
seedtùy chọn
Kiểuinteger | null
Seed ngẫu nhiên giúp tái tạo kết quả tạo sinh.
resolutiontùy chọn
Kiểuenum
Mặc định512
5121024
Độ phân giải tạo sinh, trong đó 1024 chọn pipeline cascade. Chọn độ phân giải được dùng để huấn luyện các bộ điều hợp LoRA được cung cấp; bắt buộc phải khớp.
ss_guidance_strengthtùy chọn
Kiểunumber
Mặc định7.5
0 – 10
Cường độ hướng dẫn không dùng bộ phân loại trong quá trình tạo cấu trúc thưa.
ss_guidance_rescaletùy chọn
Kiểunumber
Mặc định0.7
0 – 1
Tái tỷ lệ hướng dẫn trong quá trình tạo cấu trúc thưa. Giá trị lớn hơn giúp đầu ra ổn định hơn.
ss_guidance_interval_starttùy chọn
Kiểunumber
Mặc định0.6
0 – 1
Phân số tiến trình khử nhiễu tại đó bắt đầu hướng dẫn cấu trúc thưa.
ss_guidance_interval_endtùy chọn
Kiểunumber
Mặc định1
0 – 1
Dùng phân số khử nhiễu bằng hoặc lớn hơn `ss_guidance_interval_start` để chỉ định thời điểm dừng hướng dẫn cấu trúc thưa.
ss_sampling_stepstùy chọn
Kiểuinteger
Mặc định12
1 – 50
Số bước khử nhiễu dùng trong quá trình tạo cấu trúc thưa.
ss_rescale_ttùy chọn
Kiểunumber
Mặc định5
1 – 6
Độ sắc nét của lịch nhiễu trong quá trình tạo cấu trúc thưa.
shape_slat_guidance_strengthtùy chọn
Kiểunumber
Mặc định7.5
0 – 10
Cường độ hướng dẫn không dùng bộ phân loại trong quá trình tạo hình dạng.
shape_slat_guidance_rescaletùy chọn
Kiểunumber
Mặc định0.5
0 – 1
Tái tỷ lệ áp dụng cho hướng dẫn trong quá trình tạo hình dạng; tăng giá trị này khi hình học bị nhiễu.
shape_slat_guidance_interval_starttùy chọn
Kiểunumber
Mặc định0.6
0 – 1
Phân số khử nhiễu tại đó bắt đầu hướng dẫn giai đoạn hình dạng.
shape_slat_guidance_interval_endtùy chọn
Kiểunumber
Mặc định1
0 – 1
Điểm dừng hướng dẫn giai đoạn hình dạng, biểu thị dưới dạng phân số khử nhiễu không nhỏ hơn shape_slat_guidance_interval_start.
shape_slat_sampling_stepstùy chọn
Kiểuinteger
Mặc định12
1 – 50
Số bước khử nhiễu trong quá trình tạo hình dạng.
shape_slat_rescale_ttùy chọn
Kiểunumber
Mặc định3
1 – 6
Độ sắc nét của lịch nhiễu trong quá trình tạo hình dạng.
tex_slat_guidance_strengthtùy chọn
Kiểunumber
Mặc định1
0 – 10
Cường độ hướng dẫn không dùng bộ phân loại trong quá trình tạo kết cấu.
tex_slat_guidance_rescaletùy chọn
Kiểunumber
Mặc định0
0 – 1
Tái tỷ lệ áp dụng cho hướng dẫn trong quá trình tạo kết cấu; tăng giá trị này khi kết cấu bị nhiễu.
tex_slat_guidance_interval_starttùy chọn
Kiểunumber
Mặc định0.6
0 – 1
Phân số khử nhiễu tại đó bắt đầu hướng dẫn giai đoạn kết cấu.
tex_slat_guidance_interval_endtùy chọn
Kiểunumber
Mặc định0.9
0 – 1
Điểm dừng hướng dẫn giai đoạn kết cấu, biểu thị dưới dạng phân số khử nhiễu không nhỏ hơn tex_slat_guidance_interval_start.
tex_slat_sampling_stepstùy chọn
Kiểuinteger
Mặc định12
1 – 50
Số bước khử nhiễu trong quá trình tạo kết cấu.
tex_slat_rescale_ttùy chọn
Kiểunumber
Mặc định3
1 – 6
Độ sắc nét của lịch nhiễu trong quá trình tạo kết cấu.
decimation_targettùy chọn
Kiểuinteger
Mặc định500000
5.000 – 2.000.000
Số đỉnh mong muốn trong bản xuất GLB.
texture_sizetùy chọn
Kiểuenum
Mặc định2048
102420484096
Độ phân giải của kết cấu được nung vào bản xuất GLB.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Có thể nới lỏng việc kiểm duyệt bằng cách đặt thành false, nếu người gọi được cấp quyền.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
model_glb
object {url, content_type, file_name, file_size}Tệp GLB chứa mô hình 3D được tạo.
seed
integerSeed được áp dụng trong quá trình tạo sinh.
resolution
integerĐộ phân giải được sử dụng để thực hiện tạo sinh.
sparse_structure_lora_url
string | nullCheckpoint LoRA cấu trúc thưa được sử dụng trong quá trình tạo sinh, nếu có áp dụng.
geometry_lora_url
string | nullCheckpoint LoRA hình học được sử dụng trong quá trình tạo sinh, nếu có áp dụng.
texture_lora_url
string | nullCheckpoint LoRA kết cấu được sử dụng trong quá trình tạo sinh, nếu có áp dụng.
decimation_target
integerMục tiêu số đỉnh được áp dụng cho bản xuất GLB.
texture_size
integerĐộ phân giải của kết cấu được nung vào bản xuất GLB.

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/trellis-2-lora.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt