Lompat ke konten

Sam 3 · 3D Align

Integrasikan

ID model sam-3/3d-align
# 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-align?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",
    "body_mesh_url": "https://example.com/your-file.glb"
  }'

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

Permintaan ini: ≈$0,02 20 kredit API Jalankan di halaman ini

Dapatkan kunci API
Meta 3D #align#3d

Menyelaraskan mesh tubuh SAM 3D dengan adegan foto sumber, dengan opsi menggabungkannya bersama mesh objek

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 sumber untuk estimasi kedalaman dengan MoGe.

•wajib

URL mesh untuk penyelarasan, yang menerima file SAM-3D Body dalam format .ply atau .glb.

Lanjutan body_mask_url · object_mesh_url · focal_length
Jatuhkan file, atau

URL gambar mask manusia; jika dihilangkan, seluruh gambar digunakan.

URL mesh opsional untuk SAM-3D Object dalam format .glb, yang digunakan untuk membangun scene gabungan.

Override panjang fokus yang bersumber dari metadata SAM-3D Body; estimasi MoGe digunakan jika tidak ada nilai yang diberikan.

POST /run/sam-3/3d-align?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.com/v1/run/sam-3/3d-align?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",
    "body_mesh_url": "https://example.com/your-file.glb"
  }'

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

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 Align

Menempatkan mesh tubuh manusia (.ply atau .glb) ke dalam ruang koordinat foto asli menggunakan estimasi kedalaman dari `image_url`. Input opsional mencakup mask manusia, nilai panjang fokus, dan mesh objek (.glb) yang menghasilkan file adegan gabungan. Output mencakup mesh yang disejajarkan dalam PLY dan GLB, metadata penyelarasan, serta visualisasi overlay.

Parameter

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

NamaTipe BawaanDiizinkan Deskripsi
image_urlwajib image
Tipeurl · image
URL gambar sumber untuk estimasi kedalaman dengan MoGe.
body_mesh_urlwajib
Tipestring
URL mesh untuk penyelarasan, yang menerima file SAM-3D Body dalam format .ply atau .glb.
body_mask_urlopsional
Tipeurl · image
URL gambar mask manusia; jika dihilangkan, seluruh gambar digunakan.
object_mesh_urlopsional
Tipestring | null
URL mesh opsional untuk SAM-3D Object dalam format .glb, yang digunakan untuk membangun scene gabungan.
focal_lengthopsional
Tipenumber | null
Override panjang fokus yang bersumber dari metadata SAM-3D Body; estimasi MoGe digunakan jika tidak ada nilai yang diberikan.
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-align",
  "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",
    "body_mesh_url": "https://example.com/your-file.glb"
  },
  "output": {
    "body_mesh_ply": {
      "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
    },
    "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
    },
    "metadata": {
      "person_id": 1,
      "scale_factor": 1.0,
      "translation": [
        1.0
      ],
      "focal_length": 1.0,
      "target_points_count": 1,
      "cropped_vertices_count": 1
    },
    "scene_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
    }
  },
  "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"
  }
}
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
body_mesh_ply
object {url, content_type, file_name, file_size}File PLY yang berisi mesh tubuh yang telah diselaraskan.
model_glb
object {url, content_type, file_name, file_size}File GLB yang berisi mesh tubuh yang telah diselaraskan untuk pratinjau 3D.
visualization
object {url, content_type, file_name, file_size}Visualisasi gambar input dengan mesh yang telah diselaraskan ditumpangkan.
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}Detail penyelarasan, seperti skala dan translasi.
scene_glb
object {url, content_type, file_name, file_size} | nullOutput GLB hanya tersedia jika object_mesh_url diberikan; output ini berisi mesh tubuh dan objek bersama-sama dalam satu scene.

Model lainnya: 3D

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