Lumaktaw sa nilalaman

Sam 3 · 3D Align

I-integrate

ID ng modelo 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"

Kahilingang ito: ≈$0.02 20 kredito ng API Patakbuhin ito sa page na ito

Kumuha ng API key
Meta · 3D

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan sa ibaba at patakbuhin ito gamit ang iyong API key. Kinokopya ang mga output sa aming storage, na pinananatili nang walang hanggan o 7 araw nang libre.

Bumuo ng kahilingan

Ang mga control ay binubuo mula sa schema ng modelo. Nagbabago ang code at presyo habang ina-adjust mo ang mga ito.

•kinakailangan image_url
Mag-drop ng file, o

Source larawan URL para sa depth estimation gamit ang MoGe.

•kinakailangan

Mesh URL para sa alignment, na tumatanggap ng SAM-3D Body file sa .ply o .glb format.

advanced body_mask_url · object_mesh_url · focal_length
Mag-drop ng file, o

URL ng human mask larawan; kapag inalis ito, ang buong larawan ang gagamitin.

Opsyonal na mesh URL para sa SAM-3D Object sa .glb format, na ginagamit upang bumuo ng pinagsamang eksena.

Override ng focal length mula sa metadata ng SAM-3D Body; gagamitin ang estimation ng MoGe kung walang ibinigay na value.

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

Patakbuhin ang kahilingang ito

Nananatili ang iyong key sa browser na ito: ipinapadala lamang ito sa Doitong API at sine-save (localStorage) lamang kung pipiliin mo ang Tandaan. Kumuha ng API key

Tungkol sa Sam 3 · 3D Align

Inilalagay ang human body mesh (.ply o .glb) sa coordinate space ng orihinal na larawan gamit ang depth estimation mula sa `image_url`. Opsyonal ang human mask, focal length value, at object mesh (.glb) na bumubuo ng pinagsamang scene file. Kasama sa output ang mga naka-align na mesh sa PLY at GLB, alignment metadata at overlay visualization.

Mga parameter

Ipadala ang canonical na pangalan o ang native na pangalan, hindi pareho. Mga canonical na pangalan

PangalanUri defaultPinapayagan Paglalarawan
image_urlkinakailangan image
Uriurl · image
Source larawan URL para sa depth estimation gamit ang MoGe.
body_mesh_urlkinakailangan
Uristring
Mesh URL para sa alignment, na tumatanggap ng SAM-3D Body file sa .ply o .glb format.
body_mask_urlopsyonal
Uriurl · image
URL ng human mask larawan; kapag inalis ito, ang buong larawan ang gagamitin.
object_mesh_urlopsyonal
Uristring | null
Opsyonal na mesh URL para sa SAM-3D Object sa .glb format, na ginagamit upang bumuo ng pinagsamang eksena.
focal_lengthopsyonal
Urinumber | null
Override ng focal length mula sa metadata ng SAM-3D Body; gagamitin ang estimation ng MoGe kung walang ibinigay na value.
kinakailangan Canonical na pangalan, tinatanggap din

Tumatanggap ang mga parameter ng file ng pampublikong https:// URL, data: URI na hanggang 10 MB, o file_url ng isang upload. Mga 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"
  }
}
Ikaw ang pumipili para sa iyong mga fileAng bawat outputs[].url ay kopya sa aming storage: pinananatili nang walang hanggan (sinisingil bawat GB-month) o 7 araw nang libre, ayon sa setting ng iyong account o ?storage=.
Parehong shape sa bawat modelotype, url, content_type, width, height at duration, para sa mga larawan, video at audio. Ang output ay sariling result object ng modelo.
Mga field ng output
body_mesh_ply
object {url, content_type, file_name, file_size}PLY file na naglalaman ng naka-align na body mesh.
model_glb
object {url, content_type, file_name, file_size}GLB file na naglalaman ng naka-align na body mesh para sa 3D preview.
visualization
object {url, content_type, file_name, file_size}Visualization ng input na larawan na may nakapatong na naka-align na mesh.
metadata
object {person_id, scale_factor, translation, focal_length, target_points_count, cropped_vertices_count}Mga detalye ng alignment, gaya ng scale at translation.
scene_glb
object {url, content_type, file_name, file_size} | nullGLB output na available lamang kapag ibinigay ang object_mesh_url; naglalaman ito ng body at object mesh na magkasama sa isang eksena.

Higit pang modelo: 3D

Para sa mga AI agent: nasa Markdown ang pahinang ito sa https://doitong.com/fil/developers/models/sam-3/3d-align.md. Lahat ng modelo at gabay: https://doitong.com/developers/llms.txt