Start building
SandBase

Appearance

Sam 3

POST/v1/run

Sam 3 3d Objects by Meta - convert 2D images into 3D models with AI. Generate textured 3D assets from single photos for games, AR/VR, e-commerce, and digital content creation.

Request body

Submit an async generation request. The model field selects the model; other fields are model-specific input parameters.

stringmodelrequired

Model identifier. Set to meta/sam-3/3d-objects.

Default: meta/sam-3/3d-objects

stringpromptrequired

Text prompt for auto-segmentation when no masks provided (e.g., 'chair', 'lamp')

Default: car

stringimagerequired

URL of the image to reconstruct in 3D

Optional<array<object>>point_prompts

Point prompts for auto-segmentation when no masks provided

Default:

Optional<number>detection_threshold

Detection confidence threshold (0.1-1.0). Lower = more detections but less precise. If not set, uses the model's default.

Range: 0.1 to 1

Optional<array<object>>box_prompts

Box prompts for auto-segmentation when no masks provided. Multiple boxes supported - each produces a separate object mask for 3D reconstruction.

Default:

Optional<string>pointmap_url

Optional URL to external pointmap/depth data (NPY or NPZ format) for improved 3D reconstruction depth estimation

Optional<boolean>export_textured_glb

If True, exports GLB with baked texture and UVs instead of vertex colors.

Default: false

Optional<array<string>>mask_urls

Optional list of mask URLs (one per object). If not provided, use prompt/point_prompts/box_prompts to auto-segment, or entire image will be used.

Optional<integer>seed

Random seed for reproducibility

Response Schema

The submit endpoint returns a run response. If its status is pending or running, poll GET /v1/run/{id} with the returned opaque ID until it reaches a terminal state.

stringidrequired

Opaque SandBase run identifier. Use it exactly as returned; no prefix is guaranteed.

stringstatusrequired

Current public run status.

Allowed values: pending, running, completed, failed, timeout

Optional<string>model

Public SandBase model name used for this run.

Optional<array<object>>outputs

Present only for completed runs. Each object is capability-specific; inspect the selected model schema for its fields.

Optional<object>error

Present only for failed or timeout runs. Contains a public error type and sanitized message.

Optional<string>error.type

Stable public error category.

Optional<string>error.message

Sanitized error message safe to show to clients.

Optional<object>usage

Usage details when available.

Model capabilities

array<string>capability_tagsrequired

Capabilities declared by the model registry.

Default: image-to-3d

stringexecution_moderequired

Execution mode declared by the model registry.

Default: async