Léim chuig an ábhar

Sam 3 · 3D Body

Comhtháthú

Aitheantas na samhla 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"

An t-iarratas seo: ≈$0.02 20 gcreidmheas API · ≈ ₽2.09 Rith ar an leathanach seo

Faigh eochair API
Meta Íomhá go 3D #3d#human#pose

Athchruthaíonn sé mogalraí coirp daonna 3T ó ghrianghraf aonair, ceann amháin in aghaidh an duine a aimsítear

Meta · 3D

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

•riachtanach image_url
Scaoil comhad, nó

URL íomhá ina dtaispeántar daoine.

Ardleibhéal mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Scaoil comhad, nó

URL roghnach d'íomhá masc dhénártha a chuireann braite uathoibríoch daoine ina hionad agus a sholáthraíonn na sonraí le haghaidh ríomh uathoibríoch an bhosca teorannaithe. Ionchódaigh an duine i mbán agus an cúlra i ndubh.

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

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Sam 3 · 3D Body

Tógann sé mogalraí coirp 3T de na daoine in íomhá amháin. Aimsítear daoine go huathoibríoch, nó is féidir masc dénártha a thabhairt in `mask_url` (bán don duine). Rialaíonn scoránaigh easpórtáil .ply in aghaidh an duine, marcóirí eochairphointí 3T sa GLB agus an tacar iomlán paraiméadar MHR sna meiteashonraí. Filleann sé GLB, mogalraí, meiteashonraí agus íomhá léirshamhlaithe.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
image_urlriachtanach image
Cineálurl · image
URL íomhá ina dtaispeántar daoine.
mask_urlroghnach mask
Cineálurl · image
URL roghnach d'íomhá masc dhénártha a chuireann braite uathoibríoch daoine ina hionad agus a sholáthraíonn na sonraí le haghaidh ríomh uathoibríoch an bhosca teorannaithe. Ionchódaigh an duine i mbán agus an cúlra i ndubh.
export_meshesroghnach
Cineálboolean
Réamhshocrútrue
Cibé acu ar cheart comhad mogall .ply ar leithligh a easpórtáil do gach duine.
include_3d_keypointsroghnach
Cineálboolean
Réamhshocrútrue
Cibé acu ar cheart marcóirí sféarúla pointí eochair 3T a chur leis an mogall GLB le haghaidh amharcléirithe.
include_mhr_paramsroghnach
Cineálboolean
Réamhshocrútrue
Cibé acu a chuimsíonn meiteashonraí freagartha gach duine sonraí iomlána MHR (Meta Human Representation) nó paraiméadair ceamara agus pointí eochair amháin (`false`). Clúdaíonn na sonraí iomlána léiriú agus cruth, staidiúir agus staidiúir amh, comhordanáidí alt agus rothluithe domhanda, chomh maith le paraiméadair mhúnla phacáilte.
riachtanach Ainm canónach, glactar leis freisin

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

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"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
model_glb
object {url, content_type, file_name, file_size}Mogall coirp 3T i bhformáid GLB, agus marcóirí do phointí eochair 3T san áireamh go roghnach.
visualization
object {url, content_type, file_name, file_size}Amharcléiriú ilchodach a thaispeánann an íomhá bhunaidh, pointí eochair, an mogall agus taobh-amharc.
meshes
array of object {url, content_type, file_name, file_size} | nullComhaid mhogalra .ply ar leithligh do gach duine braite, tugtha ar ais nuair atá export_meshes socraithe mar True.
metadata
object {num_people, people, keypoint_names}Meiteashonraí struchtúrtha ina bhfuil paraiméadair cheamara agus pointí eochair.

Tuilleadh samhlacha: Íomhá go 3D

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/sam-3/3d-body.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt