Ruka hadi kwenye maudhui

Sam 3 · 3D Body

Unganisha

Kitambulisho cha modeli 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ombi hili: ≈$ 0.02 salio za API 20 · ≈ ₽ 2.09 Iendeshe kwenye ukurasa huu

Pata ufunguo wa API
Meta · 3D

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

•inahitajika image_url
Dondosha faili, au

URL ya picha inayoonyesha binadamu.

Ya kina mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Dondosha faili, au

URL ya hiari ya picha ya maski ya binary inayochukua nafasi ya utambuzi wa kiotomatiki wa binadamu na kutoa data kwa ukokotoaji wa visanduku vya mipaka kiotomatiki. Mtu awe mweupe na mandharinyuma meusi.

POST /run/sam-3/3d-body?wait=20 makadirio → $ 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-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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Endesha ombi hili

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Pata ufunguo wa API

Kuhusu Sam 3 · 3D Body

Hujenga mesh za miili ya 3D za watu katika picha moja. Watu hutambuliwa kiotomatiki, au unaweza kupitisha maski ya binary katika `mask_url` (nyeupe kwa mtu). Swichi hudhibiti uhamishaji wa .ply kwa kila mtu, alama za keypoint za 3D katika GLB na seti kamili ya vigezo vya MHR katika metadata. Hurejesha GLB, mesh, metadata na picha ya taswira.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo
image_urlinahitajika image
Ainaurl · image
URL ya picha inayoonyesha binadamu.
mask_urlsi lazima mask
Ainaurl · image
URL ya hiari ya picha ya maski ya binary inayochukua nafasi ya utambuzi wa kiotomatiki wa binadamu na kutoa data kwa ukokotoaji wa visanduku vya mipaka kiotomatiki. Mtu awe mweupe na mandharinyuma meusi.
export_meshessi lazima
Ainaboolean
Chaguomsingitrue
Iwapo itasafirisha faili tofauti la mesh la .ply kwa kila mtu.
include_3d_keypointssi lazima
Ainaboolean
Chaguomsingitrue
Iwapo itaongeza alama za nukta za 3D zenye umbo la duara kwenye mesh ya GLB kwa ajili ya taswira.
include_mhr_paramssi lazima
Ainaboolean
Chaguomsingitrue
Iwapo metadata ya jibu la kila mtu inajumuisha data kamili ya MHR (Meta Human Representation) au vigezo vya kamera na nukta muhimu pekee (`false`). Data kamili inajumuisha mwonekano wa uso na umbo, mkao na mkao ghafi, kuratibu za viungo na mizunguko ya jumla, pamoja na vigezo vya modeli vilivyofungwa.
inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.
Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.
Sehemu za tokeo
model_glb
object {url, content_type, file_name, file_size}Mesh ya mwili ya 3D katika muundo wa GLB, ikiweza kujumuisha alama za nukta muhimu za 3D.
visualization
object {url, content_type, file_name, file_size}Taswira iliyounganishwa inayoonyesha picha asili, nukta muhimu, mesh na mwonekano wa upande.
meshes
array of object {url, content_type, file_name, file_size} | nullFaili tofauti za mesh za .ply kwa kila mtu aliyetambuliwa, zinarejeshwa export_meshes ikiwa True.
metadata
object {num_people, people, keypoint_names}Metadata iliyopangwa iliyo na vigezo vya kamera na nukta muhimu.

Miundo zaidi: Picha hadi 3D

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/sam-3/3d-body.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt