உள்ளடக்கத்திற்குச் செல்க

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 விசையைப் பெறுக

ஒரே புகைப்படத்திலிருந்து கண்டறியப்பட்ட ஒவ்வொரு நபருக்கும் 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-க்கு மட்டும் அனுப்பப்படும்; Remember-ஐத் தேர்ந்தெடுத்தால் மட்டுமே (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
தானியங்கி மனிதக் கண்டறிதலை மாற்றி, தானியங்கி எல்லைப் பெட்டி கணக்கீட்டிற்கான தரவை வழங்கும் விருப்ப பைனரி முகமூடிப் பட 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) தரவு அல்லது கேமரா அளவுருக்கள் மற்றும் கீபாயிண்ட்கள் (`false`) மட்டும் உள்ளதா என்பதைக் குறிப்பிடுகிறது. முழுமையான தரவில் வெளிப்பாடு மற்றும் வடிவம், போஸ் மற்றும் மூல போஸ், மூட்டு ஆயத்தொலைவுகள் மற்றும் உலகளாவிய சுழற்சிகள், மேலும் தொகுக்கப்பட்ட மாதிரி அளவுருக்கள் அடங்கும்.
தேவை நியமப் பெயர், இதுவும் ஏற்கப்படும்

கோப்பு அளவுருக்கள் பொதுவான 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 கீபாயிண்ட்களுக்கான மார்க்கர்களை உள்ளடக்கிய 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/ta/developers/models/sam-3/3d-body.md. அனைத்து மாடல்களும் வழிகாட்டிகளும்: https://doitong.com/developers/llms.txt