Passer au contenu

Sam 3 · 3D Body

Intégrer

Identifiant du modèle 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"

Cette requête: ≈0,02 $ 20 crédits API L’exécuter sur cette page

Obtenir une clé API
Meta · 3D

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•requis image_url
Déposez un fichier, ou

URL de l'image montrant des personnes.

Avancé mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Déposez un fichier, ou

URL facultative de l'image d'un masque binaire qui remplace la détection humaine automatique et fournit les données nécessaires au calcul automatique des boîtes englobantes. Encodez la personne en blanc et l'arrière-plan en noir.

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

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Sam 3 · 3D Body

Construit des maillages 3D des personnes présentes dans une image. Les personnes sont détectées automatiquement, ou vous pouvez fournir un masque binaire dans `mask_url` (blanc pour la personne). Des options contrôlent l’export .ply par personne, les marqueurs de points clés 3D dans le GLB et l’ensemble complet de paramètres MHR dans les métadonnées. Renvoie un GLB, les maillages, les métadonnées et une image de visualisation.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
image_urlrequis image
Typeurl · image
URL de l'image montrant des personnes.
mask_urlfacultatif mask
Typeurl · image
URL facultative de l'image d'un masque binaire qui remplace la détection humaine automatique et fournit les données nécessaires au calcul automatique des boîtes englobantes. Encodez la personne en blanc et l'arrière-plan en noir.
export_meshesfacultatif
Typeboolean
Par défauttrue
Indique s'il faut exporter un fichier de maillage .ply distinct pour chaque personne.
include_3d_keypointsfacultatif
Typeboolean
Par défauttrue
Indique s'il faut ajouter des marqueurs sphériques de points clés 3D au maillage GLB pour la visualisation.
include_mhr_paramsfacultatif
Typeboolean
Par défauttrue
Indique si les métadonnées de réponse de chaque personne incluent les données MHR (Meta Human Representation) complètes ou uniquement les paramètres de caméra et les points clés (`false`). Les données complètes couvrent l'expression et la forme, la pose et la pose brute, les coordonnées des articulations et les rotations globales, ainsi que les paramètres de modèle regroupés.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
model_glb
object {url, content_type, file_name, file_size}Maillage corporel 3D au format GLB, incluant éventuellement des marqueurs pour les points clés 3D.
visualization
object {url, content_type, file_name, file_size}Visualisation composite montrant l'image originale, les points clés, le maillage et la vue latérale.
meshes
array of object {url, content_type, file_name, file_size} | nullFichiers de maillage .ply distincts pour chaque personne détectée, renvoyés lorsque export_meshes est True.
metadata
object {num_people, people, keypoint_names}Métadonnées structurées contenant les paramètres de caméra et les points clés.

Plus de modèles : Image vers 3D

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/sam-3/3d-body.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt