Langkau ke kandungan

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 pada halaman ini

Dapatkan kunci API
Meta 3D #align#3d

Menjajarkan jejaring badan SAM 3D dengan adegan foto sumber, secara pilihan menggabungkannya dengan jejaring objek

Meta · 3D

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan image_url
Lepaskan fail, atau

URL imej sumber untuk anggaran kedalaman dengan MoGe.

•diperlukan

URL mesh untuk penjajaran, menerima fail SAM-3D Body dalam format .ply atau .glb.

Lanjutan body_mask_url · object_mesh_url · focal_length
Lepaskan fail, atau

URL imej topeng manusia; jika tidak disertakan, seluruh imej digunakan.

URL mesh pilihan untuk SAM-3D Object dalam format .glb, digunakan untuk membina adegan gabungan.

Penggantian panjang fokus daripada metadata SAM-3D Body, dengan anggaran MoGe digunakan jika tiada nilai dibekalkan.

POST /run/sam-3/3d-align?wait=20 sebut 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

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Sam 3 · 3D Align

Meletakkan jejaring badan manusia (.ply atau .glb) ke dalam ruang koordinat foto asal, menggunakan anggaran kedalaman daripada `image_url`. Input pilihan ialah topeng manusia, nilai panjang fokus dan jejaring objek (.glb) yang menghasilkan fail adegan gabungan. Output merangkumi jejaring sejajar dalam PLY dan GLB, metadata penjajaran serta visualisasi tindanan.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
image_urldiperlukan image
Jenisurl · image
URL imej sumber untuk anggaran kedalaman dengan MoGe.
body_mesh_urldiperlukan
Jenisstring
URL mesh untuk penjajaran, menerima fail SAM-3D Body dalam format .ply atau .glb.
body_mask_urlpilihan
Jenisurl · image
URL imej topeng manusia; jika tidak disertakan, seluruh imej digunakan.
object_mesh_urlpilihan
Jenisstring | null
URL mesh pilihan untuk SAM-3D Object dalam format .glb, digunakan untuk membina adegan gabungan.
focal_lengthpilihan
Jenisnumber | null
Penggantian panjang fokus daripada metadata SAM-3D Body, dengan anggaran MoGe digunakan jika tiada nilai dibekalkan.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
body_mesh_ply
object {url, content_type, file_name, file_size}Fail PLY yang mengandungi mesh badan yang dijajarkan.
model_glb
object {url, content_type, file_name, file_size}Fail GLB yang mengandungi mesh badan yang dijajarkan untuk pratonton 3D.
visualization
object {url, content_type, file_name, file_size}Visualisasi imej input dengan mesh yang dijajarkan ditindankan.
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}Butiran penjajaran, seperti skala dan terjemahan.
scene_glb
object {url, content_type, file_name, file_size} | nullOutput GLB hanya tersedia apabila object_mesh_url dibekalkan; ia mengandungi mesh badan dan objek bersama-sama dalam satu adegan.

Lebih banyak model: 3D

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