Bỏ qua đến nội dung

Sam 3 · 3D Align

Tích hợp

Id mô hình sam-3/3d-align
# 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/sam-3/3d-align?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",
    "body_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,02 $ 20 tín dụng API · ≈ 2,11 ₽ 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.

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

URL hình ảnh nguồn để ước tính độ sâu bằng MoGe.

•bắt buộc

URL lưới để căn chỉnh, chấp nhận tệp SAM-3D Body ở định dạng .ply hoặc .glb.

Nâng cao body_mask_url · object_mesh_url · focal_length
Thả tệp hoặc

URL hình ảnh mặt nạ người; nếu bỏ qua, toàn bộ hình ảnh sẽ được sử dụng.

URL lưới tùy chọn cho SAM-3D Object ở định dạng .glb, dùng để dựng cảnh kết hợp.

Ghi đè tiêu cự lấy từ siêu dữ liệu SAM-3D Body; sử dụng ước tính MoGe nếu không cung cấp giá trị.

POST /run/sam-3/3d-align?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.ru/v1/run/sam-3/3d-align?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",
    "body_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ề Sam 3 · 3D Align

Đặt lưới cơ thể người (.ply hoặc .glb) vào không gian tọa độ của ảnh gốc bằng ước tính độ sâu từ `image_url`. Các đầu vào tùy chọn gồm mặt nạ người, giá trị tiêu cự và lưới đối tượng (.glb) để tạo tệp cảnh kết hợp. Đầu ra gồm các lưới đã căn chỉnh ở định dạng PLY và GLB, siêu dữ liệu căn chỉnh và hình ảnh trực quan phủ lớp.

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 để ước tính độ sâu bằng MoGe.
body_mesh_urlbắt buộc
Kiểustring
URL lưới để căn chỉnh, chấp nhận tệp SAM-3D Body ở định dạng .ply hoặc .glb.
body_mask_urltùy chọn
Kiểuurl · image
URL hình ảnh mặt nạ người; nếu bỏ qua, toàn bộ hình ảnh sẽ được sử dụng.
object_mesh_urltùy chọn
Kiểustring | null
URL lưới tùy chọn cho SAM-3D Object ở định dạng .glb, dùng để dựng cảnh kết hợp.
focal_lengthtùy chọn
Kiểunumber | null
Ghi đè tiêu cự lấy từ siêu dữ liệu SAM-3D Body; sử dụng ước tính MoGe nếu không cung cấp giá trị.
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-align",
  "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",
    "body_mesh_url": "https://example.com/your-file.glb"
  },
  "output": {
    "body_mesh_ply": {
      "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
    },
    "visualization": {
      "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": {
      "person_id": 1,
      "scale_factor": 1.0,
      "translation": [
        1.0
      ],
      "focal_length": 1.0,
      "target_points_count": 1,
      "cropped_vertices_count": 1
    },
    "scene_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
body_mesh_ply
object {url, content_type, file_name, file_size}Tệp PLY chứa lưới cơ thể đã căn chỉnh.
model_glb
object {url, content_type, file_name, file_size}Tệp GLB chứa lưới cơ thể đã căn chỉnh để xem trước 3D.
visualization
object {url, content_type, file_name, file_size}Trực quan hóa hình ảnh đầu vào với lưới đã căn chỉnh chồng lên trên.
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}Chi tiết căn chỉnh, chẳng hạn như tỷ lệ và phép tịnh tiến.
scene_glb
object {url, content_type, file_name, file_size} | nullĐầu ra GLB chỉ khả dụng khi cung cấp object_mesh_url; chứa cả lưới cơ thể và đối tượng trong cùng một cảnh.

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