שפּרינגען צו אינהאַלט

Sam 3 · 3D Body

אינטעגרירן

מאָדעל־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"

דער דאָזיקער ריקוועסט: ≈⁨$ 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
לייגט אַרײַן אַ טעקע, אָדער

אָפּציאָנעלער 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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן Sam 3 · 3D Body

בויט 3D קערפּער־מעשעס פֿון די מענטשן אין איין בילד. מענטשן ווערן אויטאָמאַטיש דערקענט, אָדער מע קען צושטעלן אַ בינאַרע מאַסקע אין `mask_url` (ווײַס פֿאַר מענטש). באַשטימערס קאָנטראָלירן .ply עקספּאָרט פֿאַר יעדן מענטש, 3D שליסל־פּונקט־מאַרקירונגען אין דעם GLB און דעם פולן MHR פּאַראַמעטער־סעט אין די מעטאַדאַטן. גיט צוריק אַ GLB, מעשעס, מעטאַדאַטן און אַ וויזואַליזאַציע־בילד.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
image_urlפארלאנגט image
טיפּurl · image
URL פֿון אַ בילד וואָס ווײַזט מענטשן.
mask_urlאָפּציאָנעל mask
טיפּurl · image
אָפּציאָנעלער URL פֿון אַ בינאַרן מאַסקע־בילד וואָס פֿאַרבײַט אויטאָמאַטישע מענטשן־דערקענונג און גיט די דאַטן פֿאַר אויטאָמאַטישער אויסרעכענונג פֿון באַגרענעצונגס־קעסטלעך. קאָדירט דעם מענטש אין ווײַס און דעם הינטערגרונט אין שוואַרץ.
export_meshesאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
צי צו עקספּאָרטירן אַ באַזונדערן .ply־נעץ־פֿײַל פֿאַר יעדן מענטש.
include_3d_keypointsאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
צי צוצוגעבן קײַלעכדיקע 3D־שליסלפּונקט־מאַרקירונגען צו דער GLB־נעץ פֿאַר וויזואַליזאַציע.
include_mhr_paramsאָפּציאָנעל
טיפּboolean
סטאַנדאַרטtrue
צי די ענטפֿער־מעטאַדאַטן פֿון יעדן מענטש זאָלן אַרײַננעמען גאַנצע MHR (Meta Human Representation)־דאַטן אָדער נאָר קאַמערע־פּאַראַמעטערס און שליסלפּונקטן (`false`). די גאַנצע דאַטן דעקן אויסדרוק און פֿאָרעם, פּאָזע און רויע פּאָזע, געלענק־קאָאָרדינאַטן און גלאָבאַלע דרייונגען, ווי אויך געפּאַקטע מאָדעל־פּאַראַמעטערס.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם 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־חודש) אָדער 7 טעג אומזיסט, לויט אײַער חשבון־באַשטעטיקונג אָדער ?storage=.
דער זעלבער פֿאָרעם בײַ יעדן מאָדעלtype, url, content_type, width, height און duration, סײַ פֿאַר בילדער, ווידעאָ און אַודיאָ. output איז דער אייגענער רעזולטאַט־אָביעקט פֿון מאָדעל.
פֿעלדער פֿון דער אויסגאַבע
model_glb
object {url, content_type, file_name, file_size}3D־קערפּער־נעץ אין GLB־פֿאָרמאַט, אָפּציאָנעל מיט מאַרקירונגען פֿאַר 3D־שליסלפּונקטן.
visualization
object {url, content_type, file_name, file_size}צונויפֿגעשטעלטע וויזואַליזאַציע וואָס ווײַזט דאָס אָריגינעלע בילד, שליסלפּונקטן, די נעץ און אַ זײַטן־בליק.
meshes
array of object {url, content_type, file_name, file_size} | nullבאַזונדערע .ply־נעץ־פֿײַל פֿאַר יעדן דערקענטן מענטש, צוריקגעגעבן ווען export_meshes איז True.
metadata
object {num_people, people, keypoint_names}סטרוקטורירטע מעטאַדאַטן מיט קאַמערע־פּאַראַמעטערס און שליסלפּונקטן.

מער מאָדעלן: בילד צו 3D

פֿאַר AI־אַגענטן: דער בלאַט ווי Markdown געפֿינט זיך בײַ https://doitong.com/yi/developers/models/sam-3/3d-body.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt