Langkau ke kandungan

Sam 3 · 3D Body

Integrasikan

ID model 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"

Permintaan ini: ≈$0.02 20 kredit API Jalankan pada halaman ini

Dapatkan kunci API
Meta · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan image_url
Lepaskan fail, atau

URL imej yang menunjukkan manusia.

Lanjutan mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Lepaskan fail, atau

URL imej topeng binari pilihan yang menggantikan pengesanan manusia automatik dan membekalkan data untuk pengiraan kotak sempadan automatik. Kodkan orang dengan warna putih dan latar belakang dengan warna hitam.

POST /run/sam-3/3d-body?wait=20 sebut harga → $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"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Sam 3 · 3D Body

Membina jejaring badan 3D bagi orang dalam satu imej. Orang dikesan secara automatik, atau anda boleh menghantar topeng perduaan dalam `mask_url` (putih untuk orang). Togol mengawal eksport .ply setiap orang, penanda titik kunci 3D dalam GLB dan set parameter MHR penuh dalam metadata. Mengembalikan GLB, jejaring, metadata dan imej visualisasi.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
URL imej yang menunjukkan manusia.
mask_urlpilihan mask
Jenisurl · image
URL imej topeng binari pilihan yang menggantikan pengesanan manusia automatik dan membekalkan data untuk pengiraan kotak sempadan automatik. Kodkan orang dengan warna putih dan latar belakang dengan warna hitam.
export_meshespilihan
Jenisboolean
Lalaitrue
Sama ada hendak mengeksport fail mesh .ply berasingan bagi setiap orang.
include_3d_keypointspilihan
Jenisboolean
Lalaitrue
Sama ada hendak menambah penanda titik utama 3D berbentuk sfera pada mesh GLB untuk visualisasi.
include_mhr_paramspilihan
Jenisboolean
Lalaitrue
Sama ada metadata respons setiap orang menyertakan data MHR (Meta Human Representation) lengkap atau hanya parameter kamera dan titik utama (`false`). Data lengkap merangkumi ekspresi dan bentuk, pose dan pose mentah, koordinat sendi dan putaran global, serta parameter model yang dipaketkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
model_glb
object {url, content_type, file_name, file_size}Mesh badan 3D berformat GLB, dengan pilihan untuk menyertakan penanda titik utama 3D.
visualization
object {url, content_type, file_name, file_size}Visualisasi komposit yang menunjukkan imej asal, titik utama, mesh dan pandangan sisi.
meshes
array of object {url, content_type, file_name, file_size} | nullFail mesh .ply berasingan bagi setiap orang yang dikesan, dikembalikan apabila export_meshes ialah True.
metadata
object {num_people, people, keypoint_names}Metadata berstruktur yang mengandungi parameter kamera dan titik utama.

Lebih banyak model: Imej ke 3D

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/sam-3/3d-body.md. Semua model dan panduan: https://doitong.com/developers/llms.txt