generate_model_from_image
Destructive
Convert a reference image into a 3D model for printing or design iteration, using agent vision by default or Meshy when an API key is configured.
Instructions
Make a 3D model from a reference image.
DEFAULT (keyless): you (the agent) can SEE the image — study it,
give it to ``design_session`` as ``reference_images`` (every later
make is checked against it), and write the OpenSCAD yourself for
``design_session(verb="generate", scad_code=...)`` — or
``compile_scad`` on an install without ``design_session``. You do
NOT need an image-to-3D provider, and with no key configured this
tool hands the job back to your vision instead of erroring.
OPT-IN cloud path: when the user has set their OWN
KILN_MESHY_API_KEY, this submits the image to Meshy for an AI mesh
reconstruction. The image should show the object clearly against a
clean background for best results.
**EXPERIMENTAL:** AI-generated models are experimental. Always
validate the mesh before printing.
``reference_picture`` says what becomes of the picture: compared
with the model when it arrives and with every make on the goal it
is given to, or, where this install cannot compare, that you must.
**Image tips:**
- Use a clear, well-lit photo of the object.
- Plain/solid backgrounds produce better results.
- Show the full object — avoid cropped or partial views.
- Multiple angles are not supported; use the best single view.
Args:
image_url: URL to the reference image (PNG, JPG). Must be
publicly accessible.
provider: Generation provider. Currently only ``"meshy"``
supports image-to-3D.
style: Optional style hint (``"realistic"`` or ``"sculpture"``).MAKE DOORS: design_session, Kiln's front door for making an object, is not installed here (signed in to Kiln it runs on Kiln's servers). On this install compile_scad IS the make → preview → iterate loop: make it, show the preview, iterate.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"image_url": "<image_url>"
},
"name": "generate_model_from_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| style | No | Optional style hint (``"realistic"`` or ``"sculpture"``). | |
| provider | No | Generation provider. Currently only ``"meshy"`` supports image-to-3D. Default: "meshy". | |
| image_url | Yes | URL to the reference image (PNG, JPG). Must be publicly accessible. |