Lompat ke konten

Sam 3 · 3D Body

Integrasikan

ID model 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"

Permintaan ini: ≈$0,02 20 kredit API · ≈ ₽2,11 Jalankan di halaman ini

Dapatkan kunci API
Meta · 3D

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib image_url
Jatuhkan file, atau

URL gambar yang menampilkan manusia.

Lanjutan mask · export_meshes · include_3d_keypoints · include_mhr_params
mask_url
Jatuhkan file, atau

URL gambar mask biner opsional yang menggantikan deteksi manusia otomatis dan menyediakan data untuk penghitungan kotak pembatas otomatis. Encode orang dengan warna putih dan latar belakang dengan warna hitam.

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

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Sam 3 · 3D Body

Membangun mesh tubuh 3D orang-orang dalam satu gambar. Orang terdeteksi secara otomatis, atau Anda dapat memberikan mask biner di `mask_url` (putih untuk orang). Sakelar mengontrol ekspor .ply per orang, penanda keypoint 3D dalam GLB, dan seluruh set parameter MHR dalam metadata. Mengembalikan GLB, mesh, metadata, dan gambar visualisasi.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
URL gambar yang menampilkan manusia.
mask_urlopsional mask
Tipeurl · image
URL gambar mask biner opsional yang menggantikan deteksi manusia otomatis dan menyediakan data untuk penghitungan kotak pembatas otomatis. Encode orang dengan warna putih dan latar belakang dengan warna hitam.
export_meshesopsional
Tipeboolean
Bawaantrue
Apakah akan mengekspor file mesh .ply terpisah untuk setiap orang.
include_3d_keypointsopsional
Tipeboolean
Bawaantrue
Apakah akan menambahkan penanda titik kunci 3D berbentuk bola ke mesh GLB untuk visualisasi.
include_mhr_paramsopsional
Tipeboolean
Bawaantrue
Apakah metadata respons setiap orang menyertakan data MHR (Meta Human Representation) lengkap atau hanya parameter kamera dan titik kunci (`false`). Data lengkap mencakup ekspresi dan bentuk, pose dan pose mentah, koordinat sendi dan rotasi global, serta parameter model yang dikemas.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
model_glb
object {url, content_type, file_name, file_size}Mesh tubuh 3D berformat GLB, yang dapat menyertakan penanda titik kunci 3D.
visualization
object {url, content_type, file_name, file_size}Visualisasi gabungan yang menampilkan gambar asli, titik kunci, mesh, dan tampilan samping.
meshes
array of object {url, content_type, file_name, file_size} | nullFile mesh .ply terpisah untuk setiap orang yang terdeteksi, dikembalikan saat export_meshes adalah True.
metadata
object {num_people, people, keypoint_names}Metadata terstruktur yang berisi parameter kamera dan titik kunci.

Model lainnya: Gambar ke 3D

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/sam-3/3d-body.md. Semua model dan panduan: https://doitong.com/developers/llms.txt