Мазмұнға өту

Sam 3 · 3D Body

Интеграциялау

Модель идентификаторы 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"

Осы сұрау: ≈0,02 $ 20 API кредиті Осы бетте іске қосу

API кілтін алу
Meta Кескіннен 3D-ге #3d#human#pose

Бір фотосуреттен адам денесінің 3D торларын қалпына келтіреді, анықталған әр адамға бір тордан

Meta · 3D

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті image_url
Файлды тастаңыз немесе

Адамдар көрінетін кескін URL мекенжайы.

Қосымша mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Файлды тастаңыз немесе

Автоматты адам анықтауын алмастыратын және bounding box автоматты есептеуіне дерек беретін қосымша екілік маска кескінінің URL мекенжайы. Адамды ақ, фонды қара түспен кодтаңыз.

POST /run/sam-3/3d-body?wait=20 бағасы → 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"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Sam 3 · 3D Body туралы

Бір суреттегі адамдардың 3D дене торларын жасайды. Адамдар автоматты түрде анықталады немесе `mask_url` арқылы екілік масканы беруге болады (адам үшін ақ түс). Ауыстырып-қосқыштар әр адамға арналған .ply экспортын, GLB ішіндегі 3D негізгі нүкте маркерлерін және метадеректердегі толық MHR параметрлер жиынын басқарады. GLB, торлар, метадеректер және визуализация суретін қайтарады.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
image_urlміндетті image
Түріurl · image
Адамдар көрінетін кескін URL мекенжайы.
mask_urlміндетті емес mask
Түріurl · image
Автоматты адам анықтауын алмастыратын және bounding box автоматты есептеуіне дерек беретін қосымша екілік маска кескінінің URL мекенжайы. Адамды ақ, фонды қара түспен кодтаңыз.
export_meshesміндетті емес
Түріboolean
Әдепкіtrue
Әр адам үшін бөлек .ply mesh файлын экспорттау керек пе.
include_3d_keypointsміндетті емес
Түріboolean
Әдепкіtrue
Визуализация үшін GLB mesh-іне сфералық 3D keypoint маркерлерін қосу керек пе.
include_mhr_paramsміндетті емес
Түріboolean
Әдепкіtrue
Әр адамның жауап метадеректерінде толық MHR (Meta Human Representation) деректері болуы керек пе, әлде тек камера параметрлері мен keypoint мәндері (`false`) болуы керек пе. Толық деректерге expression және shape, pose және raw pose, joint координаталары мен global rotation мәндері, сондай-ақ оралған модель параметрлері кіреді.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

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"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
model_glb
object {url, content_type, file_name, file_size}Қосымша 3D keypoint маркерлері болуы мүмкін GLB форматындағы 3D дене mesh-і.
visualization
object {url, content_type, file_name, file_size}Бастапқы кескінді, keypoint мәндерін, mesh-ті және бүйір көріністі көрсететін құрамдастырылған визуализация.
meshes
array of object {url, content_type, file_name, file_size} | nullАнықталған әр адамға арналған бөлек .ply mesh файлдары; export_meshes True болғанда қайтарылады.
metadata
object {num_people, people, keypoint_names}Камера параметрлері мен keypoint мәндері бар құрылымдалған метадеректер.

Қосымша модельдер: Кескіннен 3D-ге

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/sam-3/3d-body.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt