Skip to content

Sam 3 · 3D Objects

Integrate

Model id 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: ≈$0.02 20 API credits · ≈ ₽2.11 Run it on this page

Get API key
Meta · 3D

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

default car

Text used for automatic segmentation if masks are absent, such as 'chair' or 'lamp'.

•required image_url
Drop a file, or

Image URL for 3D reconstruction.

Advanced mask_urls · pointmap_url · detection_threshold · seed · export_textured_glb · point_prompts · box_prompts
Drop a file, or

Optional per-object mask URL list. Without masks, automatic segmentation uses prompt, point_prompts, or box_prompts if supplied; if neither masks nor segmentation prompts are supplied, the entire image is used.

Optional URL for improving depth estimation in 3D reconstruction by supplying external pointmap or depth data as NPY or NPZ.

Detection confidence cutoff, left to the model's default if omitted. Values range from 0.1 to 1.0, with smaller values trading precision for increased detection count.

Seed used for reproducible random generation.

default []

Point-based prompts used for automatic segmentation if masks are absent.

default []

Box prompts that yield individual object masks for 3D reconstruction through automatic segmentation, used only if no masks are supplied. Multiple boxes can be submitted.

POST /run/sam-3/3d-objects?wait=20 quote → $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-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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Sam 3 · 3D Objects

Turns objects in a photo into 3D assets. Choose objects with `mask_urls`, a text `prompt`, `point_prompts` or `box_prompts`; multiple boxes give separate objects. `detection_threshold` accepts 0.1 to 1, and `export_textured_glb` bakes texture and UVs. Outputs a GLB, Gaussian splat files, per-object files for multi-object scenes, metadata and a zip bundle.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
Image URL for 3D reconstruction.
mask_urlsoptional
Typeurl[] · image
Optional per-object mask URL list. Without masks, automatic segmentation uses prompt, point_prompts, or box_prompts if supplied; if neither masks nor segmentation prompts are supplied, the entire image is used.
promptoptional
Typestring | null
Defaultcar
Text used for automatic segmentation if masks are absent, such as 'chair' or 'lamp'.
point_promptsoptional
Typeobject[]
Default[]
Point-based prompts used for automatic segmentation if masks are absent.
point_prompts[].xoptional
Typeinteger | null
Prompt position along the X axis.
point_prompts[].yoptional
Typeinteger | null
Prompt position along the Y axis.
point_prompts[].labeloptional
Typeenum
01
Foreground/background label: 1 indicates foreground; 0 indicates background.
point_prompts[].object_idoptional
Typeinteger | null
Optional identifier grouping prompts that refine a single object. If text is also supplied as a prompt, this identifier determines which detected object those points refine.
box_promptsoptional
Typeobject[]
Default[]
Box prompts that yield individual object masks for 3D reconstruction through automatic segmentation, used only if no masks are supplied. Multiple boxes can be submitted.
box_prompts[].x_minoptional
Typeinteger | null
Minimum x-coordinate for the box.
box_prompts[].y_minoptional
Typeinteger | null
Minimum y-coordinate for the box.
box_prompts[].x_maxoptional
Typeinteger | null
Maximum X coordinate for the box.
box_prompts[].y_maxoptional
Typeinteger | null
Maximum Y coordinate for the box.
box_prompts[].object_idoptional
Typeinteger | null
Optional identifier grouping boxes that refine a single object.
seedoptional
Typeinteger | null
Seed used for reproducible random generation.
pointmap_urloptional
Typestring | null
Optional URL for improving depth estimation in 3D reconstruction by supplying external pointmap or depth data as NPY or NPZ.
detection_thresholdoptional
Typenumber | null
0.1 – 1
Detection confidence cutoff, left to the model's default if omitted. Values range from 0.1 to 1.0, with smaller values trading precision for increased detection count.
export_textured_glboptional
Typeboolean
Defaultfalse
GLB export choice: enabling this option replaces vertex colors with a baked texture and UVs.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
gaussian_splat
object {url, content_type, file_name, file_size}Combined scene splat for results with multiple objects, or a single splat otherwise; supplied as a Gaussian splat file in .ply format.
model_glb
object {url, content_type, file_name, file_size}3D output saved as GLB: multiple objects are assembled into one scene, while other results contain one mesh.
metadata
array of object {object_index, scale, rotation, translation, camera_pose}Metadata for each object, including rotation, translation, and scale.
individual_splats
array of object {url, content_type, file_name, file_size} | nullSeparate Gaussian splat files for each object, available only in scenes with multiple objects.
individual_glbs
array of object {url, content_type, file_name, file_size} | nullSeparate GLB mesh files for each object, available only in scenes with multiple objects.
artifacts_zip
object {url, content_type, file_name, file_size} | nullZIP archive of all artifacts plus metadata.

More models: Image to 3D

For AI agents: this page as Markdown is at https://doitong.com/en-US/developers/models/sam-3/3d-objects.md. All models and guides: https://doitong.com/developers/llms.txt