Bỏ qua đến nội dung

Sam 3 · 3D Body

Tích hợp

Id mô hình sam-3/3d-body
# 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-body?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.

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

URL hình ảnh hiển thị con người.

Nâng cao mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Thả tệp hoặc

URL hình ảnh mặt nạ nhị phân tùy chọn thay thế việc phát hiện người tự động và cung cấp dữ liệu để tính hộp giới hạn tự động. Mã hóa người bằng màu trắng và nền bằng màu đen.

POST /run/sam-3/3d-body?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-body?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 Body

Tạo lưới cơ thể 3D của những người trong một ảnh. Người được tự động phát hiện hoặc bạn có thể truyền mặt nạ nhị phân trong `mask_url` (màu trắng cho người). Các tùy chọn điều khiển việc xuất .ply cho từng người, điểm đánh dấu keypoint 3D trong GLB và toàn bộ bộ tham số MHR trong siêu dữ liệu. Trả về một GLB, các lưới, siêu dữ liệu và ảnh trực quan.

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 hiển thị con người.
mask_urltùy chọn mask
Kiểuurl · image
URL hình ảnh mặt nạ nhị phân tùy chọn thay thế việc phát hiện người tự động và cung cấp dữ liệu để tính hộp giới hạn tự động. Mã hóa người bằng màu trắng và nền bằng màu đen.
export_meshestùy chọn
Kiểuboolean
Mặc địnhtrue
Có xuất một tệp lưới .ply riêng cho từng người hay không.
include_3d_keypointstùy chọn
Kiểuboolean
Mặc địnhtrue
Có thêm các điểm đánh dấu điểm then chốt 3D hình cầu vào lưới GLB để trực quan hóa hay không.
include_mhr_paramstùy chọn
Kiểuboolean
Mặc địnhtrue
Siêu dữ liệu phản hồi của từng người có bao gồm đầy đủ dữ liệu MHR (Meta Human Representation) hay chỉ các tham số máy ảnh và điểm then chốt (`false`). Dữ liệu đầy đủ bao gồm biểu cảm và hình dạng, tư thế và tư thế thô, tọa độ khớp và phép quay toàn cục, cùng các tham số mô hình được đóng gói.
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-body",
  "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": {
    "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
    },
    "meshes": [
      {
        "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": {
      "num_people": 1,
      "people": [
        {
          "person_id": 1,
          "bbox": [],
          "focal_length": 1.0,
          "pred_cam_t": [],
          "keypoints_2d": [],
          "keypoints_3d": [],
          "shape_params": [],
          "body_pose_params": [],
          "hand_pose_params": [],
          "global_rot": [],
          "pred_global_rots": [],
          "scale_params": [],
          "expr_params": [],
          "pred_joint_coords": [],
          "mhr_model_params": [],
          "pred_pose_raw": []
        }
      ],
      "keypoint_names": [
        "string"
      ]
    }
  },
  "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}Lưới cơ thể 3D định dạng GLB, tùy chọn bao gồm các điểm đánh dấu điểm then chốt 3D.
visualization
object {url, content_type, file_name, file_size}Trực quan hóa tổng hợp hiển thị hình ảnh gốc, điểm then chốt, lưới và chế độ xem bên.
meshes
array of object {url, content_type, file_name, file_size} | nullCác tệp lưới .ply riêng cho từng người được phát hiện, được trả về khi export_meshes là True.
metadata
object {num_people, people, keypoint_names}Siêu dữ liệu có cấu trúc chứa các tham số máy ảnh và điểm then chốt.

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