Skip to main content
Glama

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

TableJSON Schema
NameRequiredDescriptionDefault
engineNoengine name from list_models(category='image-to-3d')
textureNo
image_urlNosingle hosted image URL
polycountNo
image_pathNoabsolute path to a single local image file (≤20MB)
image_urlsNomulti-view: 2–4 hosted image URLs, ordered [front, left, back, right]
ultra_modeNohigher-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_pathsNomulti-view: 2–4 local image file paths (each ≤20MB), ordered [front, left, back, right]

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.1.6
    • addedInput schema / properties / engine / description
      Added value: +"engine name from list_models(category='image-to-3d')"
    • addedInput schema / properties / ultra_mode
      Added value: +{
      +  "description": "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.",
      +  "type": "boolean"
      +}
  2. Changed4 schema fields changedv0.1.5
    • changedInput schema / properties / image_path / description
      Previous value: -"absolute path to a local image file (≤20MB)"New value: +"absolute path to a single local image file (≤20MB)"
    • addedInput schema / properties / image_paths
      Added value: +{
      +  "description": "multi-view: 2–4 local image file paths (each ≤20MB), ordered [front, left, back, right]",
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 4,
      +  "minItems": 2,
      +  "type": "array"
      +}
    • addedInput schema / properties / image_url / description
      Added value: +"single hosted image URL"
    • addedInput schema / properties / image_urls
      Added value: +{
      +  "description": "multi-view: 2–4 hosted image URLs, ordered [front, left, back, right]",
      +  "items": {
      +    "format": "uri",
      +    "type": "string"
      +  },
      +  "maxItems": 4,
      +  "minItems": 2,
      +  "type": "array"
      +}
  3. First observedv0.1.0

TDQS

Score is being calculated.