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 an accepted generation task. Poll the result endpoint with the returned id for terminal outputs or errors.

Optional<string>error

Error message if the task failed. Empty on success.

stringidrequired

Unique identifier for the generation task.

Optional<string>model

Model ID used for the prediction.

Optional<array>outputs

Array of generated content. Empty when status is not completed.

stringstatusrequired

Status of the task: pending, running, completed, failed, or timeout.

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

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