Suzanne
Sign inGet started
Browse docs

Models

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

We expose stable, named models (sculptor, atelier, capture) and handle the implementation behind each one. All three are powered by Atelier2, our latest in-house 3D generation engine — see the Atelier2 Engine for an overview. When the engine is upgraded underneath, your code keeps working: the model names and request contract stay stable.

ModelUse caseInputs acceptedOutput formats
sculptorGame-ready meshes, fast iterationtext prompt, 1 photo, or 2–4 photosglb, obj, stl, fbx
atelierPremium fidelity with PBR + detailed texturestext prompt or 1 photoglb, fbx
captureMulti-view reconstruction from 4 photosexactly 4 photos (front / back / left / right)glb, obj, fbx

Use sculptor for nearly everything. Pick atelier when you need premium PBR materials and detailed textures. Reach for capture when you have a clean four-view photo set and want the best reconstruction. 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 shapeWhat sculptor doesNotes
prompt (text-to-3d)Single text-conditioned generationPass prompt only.
1 photo (front)Single-image reconstructionSingle front slot populated.
2–4 photosMulti-view reconstructionPopulate front + any of back / left / right. Better topology than single-image.

The Atelier2 engine 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 / FBX via outputs.
  • params.faces (the discrete 200000 / 500000 / 1000000 / 2000000 menu) and params.pbr work consistently across the input shapes; values that don't apply to a given path are clamped to the closest supported value.
  • Failures are surfaced as vendor_model_error with a descriptive message, and the request is refunded.

How atelier differs

atelier is the premium tier and always produces PBR-textured output with detailed textures:

  • Input: a text prompt or exactly one image (the front slot).
  • Knobs: params.faces (the standard menu), params.pbr (defaults true), and params.texture_quality (defaults "detailed").
  • Output: glb (default) and/or fbx, 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).

How capture differs

capture is dedicated multi-view reconstruction from a complete four-view photo set:

  • Input: exactly four photos — front, back, left, and right. No text prompt.
  • Output: glb (default), plus optional obj / fbx.
  • A job submitted without all four valid views fails with insufficient_views.

Use capture when you have controlled, four-angle photography and want the highest-fidelity reconstruction the engine can produce.

Trying a model

# sculptor: fast iteration, any input shape
curl https://api.suzanne3d.com/v1/generations/text-to-3d \
  -H "Authorization: Bearer sznn_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 sznn_test_..." \
  -H "content-type: application/json" \
  -d '{ "model": "atelier", "images_upload_ids": { "front": "upl_..." } }'