Lumaktaw sa nilalaman

Sam 3 · 3D Body

I-integrate

ID ng modelo 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"

Kahilingang ito: ≈$0.02 20 kredito ng API Patakbuhin ito sa page na ito

Kumuha ng API key
Meta · 3D

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan sa ibaba at patakbuhin ito gamit ang iyong API key. Kinokopya ang mga output sa aming storage, na pinananatili nang walang hanggan o 7 araw nang libre.

Bumuo ng kahilingan

Ang mga control ay binubuo mula sa schema ng modelo. Nagbabago ang code at presyo habang ina-adjust mo ang mga ito.

•kinakailangan image_url
Mag-drop ng file, o

URL ng larawan na nagpapakita ng mga tao.

advanced mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Mag-drop ng file, o

Opsyonal na URL ng binary mask larawan na pumapalit sa awtomatikong human detection at nagbibigay ng data para sa awtomatikong pagkalkula ng bounding box. I-encode ang tao bilang puti at ang background bilang itim.

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

Patakbuhin ang kahilingang ito

Nananatili ang iyong key sa browser na ito: ipinapadala lamang ito sa Doitong API at sine-save (localStorage) lamang kung pipiliin mo ang Tandaan. Kumuha ng API key

Tungkol sa Sam 3 · 3D Body

Bumubuo ng 3D body mesh ng mga tao sa isang larawan. Awtomatikong nade-detect ang mga tao, o maaari kang magpasa ng binary mask sa `mask_url` (puti para sa tao). Kinokontrol ng mga toggle ang per-person .ply export, 3D keypoint marker sa GLB, at buong MHR parameter set sa metadata. Nagbabalik ng GLB, mesh, metadata at visualization larawan.

Mga parameter

Ipadala ang canonical na pangalan o ang native na pangalan, hindi pareho. Mga canonical na pangalan

PangalanUri defaultPinapayagan Paglalarawan
image_urlkinakailangan image
Uriurl · image
URL ng larawan na nagpapakita ng mga tao.
mask_urlopsyonal mask
Uriurl · image
Opsyonal na URL ng binary mask larawan na pumapalit sa awtomatikong human detection at nagbibigay ng data para sa awtomatikong pagkalkula ng bounding box. I-encode ang tao bilang puti at ang background bilang itim.
export_meshesopsyonal
Uriboolean
defaulttrue
Kung mag-e-export ng hiwalay na .ply mesh file para sa bawat tao.
include_3d_keypointsopsyonal
Uriboolean
defaulttrue
Kung magdaragdag ng mga spherical 3D keypoint marker sa GLB mesh para sa visualization.
include_mhr_paramsopsyonal
Uriboolean
defaulttrue
Kung isasama sa metadata ng response ng bawat tao ang kumpletong MHR (Meta Human Representation) data o mga parameter ng camera at keypoint lamang (`false`). Saklaw ng kumpletong data ang expression at shape, pose at raw pose, joint coordinate at global rotation, pati mga naka-pack na parameter ng modelo.
kinakailangan Canonical na pangalan, tinatanggap din

Tumatanggap ang mga parameter ng file ng pampublikong https:// URL, data: URI na hanggang 10 MB, o file_url ng isang upload. Mga file

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"
  }
}
Ikaw ang pumipili para sa iyong mga fileAng bawat outputs[].url ay kopya sa aming storage: pinananatili nang walang hanggan (sinisingil bawat GB-month) o 7 araw nang libre, ayon sa setting ng iyong account o ?storage=.
Parehong shape sa bawat modelotype, url, content_type, width, height at duration, para sa mga larawan, video at audio. Ang output ay sariling result object ng modelo.
Mga field ng output
model_glb
object {url, content_type, file_name, file_size}3D body mesh sa GLB format, na maaaring magsama ng mga marker para sa 3D keypoint.
visualization
object {url, content_type, file_name, file_size}Composite visualization na nagpapakita ng orihinal na larawan, mga keypoint, mesh, at side view.
meshes
array of object {url, content_type, file_name, file_size} | nullHiwa-hiwalay na .ply mesh file para sa bawat natukoy na tao, ibinabalik kapag True ang export_meshes.
metadata
object {num_people, people, keypoint_names}Structured metadata na naglalaman ng mga parameter ng camera at keypoint.

Higit pang modelo: Larawan patungong 3D

Para sa mga AI agent: nasa Markdown ang pahinang ito sa https://doitong.com/fil/developers/models/sam-3/3d-body.md. Lahat ng modelo at gabay: https://doitong.com/developers/llms.txt