Bỏ qua đến nội dung

Sam 3 · 3D Objects

Tích hợp

Id mô hình sam-3/3d-objects
# 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/sam-3/3d-objects?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,02 $ 20 tín dụng API Chạy trên trang này

Lấy khóa API
Meta · 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.

mặc định car

Văn bản dùng cho phân đoạn tự động khi không có mặt nạ, chẳng hạn như 'chair' hoặc 'lamp'.

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

URL hình ảnh để tái tạo 3D.

Nâng cao mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Thả tệp hoặc

Danh sách URL mặt nạ tùy chọn cho từng đối tượng. Khi không có mặt nạ, phân đoạn tự động sử dụng lời nhắc, point_prompts hoặc box_prompts nếu được cung cấp; nếu không cung cấp mặt nạ hoặc lời nhắc phân đoạn, toàn bộ hình ảnh sẽ được sử dụng.

URL tùy chọn để cải thiện ước tính độ sâu trong tái tạo 3D bằng cách cung cấp dữ liệu pointmap hoặc độ sâu bên ngoài dưới dạng NPY hoặc NPZ.

Ngưỡng độ tin cậy phát hiện; nếu bỏ qua, sử dụng giá trị mặc định của mô hình. Giá trị nằm trong khoảng từ 0.1 đến 1.0, trong đó giá trị nhỏ hơn đánh đổi độ chính xác để tăng số lượng phát hiện.

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

mặc định []

Các lời nhắc dựa trên điểm dùng cho phân đoạn tự động khi không có mặt nạ.

mặc định []

Các lời nhắc hộp tạo ra mặt nạ riêng cho từng đối tượng để tái tạo 3D thông qua phân đoạn tự động, chỉ được sử dụng khi không cung cấp mặt nạ. Có thể gửi nhiều hộp.

POST /run/sam-3/3d-objects?wait=20 báo giá → 0,02 $
# 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/sam-3/3d-objects?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ề Sam 3 · 3D Objects

