Bỏ qua đến nội dung

Trellis 2 · Retexture

Tích hợp

Id mô hình trellis-2/retexture
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/trellis-2/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

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

Yêu cầu này: 0,24 $ 240 tín dụng API · ≈ 25,13 ₽ Chạy trên trang này

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

Tạo lại kết cấu cho lưới 3D hiện có chưa có kết cấu để khớp với hình ảnh tham chiếu, đầu ra là GLB

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 tham chiếu dùng để tạo kết cấu.

resolution mặc định 1024

Chi tiết kết cấu và tốc độ xử lý phụ thuộc vào độ phân giải tạo sinh nội bộ này: tăng giá trị sẽ tạo chi tiết mịn hơn nhưng mất nhiều thời gian hơn.

•bắt buộc

URL nguồn tạo lại kết cấu cho lưới 3D chưa có kết cấu ở định dạng GLB, OBJ, PLY hoặc STL.

Nâng cao texture_size · 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 · seed
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 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 quá trình tạo kết cấu. Đượ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

Biên dừng hướng dẫn không dùng bộ phân loại của giai đoạn kết cấu, được chỉ định 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 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.

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

POST /run/trellis-2/retexture?wait=20 báo giá → 0,24 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/trellis-2/retexture?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",
    "mesh_url": "https://example.com/your-file.glb"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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 · Retexture

Áp dụng kết cấu mới cho lưới tại `mesh_url` (GLB, OBJ, PLY hoặc STL) dựa trên hình ảnh tham chiếu `image_url`. `resolution` là 512 hoặc 1024, còn `texture_size` là 1024, 2048 hoặc 4096. Có sẵn các điều khiển hướng dẫn và lấy mẫu cho giai đoạn kết cấu. Hình học không được tạo lại.

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 tham chiếu dùng để tạo kết cấu.
mesh_urlbắt buộc
Kiểustring
URL nguồn tạo lại kết cấu cho lưới 3D chưa có kết cấu ở định dạng GLB, OBJ, PLY hoặc STL.
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
5121024
Chi tiết kết cấu và tốc độ xử lý phụ thuộc vào độ phân giải tạo sinh nội bộ này: tăng giá trị sẽ tạo chi tiết mịn hơn nhưng mất nhiều thời gian 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 quá trình tạo kết cấu. Đượ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
Biên dừng hướng dẫn không dùng bộ phân loại của giai đoạn kết cấu, được chỉ định 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 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.
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.
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/retexture",
  "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": 240,
    "usd": "0.24",
    "charged": 240,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "mesh_url": "https://example.com/your-file.glb"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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/retexture.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt