generate_3d_from_image
Generate a 3D model (GLB) from one image, or from 2–4 views of the same subject (multi-view → higher-fidelity geometry), async.
Instructions
Generate a 3D model (GLB) from one image, or from 2–4 views of the same subject (multi-view → higher-fidelity geometry), async. Single: image_url (any public http/https image, or a prior generation's files.image) OR image_path (a local file, uploaded directly — no hosting needed). Multi-view: image_urls OR image_paths, ordered [front, left, back, right] (2–4 views). Not every engine takes multi-view — check supportsMultiView from list_models(category='image-to-3d'); unsupported engines return 400. Local files win over URLs. Then wait_for_asset and read files.model. Costs credits — see list_models(category='image-to-3d') (NOT category='3d', which is the text-to-3D catalog and omits image-only engines).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| engine | No | engine name from list_models(category='image-to-3d') | |
| texture | No | ||
| image_url | No | single hosted image URL | |
| polycount | No | ||
| image_path | No | absolute path to a single local image file (≤20MB) | |
| image_urls | No | multi-view: 2–4 hosted image URLs, ordered [front, left, back, right] | |
| ultra_mode | No | higher-fidelity geometry. Only engines whose list_models entry has supportsUltraMode (currently meshy-7), and SINGLE image only — the vendor scopes it to one input image. Adds that entry's ultraCost credits. Combining it with another engine or with multi-view returns 400. | |
| image_paths | No | multi-view: 2–4 local image file paths (each ≤20MB), ordered [front, left, back, right] |