Bỏ qua đến nội dung

ReconViaGen 0.5

Tích hợp

Id mô hình reconviagen-0.5
# 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/reconviagen-0.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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
Open model Hình ảnh sang 3D #multi-view#3d-reconstruction

Tái dựng hình ảnh nhiều góc nhìn thành 3D, xuất lưới GLB có kết cấu từ 1 đến 16 ảnh của một vật thể

Open model · 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_urls
Thả tệp hoặc · tối đa 16

Cung cấp các góc nhìn để tái dựng 3D: một góc nhìn là đủ, nhưng các góc nhìn bổ sung sẽ cải thiện chất lượng và tất cả phải hiển thị cùng một vật thể.

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 ss_source · texture_size · multi_image_strategy · ss_guidance_strength · ss_guidance_rescale · ss_sampling_steps · ss_rescale_t · slat_guidance_strength · slat_guidance_rescale · slat_sampling_steps · slat_rescale_t · shape_slat_guidance_strength · shape_slat_guidance_rescale · shape_slat_sampling_steps · shape_slat_rescale_t · tex_slat_guidance_strength · tex_slat_guidance_rescale · tex_slat_sampling_steps · tex_slat_rescale_t · decimation_target · seed · enable_safety_checker
ss_source mặc định mesh

Nguồn dùng để tạo cấu trúc thưa. Chọn 'direct' để đạt tốc độ tối đa, 'mesh' để đạt chất lượng cao nhất hoặc 'mvtrellis2' để xử lý đa góc nhìn với TRELLIS.2.

texture_size mặc định 2048

Độ phân giải dùng cho hình ảnh kết cấu đã nướng của mesh.

mặc định adaptive_guidance_weight

Chiến lược điều kiện hóa đa góc nhìn, chỉ áp dụng với nhiều hình ảnh đầu vào; trong hầu hết trường hợp, chọn 'adaptive_guidance_weight' để có kết quả tốt nhất.

mặc định 7.5

Kiểm soát mức độ trung thành của cấu trúc 3D ban đầu với đầu vào; khi tăng giá trị này, có thể phải đánh đổi bằng nhiều nhiễu hơn để khớp sát hơn.

mặc định 0.7

Giảm hiện tượng giả do hướng dẫn mạnh trong giai đoạn 1.

mặc định 12

Số bước khử nhiễu dùng để tạo cấu trúc ban đầu.

mặc định 5

Độ sắc của lịch nhiễu dùng khi tạo cấu trúc.

mặc định 7.5

Cường độ hướng dẫn giai đoạn SLat; chỉ áp dụng khi ss_source được đặt thành 'mesh'.

mặc định 0.5

Tái tỷ lệ hướng dẫn giai đoạn SLat; chỉ áp dụng khi ss_source được đặt thành 'mesh'.

mặc định 12

Số bước lấy mẫu giai đoạn SLat; chỉ áp dụng khi ss_source được đặt thành 'mesh'.

mặc định 3

Thiết lập Rescale T của giai đoạn SLat; chỉ áp dụng khi ss_source được đặt thành 'mesh'.

mặc định 7.5

Mức độ bám theo đầu vào khi tạo hình học chi tiết.

mặc định 0.5

Giảm hiện tượng giả do hướng dẫn mạnh trong giai đoạn hình dạng.

mặc định 12

Số bước khử nhiễu dùng để tinh chỉnh hình dạng.

mặc định 3

Độ sắc của lịch nhiễu dùng khi tinh chỉnh hình dạng.

mặc định 1

Mức độ bám theo màu sắc trong đầu vào của kết cấu.

mặc định 0

Giảm hiện tượng giả do hướng dẫn mạnh trong giai đoạn kết cấu.

mặc định 12

Số bước khử nhiễu dùng để tạo kết cấu.

mặc định 3

Độ sắc của lịch nhiễu dùng khi tạo kết cấu.

mặc định 500000

Số đỉnh mong muốn cho mesh hoàn chỉnh.

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