Chuyển các đối tượng trong ảnh thành tài sản 3D. Chọn đối tượng bằng `mask_urls`, `prompt` văn bản, `point_prompts` hoặc `box_prompts`; nhiều hộp sẽ tạo các đối tượng riêng biệt. `detection_threshold` nhận giá trị từ 0.1 đến 1, còn `export_textured_glb` sẽ tích hợp kết cấu và UV. Đầu ra gồm GLB, các tệp Gaussian splat, tệp cho từng đối tượng trong cảnh nhiều đối tượng, siêu dữ liệu và gói zip.

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 để tái tạo 3D.
mask_urlstùy chọn
Kiểuurl[] · image
Danh sách URL mặt nạ tùy chọn cho từng đối tượng. Khi không có mặt nạ, phân đoạn tự động sử dụng lời nhắc, point_prompts hoặc box_prompts nếu được cung cấp; nếu không cung cấp mặt nạ hoặc lời nhắc phân đoạn, toàn bộ hình ảnh sẽ được sử dụng.
prompttùy chọn
Kiểustring | null
Mặc địnhcar
Văn bản dùng cho phân đoạn tự động khi không có mặt nạ, chẳng hạn như 'chair' hoặc 'lamp'.
point_promptstùy chọn
Kiểuobject[]
Mặc định[]
Các lời nhắc dựa trên điểm dùng cho phân đoạn tự động khi không có mặt nạ.
point_prompts[].xtùy chọn
Kiểuinteger | null
Vị trí lời nhắc trên trục X.
point_prompts[].ytùy chọn
Kiểuinteger | null
Vị trí lời nhắc trên trục Y.
point_prompts[].labeltùy chọn
Kiểuenum
01
Nhãn tiền cảnh/hậu cảnh: 1 biểu thị tiền cảnh; 0 biểu thị hậu cảnh.
point_prompts[].object_idtùy chọn
Kiểuinteger | null
Mã định danh tùy chọn để nhóm các lời nhắc tinh chỉnh một vật thể duy nhất. Nếu cũng cung cấp văn bản làm lời nhắc, mã định danh này xác định vật thể được phát hiện mà các điểm đó sẽ tinh chỉnh.
box_promptstùy chọn
Kiểuobject[]
Mặc định[]
Các lời nhắc hộp tạo ra mặt nạ riêng cho từng đối tượng để tái tạo 3D thông qua phân đoạn tự động, chỉ được sử dụng khi không cung cấp mặt nạ. Có thể gửi nhiều hộp.
box_prompts[].x_mintùy chọn
Kiểuinteger | null
Tọa độ x tối thiểu của hộp.
box_prompts[].y_mintùy chọn
Kiểuinteger | null
Tọa độ y tối thiểu của hộp.
box_prompts[].x_maxtùy chọn
Kiểuinteger | null
Tọa độ X lớn nhất của hộp.
box_prompts[].y_maxtùy chọn
Kiểuinteger | null
Tọa độ Y lớn nhất của hộp.
box_prompts[].object_idtùy chọn
Kiểuinteger | null
Mã định danh tùy chọn để nhóm các hộp tinh chỉnh một vật thể duy nhất.
seedtùy chọn
Kiểuinteger | null
Seed dùng để tạo ngẫu nhiên có thể tái tạo.
pointmap_urltùy chọn
Kiểustring | null
URL tùy chọn để cải thiện ước tính độ sâu trong tái tạo 3D bằng cách cung cấp dữ liệu pointmap hoặc độ sâu bên ngoài dưới dạng NPY hoặc NPZ.
detection_thresholdtùy chọn
Kiểunumber | null
0,1 – 1
Ngưỡng độ tin cậy phát hiện; nếu bỏ qua, sử dụng giá trị mặc định của mô hình. Giá trị nằm trong khoảng từ 0.1 đến 1.0, trong đó giá trị nhỏ hơn đánh đổi độ chính xác để tăng số lượng phát hiện.
export_textured_glbtùy chọn
Kiểuboolean
Mặc địnhfalse
Tùy chọn xuất GLB: bật tùy chọn này sẽ thay màu đỉnh bằng kết cấu đã dựng sẵn và UV.
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": "sam-3/3d-objects",
  "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": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "gaussian_splat": {
      "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
    },
    "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
    },
    "metadata": [
      {
        "object_index": 1,
        "scale": [
          []
        ],
        "rotation": [
          []
        ],
        "translation": [
          []
        ],
        "camera_pose": [
          []
        ]
      }
    ],
    "individual_splats": [
      {
        "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
      }
    ],
    "individual_glbs": [
      {
        "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
      }
    ],
    "artifacts_zip": {
      "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
gaussian_splat
object {url, content_type, file_name, file_size}Splat cảnh kết hợp cho kết quả có nhiều đối tượng hoặc một splat duy nhất trong trường hợp còn lại; được cung cấp dưới dạng tệp Gaussian splat ở định dạng .ply.
model_glb
object {url, content_type, file_name, file_size}Đầu ra 3D được lưu dưới dạng GLB: nhiều đối tượng được ghép thành một cảnh, trong khi các kết quả khác chứa một lưới.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Siêu dữ liệu cho từng đối tượng, bao gồm phép quay, phép tịnh tiến và tỷ lệ.
individual_splats
array of object {url, content_type, file_name, file_size} | nullCác tệp Gaussian splat riêng cho từng đối tượng, chỉ khả dụng trong các cảnh có nhiều đối tượng.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullCác tệp lưới GLB riêng cho từng đối tượng, chỉ khả dụng trong các cảnh có nhiều đối tượng.
artifacts_zip
object {url, content_type, file_name, file_size} | nullTệp lưu trữ ZIP chứa tất cả thành phần và siêu dữ liệu.

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/sam-3/3d-objects.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt