Naar inhoud springen

Sam 3 · 3D Body

Integreren

Model-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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Deze request: ≈$ 0,02 20 API-tegoed · ≈ ₽ 2,09 Op deze pagina uitvoeren

API-sleutel ophalen
Meta · 3D

Je eerste resultaat komt hier

Bouw hieronder een request en voer die uit met je API-sleutel. Uitvoer wordt naar onze opslag gekopieerd en voor altijd of 7 dagen gratis bewaard.

Een aanvraag samenstellen

Besturingselementen worden gegenereerd op basis van het modelschema. De code en de prijs worden bijgewerkt terwijl je ze wijzigt.

•verplicht image_url
Sleep een bestand hierheen of

Afbeeldings-URL waarop mensen te zien zijn.

Geavanceerd mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Sleep een bestand hierheen of

Optionele URL van een binaire maskerafbeelding die automatische mensdetectie vervangt en de gegevens levert voor automatische berekening van kaders. Codeer de persoon in wit en de achtergrond in zwart.

POST /run/sam-3/3d-body?wait=20 prijsopgave → $ 0,02
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Deze request uitvoeren

Je sleutel blijft in deze browser: hij wordt alleen naar de Doitong API verzonden en alleen in localStorage opgeslagen als je Onthouden aanvinkt. API-sleutel ophalen

Over Sam 3 · 3D Body

Bouwt 3D-lichaamsmeshes van de personen in één afbeelding. Personen worden automatisch gedetecteerd, of je kunt een binair masker doorgeven in `mask_url` (wit voor de persoon). Schakelaars regelen export van .ply per persoon, 3D-keypointmarkeringen in de GLB en de volledige MHR-parameterset in de metadata. Retourneert een GLB, meshes, metadata en een visualisatieafbeelding.

Parameters

Stuur de canonieke naam of de oorspronkelijke naam, niet beide. Canonieke namen

NaamType StandaardToegestaan Beschrijving
image_urlverplicht image
Typeurl · image
Afbeeldings-URL waarop mensen te zien zijn.
mask_urloptioneel mask
Typeurl · image
Optionele URL van een binaire maskerafbeelding die automatische mensdetectie vervangt en de gegevens levert voor automatische berekening van kaders. Codeer de persoon in wit en de achtergrond in zwart.
export_meshesoptioneel
Typeboolean
Standaardtrue
Of voor elke persoon een afzonderlijk .ply-meshbestand moet worden geëxporteerd.
include_3d_keypointsoptioneel
Typeboolean
Standaardtrue
Of bolvormige 3D-keypointmarkeringen aan de GLB-mesh moeten worden toegevoegd voor visualisatie.
include_mhr_paramsoptioneel
Typeboolean
Standaardtrue
Of de responsmetadata van elke persoon volledige MHR-gegevens (Meta Human Representation) bevat, of alleen camer parameters en keypoints (`false`). Volledige gegevens omvatten expressie en vorm, pose en ruwe pose, gewrichtscoördinaten en globale rotaties, plus verpakte modelparameters.
verplicht Canonieke naam, ook geaccepteerd

Bestandsparameters accepteren een openbare https:// URL, een data: URI tot 10 MB of de file_url van een upload. Bestanden

Uitvoer

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Jouw bestanden, jouw keuzeElke outputs[].url is een kopie in onze opslag: voor altijd bewaard (betaald per GB-maand) of 7 dagen gratis, volgens je accountinstelling of ?storage=.
Dezelfde structuur voor elk modeltype, url, content_type, width, height en duration, voor afbeeldingen, video en audio. output is het eigen resultaatobject van het model.
Velden van de uitvoer
model_glb
object {url, content_type, file_name, file_size}3D-body-mesh in GLB-indeling, optioneel inclusief markeringen voor 3D-keypoints.
visualization
object {url, content_type, file_name, file_size}Samengestelde visualisatie met de oorspronkelijke afbeelding, keypoints, mesh en zijaanzicht.
meshes
array of object {url, content_type, file_name, file_size} | nullAfzonderlijke .ply-meshbestanden voor elke gedetecteerde persoon, geretourneerd wanneer export_meshes True is.
metadata
object {num_people, people, keypoint_names}Gestructureerde metadata met cameraparameters en keypoints.

Meer modellen: Afbeelding naar 3D

Voor AI-agents: deze pagina als Markdown staat op https://doitong.com/nl/developers/models/sam-3/3d-body.md. Alle modellen en handleidingen: https://doitong.com/developers/llms.txt