Refine a 3D model by describing a change
refine_modelIterate on a model you already generated: just describe the change in words ("make it metallic", "bigger helmet", "add wings"). The studio re-generates a new version anchored to the previous one, carrying its form and materials forward. Pass the previous model's glb_url and, when you have it, the prompt that made it (parent_prompt) so the change builds on it. Each refinement is recorded as a new version in a lineage you can revert to or branch from, and the returned lineage drives a version strip in the viewer. Renders the new version inline in the interactive 3D viewer. Use this instead of a fresh generation when the user wants to change a model they already have.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| glb_url | Yes | http(s) URL of the model to refine (e.g. the glbUrl a previous generation returned). | |
| instruction | Yes | The change to make, in plain language: "make it metallic", "bigger helmet", "add a cape". | |
| parent_index | No | Optional: branch off an earlier version in parent_lineage (its index) instead of the latest. | |
| parent_prompt | No | Optional: the prompt that produced the model being refined, so the change builds on it instead of starting over. | |
| parent_lineage | No | Optional: the lineage array from a previous refine_model result, to extend the same version history. | |
| idempotency_key | No | Optional retry key. Send the same key again (same caller, same arguments, within 24 hours) and you get the original job back instead of a second generation, so a retry after a timeout cannot burn quota twice. Use a fresh key for each distinct request. A failed attempt is not remembered, so its key can be reused. | |
| reference_image_url | No | Optional http(s) image of the current model to anchor the re-generation (image→3D). Omit for text-guided refinement. |