Pereiti prie turinio

Sam 3 · 3D Body

Integruoti

Modelio id 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"

Ši užklausa: ≈0,02 $ 20 API kreditų Paleisti šiame puslapyje

Gauti API raktą
Meta · 3D

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma image_url
Įmeskite failą arba

Vaizdą su žmonėmis rodantis URL.

Išplėstiniai mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Įmeskite failą arba

Pasirinktinis dvejetainės kaukės vaizdo URL, pakeičiantis automatinį žmonių aptikimą ir pateikiantis duomenis automatiniam ribojančiojo langelio skaičiavimui. Asmenį koduokite balta, o foną – juoda spalva.

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Sam 3 · 3D Body

Sukuria 3D nuotraukoje esančių žmonių kūno tinklelius. Žmonės aptinkami automatiškai arba galite perduoti dvejetainę kaukę per `mask_url` (balta spalva žymi žmogų). Perjungikliai valdo kiekvieno asmens .ply eksportą, 3D pagrindinių taškų žymeklius GLB faile ir visą MHR parametrų rinkinį metaduomenyse. Grąžinami GLB failas, tinkleliai, metaduomenys ir vizualizacijos vaizdas.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
image_urlprivaloma image
Tipasurl · image
Vaizdą su žmonėmis rodantis URL.
mask_urlneprivalomas mask
Tipasurl · image
Pasirinktinis dvejetainės kaukės vaizdo URL, pakeičiantis automatinį žmonių aptikimą ir pateikiantis duomenis automatiniam ribojančiojo langelio skaičiavimui. Asmenį koduokite balta, o foną – juoda spalva.
export_meshesneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Ar eksportuoti atskirą .ply tinklo failą kiekvienam asmeniui.
include_3d_keypointsneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Ar į GLB tinklą vizualizacijai įtraukti sferinius 3D pagrindinių taškų žymeklius.
include_mhr_paramsneprivalomas
Tipasboolean
Numatytoji reikšmėtrue
Ar kiekvieno asmens atsakymo metaduomenyse turi būti visi MHR (Meta Human Representation) duomenys, ar tik kameros parametrai ir pagrindiniai taškai (`false`). Visi duomenys apima išraišką ir formą, pozą ir neapdorotą pozą, sąnarių koordinates ir globaliuosius pasukimus bei supakuotus modelio parametrus.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
model_glb
object {url, content_type, file_name, file_size}GLB formato 3D kūno tinklas, pasirinktinai su 3D pagrindinių taškų žymekliais.
visualization
object {url, content_type, file_name, file_size}Sudėtinė vizualizacija, rodanti pradinį vaizdą, pagrindinius taškus, tinklą ir šoninį vaizdą.
meshes
array of object {url, content_type, file_name, file_size} | nullAtskiri .ply tinklo failai kiekvienam aptiktam asmeniui, grąžinami, kai export_meshes yra True.
metadata
object {num_people, people, keypoint_names}Struktūrizuoti metaduomenys su kameros parametrais ir pagrindiniais taškais.

Daugiau modelių: Vaizdas į 3D

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/sam-3/3d-body.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt