Zum Inhalt springen

Sam 3 · 3D Body

Integrieren

Modell-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"

Diese Anfrage: ≈0,02 $ 20 API-Credits · ≈ 2,11 ₽ Auf dieser Seite ausführen

API-Schlüssel abrufen
Meta · 3D

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich image_url
Datei ablegen oder

Bild-URL mit Menschen.

Erweitert mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Datei ablegen oder

Optionale URL eines binären Maskenbilds, die die automatische Erkennung von Menschen ersetzt und die Daten für die automatische Berechnung der Bounding Box liefert. Die Person muss weiß und der Hintergrund schwarz kodiert werden.

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

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über Sam 3 · 3D Body

Erstellt 3D-Körpernetze der Personen in einem Bild. Personen werden automatisch erkannt, oder Sie übergeben eine Binärmaske in `mask_url` (weiß für die Person). Schalter steuern den .ply-Export pro Person, 3D-Keypoint-Markierungen im GLB und den vollständigen MHR-Parametersatz in den Metadaten. Gibt einen GLB, Netze, Metadaten und ein Visualisierungsbild zurück.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
image_urlerforderlich image
Typurl · image
Bild-URL mit Menschen.
mask_urloptional mask
Typurl · image
Optionale URL eines binären Maskenbilds, die die automatische Erkennung von Menschen ersetzt und die Daten für die automatische Berechnung der Bounding Box liefert. Die Person muss weiß und der Hintergrund schwarz kodiert werden.
export_meshesoptional
Typboolean
Standardtrue
Gibt an, ob für jede Person eine separate .ply-Mesh-Datei exportiert werden soll.
include_3d_keypointsoptional
Typboolean
Standardtrue
Gibt an, ob zur Visualisierung sphärische 3D-Keypoint-Marker zum GLB-Mesh hinzugefügt werden sollen.
include_mhr_paramsoptional
Typboolean
Standardtrue
Gibt an, ob die Antwortmetadaten jeder Person vollständige MHR-Daten (Meta Human Representation) oder nur Kameraparameter und Keypoints (`false`) enthalten. Die vollständigen Daten umfassen Ausdruck und Form, Pose und Rohpose, Gelenkkoordinaten und globale Rotationen sowie gepackte Modellparameter.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
model_glb
object {url, content_type, file_name, file_size}3D-Body-Mesh im GLB-Format, optional einschließlich Markern für 3D-Keypoints.
visualization
object {url, content_type, file_name, file_size}Zusammengesetzte Visualisierung mit Originalbild, Keypoints, Mesh und Seitenansicht.
meshes
array of object {url, content_type, file_name, file_size} | nullSeparate .ply-Mesh-Dateien für jede erkannte Person, zurückgegeben, wenn export_meshes auf True gesetzt ist.
metadata
object {num_people, people, keypoint_names}Strukturierte Metadaten mit Kameraparametern und Keypoints.

Weitere Modelle: Bild zu 3D

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/sam-3/3d-body.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt