Models

Available models in the Suzanne API and how each behaves across input shapes.

We expose stable, named models (sculptor, atelier, capture, core) and handle the vendor implementation behind each one. When a vendor releases a new version or we swap providers entirely, your code keeps working.

Model	Use case	Inputs accepted
`sculptor`	Game-ready meshes, fast iteration	text prompt, 1 photo, or 2–4 photos
`atelier`	Premium fidelity with PBR materials	1 photo
`capture`	Reserved: multi-view focus	n/a
`core`	Reserved: placeholder	n/a

Use sculptor for nearly everything. Pick atelier when you need PBR textures (base color + metallic-roughness + normal) and don't mind a longer wait. Pricing is set per account: see your account team for the rate sheet.

How `sculptor` handles different inputs

sculptor adapts based on what you send. You write the same code regardless of input shape. Adding more photos to images_upload_ids switches the pipeline automatically.

Input shape	What `sculptor` does	Notes
`prompt` (text-to-3d)	Single text-conditioned generation	Pass `prompt` only.
1 photo (front)	Single-image reconstruction	Single `front` slot populated.
2–4 photos	Multi-view reconstruction	Populate `front` + any of `back` / `left` / `right`. Better topology than single-image.

The actual vendor / model version powering each path is intentionally not part of the public contract; it can change without warning. What we promise:

The output is GLB-by-default (with optional OBJ / STL conversion via outputs).
params.faces (40k / 100k / 500k / 1.5M) and params.pbr work consistently across the input shapes; values that don't apply to the underlying engine are clamped to the closest supported.
Failures are surfaced as vendor_model_error with a descriptive message, and the request is refunded.

How `atelier` differs

atelier is single-photo only and always produces PBR-textured output:

Input: exactly one image (the front slot).
Knobs: params.faces (1k–500k, free integer) and params.pbr (forced true).
Output: GLB with PBR maps embedded.

Pick atelier when the geometry will be rendered with realistic lighting: game engines, AR, product visualization. Don't pick it when polygon budget matters above all (use sculptor with a smaller faces value instead).

Trying a model

# sculptor: fast iteration, any input shape
curl https://api.suzanne3d.com/v1/generations/text-to-3d \
  -H "Authorization: Bearer sk_test_..." \
  -H "content-type: application/json" \
  -d '{ "model": "sculptor", "prompt": "a low-poly fox" }'
 
# atelier: premium PBR
curl https://api.suzanne3d.com/v1/generations/photo-to-3d \
  -H "Authorization: Bearer sk_test_..." \
  -H "content-type: application/json" \
  -d '{ "model": "atelier", "images_upload_ids": { "front": "upl_..." } }'

How sculptor handles different inputs

How atelier differs

Trying a model

How `sculptor` handles different inputs

How `atelier` differs