POST /run/reconviagen-0.5?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/reconviagen-0.5?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "images": [
      "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ề ReconViaGen 0.5

Dựng mô hình 3D từ `image_urls`, chứa 1 đến 16 góc nhìn của cùng một vật thể; nhiều góc nhìn hơn giúp cải thiện tái dựng. Trả về tệp GLB với vật liệu PBR. `resolution` có thể là 512, 1024 hoặc 1536, `texture_size` là 1024, 2048 hoặc 4096, còn `decimation_target` đặt số đỉnh lưới từ 5,000 đến 2,000,000. `ss_source` và `multi_image_strategy` chọn cách kết hợp cấu trúc và góc nhìn, với các tùy chọn hướng dẫn và lấy mẫu theo từng giai đoạn.

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_sourcetùy chọn
Kiểuenum
Mặc địnhmesh
directmeshmvtrellis2
Nguồn dùng để tạo cấu trúc thưa. Chọn 'direct' để đạt tốc độ tối đa, 'mesh' để đạt chất lượng cao nhất hoặc 'mvtrellis2' để xử lý đa góc nhìn với TRELLIS.2.
ss_guidance_strengthtùy chọn
Kiểunumber
Mặc định7.5
0 – 10
Kiểm soát mức độ trung thành của cấu trúc 3D ban đầu với đầu vào; khi tăng giá trị này, có thể phải đánh đổi bằng nhiều nhiễu hơn để khớp sát hơn.
ss_guidance_rescaletùy chọn
Kiểunumber
Mặc định0.7
0 – 1
Giảm hiện tượng giả do hướng dẫn mạnh trong giai đoạn 1.
ss_sampling_stepstùy chọn
Kiểuinteger
Mặc định12
1 – 50
Số bước khử nhiễu dùng để tạo cấu trúc ban đầu.
ss_rescale_ttùy chọn
Kiểunumber
Mặc định5
1 – 6
Độ sắc của lịch nhiễu dùng khi tạo cấu trúc.
slat_guidance_strengthtùy chọn
Kiểunumber
Mặc định7.5
0 – 10
Cường độ hướng dẫn giai đoạn SLat; chỉ áp dụng khi ss_source được đặt thành 'mesh'.
slat_guidance_rescaletùy chọn
Kiểunumber
Mặc định0.5
0 – 1
Tái tỷ lệ hướng dẫn giai đoạn SLat; chỉ áp dụng khi ss_source được đặt thành 'mesh'.
slat_sampling_stepstùy chọn
Kiểuinteger
Mặc định12
1 – 50
Số bước lấy mẫu giai đoạn SLat; chỉ áp dụng khi ss_source được đặt thành 'mesh'.
slat_rescale_ttùy chọn
Kiểunumber
Mặc định3
1 – 6
Thiết lập Rescale T của giai đoạn SLat; chỉ áp dụng khi ss_source được đặt thành 'mesh'.
shape_slat_guidance_strengthtùy chọn
Kiểunumber
Mặc định7.5
0 – 10
Mức độ bám theo đầu vào khi tạo hình học chi tiết.
shape_slat_guidance_rescaletùy chọn
Kiểunumber
Mặc định0.5
0 – 1
Giảm hiện tượng giả do hướng dẫn mạnh trong giai đoạn hình dạng.
shape_slat_sampling_stepstùy chọn
Kiểuinteger
Mặc định12
1 – 50
Số bước khử nhiễu dùng để tinh chỉnh hình dạng.
shape_slat_rescale_ttùy chọn
Kiểunumber
Mặc định3
1 – 6
Độ sắc của lịch nhiễu dùng khi tinh chỉnh hình dạng.
tex_slat_guidance_strengthtùy chọn
Kiểunumber
Mặc định1
0 – 10
Mức độ bám theo màu sắc trong đầu vào của kết cấu.
tex_slat_guidance_rescaletùy chọn
Kiểunumber
Mặc định0
0 – 1
Giảm hiện tượng giả do hướng dẫn mạnh trong giai đoạn kết cấu.
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.
tex_slat_rescale_ttùy chọn
Kiểunumber
Mặc định3
1 – 6
Độ sắc của lịch nhiễu dùng khi 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 cho mesh hoàn chỉnh.
texture_sizetùy chọn
Kiểuenum
Mặc định2048
102420484096
Độ phân giải dùng cho hình ảnh kết cấu đã nướng của mesh.
image_urlsbắt buộc images
Kiểuurl[] · image
≤ 16 mục
Cung cấp các góc nhìn để tái dựng 3D: một góc nhìn là đủ, nhưng các góc nhìn bổ sung sẽ cải thiện chất lượng và tất cả phải hiển thị cùng một vật thể.
multi_image_strategytùy chọn
Kiểuenum
Mặc địnhadaptive_guidance_weight
average_rightweighted_averagesequentialaverageadaptive_guidance_weightfixed_guidance_rescale
Chiến lược điều kiện hóa đa góc nhìn, chỉ áp dụng với nhiều hình ảnh đầu vào; trong hầu hết trường hợp, chọn 'adaptive_guidance_weight' để có kết quả tốt nhất.
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": "reconviagen-0.5",
  "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_urls": [
      "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
  },
  "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}GLB được tạo chứa mô hình 3D với vật liệu PBR.
seed
integerSeed được áp dụng trong quá trình tạo sinh.

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