Bỏ qua đến nội dung

Trellis 2

Tích hợp

Id mô hình trellis-2
# 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?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,30 $ 300 tín dụng API Chạy trên trang này

Lấy khóa API
Microsoft Hình ảnh sang 3D #image-to-3d

Chuyển một hình ảnh duy nhất thành lưới 3D GLB có kết cấu với cấu trúc, hình dạng, kết cấu và thiết lập UV có thể điều chỉnh

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 trỏ đến hình ảnh nguồn để chuyển đổi 3D.

resolution mặc định 1024

Độ phân giải đầu ra; tăng giá trị sẽ thêm chi tiết nhưng mất nhiều thời gian hơn.

Nâng cao texture_size · 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 · remesh_band · remesh_project · uv_unwrap_angle_threshold_deg · uv_unwrap_refine_iterations · uv_unwrap_global_iterations · uv_unwrap_smooth_strength · seed · remesh
texture_size mặc định 2048

Độ phân giải kết cấu mesh để baking. Tăng độ phân giải tạo chi tiết bề mặt tinh hơn nhưng làm tệp lớn hơn.

mặc định 7.5

Điều khiển độ trung thực của cấu trúc 3D ban đầu: tăng giá trị giúp bám sát hình ảnh đầu vào hơn nhưng có nguy cơ tạo thêm nhiễu.

mặc định 0.7

Điều khiển hiện tượng do điều hướng ở giai đoạn 1, đánh đổi giữa hiệu ứng điều hướng mạnh hơn ở giá trị thấp và đầu ra ổn định hơn ở giá trị cao.

mặc định 0.6

Biên bắt đầu của cửa sổ hướng dẫn không dùng bộ phân loại trong giai đoạn 1 (cấu trúc thưa), biểu thị dưới dạng phân số khử nhiễu. Thiết lập thấp hơn sẽ bắt đầu hướng dẫn sớm hơn; chỉ khoảng từ interval_start đến interval_end sử dụng hướng dẫn, các phần còn lại được xử lý không hướng dẫn.

mặc định 1

Điểm dừng hướng dẫn cho giai đoạn 1 (cấu trúc thưa): chọn giá trị ít nhất bằng ss_guidance_interval_start. Giá trị này xác định phân số khử nhiễu đạt được khi hướng dẫn không dùng bộ phân loại dừng.

mặc định 12

Số lần khử nhiễu của cấu trúc ban đầu: thêm bước có thể cải thiện chất lượng nhưng làm chậm quá trình xử lý.

mặc định 5

Đặt độ sắc nét của chuyển cảnh thông qua lịch nhiễu tạo cấu trúc: tăng giá trị sẽ làm chuyển cảnh sắc nét hơn.

mặc định 7.5

Điều khiển độ trung thực của hình học chi tiết: tăng mức bám sát hình ảnh đầu vào sẽ thêm chi tiết nhưng có nguy cơ tạo thêm nhiễu.

mặc định 0.5

Tăng thiết lập này khi hình học bị nhiễu: thiết lập làm giảm các hiện tượng do điều hướng mạnh trong giai đoạn tạo hình dạng.

mặc định 0.6

Điểm kích hoạt hướng dẫn không dùng bộ phân loại cho việc tinh chỉnh hình dạng ở giai đoạn 2. Được biểu thị dưới dạng phân số tiến trình khử nhiễu, giá trị này đặt interval_start; hướng dẫn chỉ hoạt động trong cửa sổ giới hạn bởi interval_start và interval_end.

mặc định 1

Điểm dừng hướng dẫn cho giai đoạn 2 (tinh chỉnh hình dạng): chọn giá trị ít nhất bằng shape_slat_guidance_interval_start. Giá trị này xác định phân số khử nhiễu đạt được khi hướng dẫn không dùng bộ phân loại dừng.

mặc định 12

Số lần khử nhiễu tinh chỉnh hình dạng: thêm bước có thể tạo hình học mượt hơn nhưng làm giảm tốc độ.

mặc định 3

Đặt độ sắc nét của chi tiết hình học thông qua lịch nhiễu tinh chỉnh hình dạng; tăng giá trị sẽ tạo chi tiết sắc nét hơn.

mặc định 1

Điều khiển độ trung thực màu kết cấu: ở thiết lập cao hơn, việc bám sát màu trong hình ảnh đầu vào làm tăng độ sống động nhưng có thể gây bão hòa quá mức.

mặc định 0

Tăng thiết lập này để xử lý kết cấu bị nhiễu hoặc dải màu: thiết lập làm giảm các hiện tượng do điều hướng mạnh trong giai đoạn tạo kết cấu.

mặc định 0.6

Điểm kích hoạt hướng dẫn không dùng bộ phân loại cho việc tạo kết cấu ở giai đoạn 3. Được biểu thị dưới dạng phân số tiến trình khử nhiễu, giá trị này đặt interval_start; hướng dẫn chỉ hoạt động trong cửa sổ giới hạn bởi interval_start và interval_end.

mặc định 0.9

Điểm dừng hướng dẫn cho giai đoạn 3 (kết cấu): chọn giá trị ít nhất bằng tex_slat_guidance_interval_start. Giá trị này xác định phân số khử nhiễu đạt được khi hướng dẫn không dùng bộ phân loại dừng.

mặc định 12

Số bước khử nhiễu dùng để tạo kết cấu. Tăng số bước mất nhiều thời gian hơn nhưng có thể tạo kết cấu sạch hơn.

mặc định 3

Đặt độ sắc nét của chi tiết kết cấu thông qua lịch nhiễu tạo kết cấu; tăng giá trị sẽ tạo chi tiết sắc nét hơn.

mặc định 500000

Mục tiêu số đỉnh lưới, khuyến nghị 500k cho mục đích chung và 20k–50k cho web/mobile. Giảm mục tiêu sẽ đánh đổi chi tiết lưới để có tệp nhỏ hơn.

mặc định 1

Mức cho phép dịch chuyển khi tạo lại lưới: tăng giá trị này có thể hy sinh chi tiết nhỏ do làm mượt nhiều hơn. Thiết lập này giới hạn độ dịch chuyển của đỉnh so với bề mặt gốc.

mặc định 0

Cường độ chiếu để đưa các đỉnh đã tạo lại lưới về bề mặt gốc: 1 giữ lại chi tiết qua phép chiếu đầy đủ, còn 0 tắt phép chiếu để có kết quả mượt hơn.

mặc định 90

Giới hạn góc chart UV tính bằng độ, hạn chế mức chênh lệch giữa các pháp tuyến mặt kề nhau trong một chart. Tăng giới hạn ưu tiên ít chart lớn hơn nhưng có nguy cơ kéo giãn; giảm giới hạn ưu tiên nhiều chart hơn và ít biến dạng hơn.

mặc định 0

Số lượt tinh chỉnh cục bộ dùng để tính các chart UV.

mặc định 1

Có thể cải thiện sự cân bằng chart UV bằng cách tăng số lượt gom cụm toàn cục dùng để tính chart.

mặc định 1

Điều chỉnh mức làm mượt các cạnh chart UV; thiết lập cao hơn giúp đường nối ít thấy hơn nhưng có nguy cơ gây biến dạng UV.

Seed dùng để tạo ngẫu nhiên có thể tái tạo.

POST /run/trellis-2?wait=20 báo giá → 0,30 $
# 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?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

