Lumaktaw sa nilalaman

Sam 3 · 3D Objects

I-integrate

ID ng modelo sam-3/3d-objects
# 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-objects?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.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 Larawan patungong 3D #3d#object

Nagre-reconstruct ng mga 3D object mula sa isang larawan, na pinipili gamit ang teksto, point o box prompt o mask, na may splat output

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.

default na car

Text na ginagamit para sa awtomatikong segmentation kapag walang mask, gaya ng 'chair' o 'lamp'.

•kinakailangan image_url
Mag-drop ng file, o

URL ng larawan para sa 3D reconstruction.

advanced mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Mag-drop ng file, o

Opsyonal na listahan ng mask URL bawat object. Kung walang mask, gagamit ang awtomatikong segmentation ng prompt, point_prompts, o box_prompts kung ibinigay; kung walang mask o segmentation prompt, ang buong larawan ang gagamitin.

Opsyonal na URL para pagandahin ang depth estimation sa 3D reconstruction sa pamamagitan ng external pointmap o depth data bilang NPY o NPZ.

Cutoff ng confidence sa detection; default ng modelo ang gagamitin kapag inalis. Ang mga value ay mula 0.1 hanggang 1.0, kung saan ipinagpapalit ng mas mababang value ang precision para sa mas maraming detection.

Seed na ginagamit para sa reproducible na random pagbuo.

default na []

Mga point-based prompt na ginagamit para sa awtomatikong segmentation kapag walang mask.

default na []

Mga box prompt na nagbibigay ng mga indibidwal na object mask para sa 3D reconstruction sa pamamagitan ng awtomatikong segmentation; ginagamit lamang kapag walang ibinigay na mask. Maaaring magsumite ng maraming box.

POST /run/sam-3/3d-objects?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-objects?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.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 Objects

Ginagawang 3D asset ang mga object sa isang larawan. Pumili ng mga object gamit ang `mask_urls`, teksto na `prompt`, `point_prompts` o `box_prompts`; nagbibigay ng magkakahiwalay na object ang maraming box. Tumatanggap ang `detection_threshold` ng 0.1 hanggang 1, at bina-bake ng `export_textured_glb` ang texture at UV. Naglalabas ng GLB, Gaussian splat file, file bawat object para sa multi-object scene, metadata at zip bundle.

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
URL ng larawan para sa 3D reconstruction.
mask_urlsopsyonal
Uriurl[] · image
Opsyonal na listahan ng mask URL bawat object. Kung walang mask, gagamit ang awtomatikong segmentation ng prompt, point_prompts, o box_prompts kung ibinigay; kung walang mask o segmentation prompt, ang buong larawan ang gagamitin.
promptopsyonal
Uristring | null
defaultcar
Text na ginagamit para sa awtomatikong segmentation kapag walang mask, gaya ng 'chair' o 'lamp'.
point_promptsopsyonal
Uriobject[]
default[]
Mga point-based prompt na ginagamit para sa awtomatikong segmentation kapag walang mask.
point_prompts[].xopsyonal
Uriinteger | null
Posisyon ng prompt sa X axis.
point_prompts[].yopsyonal
Uriinteger | null
Posisyon ng prompt sa Y axis.
point_prompts[].labelopsyonal
Urienum
01
Label ng foreground/background: foreground ang tinutukoy ng 1; background ang 0.
point_prompts[].object_idopsyonal
Uriinteger | null
Opsyonal na identifier na nagpapangkat sa mga prompt na nagre-refine ng iisang object. Kung may text ding ibinigay bilang prompt, tinutukoy ng identifier na ito kung aling nadetect na object ang nire-refine ng mga point na iyon.
box_promptsopsyonal
Uriobject[]
default[]
Mga box prompt na nagbibigay ng mga indibidwal na object mask para sa 3D reconstruction sa pamamagitan ng awtomatikong segmentation; ginagamit lamang kapag walang ibinigay na mask. Maaaring magsumite ng maraming box.
box_prompts[].x_minopsyonal
Uriinteger | null
Pinakamababang x-coordinate para sa box.
box_prompts[].y_minopsyonal
Uriinteger | null
Pinakamababang y-coordinate para sa box.
box_prompts[].x_maxopsyonal
Uriinteger | null
Pinakamataas na X coordinate para sa box.
box_prompts[].y_maxopsyonal
Uriinteger | null
Pinakamataas na Y coordinate para sa box.
box_prompts[].object_idopsyonal
Uriinteger | null
Opsyonal na identifier na nagpapangkat sa mga box na nagre-refine ng iisang object.
seedopsyonal
Uriinteger | null
Seed na ginagamit para sa reproducible na random pagbuo.
pointmap_urlopsyonal
Uristring | null
Opsyonal na URL para pagandahin ang depth estimation sa 3D reconstruction sa pamamagitan ng external pointmap o depth data bilang NPY o NPZ.
detection_thresholdopsyonal
Urinumber | null
0.1 – 1
Cutoff ng confidence sa detection; default ng modelo ang gagamitin kapag inalis. Ang mga value ay mula 0.1 hanggang 1.0, kung saan ipinagpapalit ng mas mababang value ang precision para sa mas maraming detection.
export_textured_glbopsyonal
Uriboolean
defaultfalse
Opsyon sa GLB export: kapag pinagana, pinapalitan nito ang mga vertex color ng baked texture at UV.
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-objects",
  "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": {
    "gaussian_splat": {
      "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
    },
    "metadata": [
      {
        "object_index": 1,
        "scale": [
          []
        ],
        "rotation": [
          []
        ],
        "translation": [
          []
        ],
        "camera_pose": [
          []
        ]
      }
    ],
    "individual_splats": [
      {
        "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
      }
    ],
    "individual_glbs": [
      {
        "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
      }
    ],
    "artifacts_zip": {
      "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
gaussian_splat
object {url, content_type, file_name, file_size}Pinagsamang scene splat para sa mga resultang may maraming object, o isang splat kung hindi; ibinibigay bilang Gaussian splat file sa .ply format.
model_glb
object {url, content_type, file_name, file_size}3D output na naka-save bilang GLB: pinagsasama ang maraming object sa isang eksena, habang ang ibang resulta ay naglalaman ng isang mesh.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata para sa bawat object, kasama ang rotation, translation, at scale.
individual_splats
array of object {url, content_type, file_name, file_size} | nullHiwa-hiwalay na Gaussian splat file para sa bawat object, available lamang sa mga eksenang may maraming object.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullHiwa-hiwalay na GLB mesh file para sa bawat object, available lamang sa mga eksenang may maraming object.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP archive ng lahat ng artifact kasama ang metadata.

Higit pang modelo: Larawan patungong 3D

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