Tạo tài sản 3D từ một hình ảnh (`image_url`) và trả về tệp GLB. `resolution` là 512, 1024 hoặc 1536, còn `texture_size` là 1024, 2048 hoặc 4096. Mỗi giai đoạn trong ba giai đoạn (cấu trúc, hình dạng, kết cấu) có các điều khiển hướng dẫn và số bước lấy mẫu riêng. `decimation_target` đặt số đỉnh của lưới (5,000 đến 2,000,000), đồng thời cung cấp các tùy chọn tạo lại lưới và tháo UV.

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ả
seedtùy chọn
Kiểuinteger | null
Seed dùng để tạo ngẫu nhiên có thể tái tạo.
resolutiontùy chọn
Kiểuenum
Mặc định1024
51210241536
Độ phân giải đầu ra; tăng giá trị sẽ thêm chi tiết nhưng mất nhiều thời gian hơn.
ss_guidance_strengthtùy chọn
Kiểunumber
Mặc định7.5
0 – 10
Điều khiển độ trung thực của cấu trúc 3D ban đầu: tăng giá trị giúp bám sát hình ảnh đầu vào hơn nhưng có nguy cơ tạo thêm nhiễu.
ss_guidance_rescaletùy chọn
Kiểunumber
Mặc định0.7
0 – 1
Điều khiển hiện tượng do điều hướng ở giai đoạn 1, đánh đổi giữa hiệu ứng điều hướng mạnh hơn ở giá trị thấp và đầu ra ổn định hơn ở giá trị cao.
ss_guidance_interval_starttùy chọn
Kiểunumber
Mặc định0.6
0 – 1
Biên bắt đầu của cửa sổ hướng dẫn không dùng bộ phân loại trong giai đoạn 1 (cấu trúc thưa), biểu thị dưới dạng phân số khử nhiễu. Thiết lập thấp hơn sẽ bắt đầu hướng dẫn sớm hơn; chỉ khoảng từ interval_start đến interval_end sử dụng hướng dẫn, các phần còn lại được xử lý không hướng dẫn.
ss_guidance_interval_endtùy chọn
Kiểunumber
Mặc định1
0 – 1
Điểm dừng hướng dẫn cho giai đoạn 1 (cấu trúc thưa): chọn giá trị ít nhất bằng ss_guidance_interval_start. Giá trị này xác định phân số khử nhiễu đạt được khi hướng dẫn không dùng bộ phân loại dừng.
ss_sampling_stepstùy chọn
Kiểuinteger
Mặc định12
1 – 50
Số lần khử nhiễu của cấu trúc ban đầu: thêm bước có thể cải thiện chất lượng nhưng làm chậm quá trình xử lý.
ss_rescale_ttùy chọn
Kiểunumber
Mặc định5
1 – 6
Đặt độ sắc nét của chuyển cảnh thông qua lịch nhiễu tạo cấu trúc: tăng giá trị sẽ làm chuyển cảnh sắc nét hơn.
shape_slat_guidance_strengthtùy chọn
Kiểunumber
Mặc định7.5
0 – 10
Điều khiển độ trung thực của hình học chi tiết: tăng mức bám sát hình ảnh đầu vào sẽ thêm chi tiết nhưng có nguy cơ tạo thêm nhiễu.
shape_slat_guidance_rescaletùy chọn
Kiểunumber
Mặc định0.5
0 – 1
Tăng thiết lập này khi hình học bị nhiễu: thiết lập làm giảm các hiện tượng do điều hướng mạnh trong giai đoạn tạo hình dạng.
shape_slat_guidance_interval_starttùy chọn
Kiểunumber
Mặc định0.6
0 – 1
Điểm kích hoạt hướng dẫn không dùng bộ phân loại cho việc tinh chỉnh hình dạng ở giai đoạn 2. Được biểu thị dưới dạng phân số tiến trình khử nhiễu, giá trị này đặt interval_start; hướng dẫn chỉ hoạt động trong cửa sổ giới hạn bởi interval_start và interval_end.
shape_slat_guidance_interval_endtùy chọn
Kiểunumber
Mặc định1
0 – 1
Điểm dừng hướng dẫn cho giai đoạn 2 (tinh chỉnh hình dạng): chọn giá trị ít nhất bằng shape_slat_guidance_interval_start. Giá trị này xác định phân số khử nhiễu đạt được khi hướng dẫn không dùng bộ phân loại dừng.
shape_slat_sampling_stepstùy chọn
Kiểuinteger
Mặc định12
1 – 50
Số lần khử nhiễu tinh chỉnh hình dạng: thêm bước có thể tạo hình học mượt hơn nhưng làm giảm tốc độ.
shape_slat_rescale_ttùy chọn
Kiểunumber
Mặc định3
1 – 6
Đặt độ sắc nét của chi tiết hình học thông qua lịch nhiễu tinh chỉnh hình dạng; tăng giá trị sẽ tạo chi tiết sắc nét hơn.
tex_slat_guidance_strengthtùy chọn
Kiểunumber
Mặc định1
0 – 10
Điều khiển độ trung thực màu kết cấu: ở thiết lập cao hơn, việc bám sát màu trong hình ảnh đầu vào làm tăng độ sống động nhưng có thể gây bão hòa quá mức.
tex_slat_guidance_rescaletùy chọn
Kiểunumber
Mặc định0
0 – 1
Tăng thiết lập này để xử lý kết cấu bị nhiễu hoặc dải màu: thiết lập làm giảm các hiện tượng do điều hướng mạnh trong giai đoạn tạo kết cấu.
tex_slat_guidance_interval_starttùy chọn
Kiểunumber
Mặc định0.6
0 – 1
Điểm kích hoạt hướng dẫn không dùng bộ phân loại cho việc tạo kết cấu ở giai đoạn 3. Được biểu thị dưới dạng phân số tiến trình khử nhiễu, giá trị này đặt interval_start; hướng dẫn chỉ hoạt động trong cửa sổ giới hạn bởi interval_start và interval_end.
tex_slat_guidance_interval_endtùy chọn
Kiểunumber
Mặc định0.9
0 – 1
Điểm dừng hướng dẫn cho giai đoạn 3 (kết cấu): chọn giá trị ít nhất bằng tex_slat_guidance_interval_start. Giá trị này xác định phân số khử nhiễu đạt được khi hướng dẫn không dùng bộ phân loại dừng.
tex_slat_sampling_stepstùy chọn
Kiểuinteger
Mặc định12
1 – 50
Số bước khử nhiễu dùng để tạo kết cấu. Tăng số bước mất nhiều thời gian hơn nhưng có thể tạo kết cấu sạch hơn.
tex_slat_rescale_ttùy chọn
Kiểunumber
Mặc định3
1 – 6
Đặt độ sắc nét của chi tiết kết cấu thông qua lịch nhiễu tạo kết cấu; tăng giá trị sẽ tạo chi tiết sắc nét hơn.
decimation_targettùy chọn
Kiểuinteger
Mặc định500000
5.000 – 2.000.000
Mục tiêu số đỉnh lưới, khuyến nghị 500k cho mục đích chung và 20k–50k cho web/mobile. Giảm mục tiêu sẽ đánh đổi chi tiết lưới để có tệp nhỏ hơn.
texture_sizetùy chọn
Kiểuenum
Mặc định2048
102420484096
Độ phân giải kết cấu mesh để baking. Tăng độ phân giải tạo chi tiết bề mặt tinh hơn nhưng làm tệp lớn hơn.
remeshtùy chọn
Kiểuboolean
Mặc địnhtrue
Tái xây dựng topology để tạo các tam giác lưới sạch hơn, thường cải thiện khả năng sử dụng cho các mục đích sau như hoạt hình hoặc in 3D, nhưng xử lý chậm hơn.
remesh_bandtùy chọn
Kiểunumber
Mặc định1
0 – 4
Mức cho phép dịch chuyển khi tạo lại lưới: tăng giá trị này có thể hy sinh chi tiết nhỏ do làm mượt nhiều hơn. Thiết lập này giới hạn độ dịch chuyển của đỉnh so với bề mặt gốc.
remesh_projecttùy chọn
Kiểunumber
Mặc định0
0 – 1
Cường độ chiếu để đưa các đỉnh đã tạo lại lưới về bề mặt gốc: 1 giữ lại chi tiết qua phép chiếu đầy đủ, còn 0 tắt phép chiếu để có kết quả mượt hơn.
uv_unwrap_angle_threshold_degtùy chọn
Kiểunumber
Mặc định90
0 – 180
Giới hạn góc chart UV tính bằng độ, hạn chế mức chênh lệch giữa các pháp tuyến mặt kề nhau trong một chart. Tăng giới hạn ưu tiên ít chart lớn hơn nhưng có nguy cơ kéo giãn; giảm giới hạn ưu tiên nhiều chart hơn và ít biến dạng hơn.
uv_unwrap_refine_iterationstùy chọn
Kiểuinteger
Mặc định0
0 – 10
Số lượt tinh chỉnh cục bộ dùng để tính các chart UV.
uv_unwrap_global_iterationstùy chọn
Kiểuinteger
Mặc định1
1 – 10
Có thể cải thiện sự cân bằng chart UV bằng cách tăng số lượt gom cụm toàn cục dùng để tính chart.
uv_unwrap_smooth_strengthtùy chọn
Kiểunumber
Mặc định1
0 – 10
Điều chỉnh mức làm mượt các cạnh chart UV; thiết lập cao hơn giúp đường nối ít thấy hơn nhưng có nguy cơ gây biến dạng UV.
image_urlbắt buộc image
Kiểuurl · image
URL trỏ đến hình ảnh nguồn để chuyển đổi 3D.
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",
  "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": 300,
    "usd": "0.30",
    "charged": 300,
    "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
    }
  },
  "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}Mô hình 3D được tạo ở định dạng GLB.

Thêm mô hình: Hình ảnh sang 3D

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