meshy-v7/multi-image-to-3d

image-to-3D

Meshy v7 Multi-Image-to 3D API by MESHY

meshy-v7/multi-image-to-3d

Multi-image-to-3d

Meshy v7 Multi-Image-to-3D reconstructs one textured 3D model from up to four views of the same object, so the sides and back follow your reference instead of being inferred. Supports independent multi-view texture references and PBR maps up to 8K.

Meshy v7 Multi-Image-to 3D is developed by a third-party provider. Atlas Cloud (operated by Atlas Cloud AI LLC) provides access to it and does not own it. All trademarks belong to their respective owners.

INPUT

Reference Images *(0/4)

You can drag and drop a file or click to upload

MAX:4

Ultra mode

Should texture

PBR materials

Texture resolution

Texture prompt

Texture image

You can drag and drop a file or click to upload

MAX:1

Additional Settings

OUTPUT

Idle

Your generated 3D model will appear here

Configure your settings and click Run to get started

Your request will cost $0.02 per run. For $10 you can run this model approximately 500 times.

Parameters

Code Example
import requests
import time

# Step 1: Start image generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "meshy-v7/multi-image-to-3d",  # Required. Model name. options: meshy-v7/multi-image-to-3d
    "reference_images": [],  # Required. 1 to 4 images of the same object from different angles
    "ultra_mode": False,  # Higher-fidelity geometry with finer surface detail
    "should_texture": True,  # Generate textures
    "enable_pbr": False,  # Also generate PBR maps (metallic, roughness, normal) alongside the base colour
    "texture_resolution": "2k",  # Base colour texture resolution: 2k (2048²), 4k (4096²) or 8k (8192²). options: 2k | 4k | 8k
    "texture_prompt": "example_value",  # Extra prompt describing the surface material
    "texture_image": "example_value",  # Single reference image guiding the texture, as a public URL, base64 data URI, or asset reference (asset://<ASSET_ID>)
    "texture_images": [],  # 1 to 4 multi-view images guiding the texture only, independent of `reference_images` (different images and a different count are fine)
    "image_enhancement": True,  # Pre-process the source images for a better reconstruction
    "remove_lighting": True,  # Strip baked highlights and shadows from the base colour texture so the model sits correctly under your own lighting
    "should_remesh": False,  # Run the remesh phase
    "topology": "triangle",  # Topology of the remeshed output. options: triangle | quad
    "target_polycount": 30000,  # Target face count for the remesh phase: 100-300000, default 30000. (min: 100, max: 300000)
    "decimation_mode": 1,  # Adaptive decimation level, used instead of an exact `target_polycount`. options: 1 | 2 | 3 | 4
    "save_pre_remeshed_model": False,  # Also return the GLB as it was before the remesh phase, so you can compare the two
    "pose_mode": "",  # Force a rest pose for character meshes. options:  | a-pose | t-pose
    "target_formats": [
        "glb"
    ],  # Which 3D file formats to return. default: ["glb"]
    "auto_size": False,  # Estimate the object's real-world height with AI vision and scale the model accordingly
    "origin_at": "bottom",  # Where the model origin sits when `auto_size` is on. options: bottom | center
    "alpha_thumbnail": False,  # Also render a transparent-background (RGBA) preview image alongside the normal thumbnail
    "multi_view_thumbnails": False,  # Also render right / back / left preview images so the model can be reviewed from four angles without downloading the mesh
    "moderation": False,  # Screen every source image and the texture prompt for harmful content before generating
}

generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]

# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"

def check_status():
    while True:
        response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
        result = response.json()

        if result["data"]["status"] == "completed":
            print("Generated image:", result["data"]["outputs"][0])
            return result["data"]["outputs"][0]
        elif result["data"]["status"] == "failed":
            raise Exception(result["data"]["error"] or "Generation failed")
        else:
            # Still processing, wait 2 seconds
            time.sleep(2)

image_url = check_status()

Install

Install the required package for your language.

pip install requests

Authentication

All API requests require authentication via an API key. You can get your API key from the Atlas Cloud dashboard.

export ATLASCLOUD_API_KEY="your-api-key-here"

HTTP Headers

import os

API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

Keep your API key secure

Never expose your API key in client-side code or public repositories. Use environment variables or a backend proxy instead.

Submit a request

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "your-model",
    "prompt": "A beautiful landscape"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Submit a Request

Submit an asynchronous generation request. The API returns a prediction ID that you can use to check the status and retrieve the result.

POST/api/v1/model/generateImage

Request Body

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateImage"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}

data = {
    "model": "meshy-v7/multi-image-to-3d",
    "prompt": "A beautiful landscape with mountains and lake"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

print(f"Prediction ID: {result['data']['id']}")
print(f"Status: {result['data']['status']}")

Response

{
  "code": 200,
  "data": {
    "id": "pred_abc123",
    "status": "processing",
    "model": "model-name",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

Check Status

Poll the prediction endpoint to check the current status of your request.

GET/api/v1/model/prediction/{prediction_id}

Polling Example

import requests
import time

prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

while True:
    response = requests.get(url, headers=headers)
    result = response.json()
    status = result["data"]["status"]
    print(f"Status: {status}")

    if status in ["completed", "succeeded"]:
        output_url = result["data"]["outputs"][0]
        print(f"Output URL: {output_url}")
        break
    elif status == "failed":
        print(f"Error: {result['data'].get('error', 'Unknown')}")
        break

    time.sleep(3)

Status Values

processingThe request is still being processed.

completedGeneration is complete. Outputs are available.

succeededGeneration succeeded. Outputs are available.

failedGeneration failed. Check the error field.

Completed Response

{
  "data": {
    "id": "pred_abc123",
    "status": "completed",
    "outputs": [
      "https://storage.atlascloud.ai/outputs/result.png"
    ],
    "metrics": {
      "predict_time": 8.3
    },
    "created_at": "2025-01-01T00:00:00Z",
    "completed_at": "2025-01-01T00:00:10Z"
  }
}

Upload Files

Upload files to Atlas Cloud storage and get a URL you can use in your API requests. Use multipart/form-data to upload.

POST/api/v1/model/uploadMedia

Upload Example

import requests

url = "https://api.atlascloud.ai/api/v1/model/uploadMedia"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

with open("image.png", "rb") as f:
    files = {"file": ("image.png", f, "image/png")}
    response = requests.post(url, headers=headers, files=files)

result = response.json()
download_url = result["data"]["download_url"]
print(f"File URL: {download_url}")

Response

{
  "data": {
    "download_url": "https://storage.atlascloud.ai/uploads/abc123/image.png",
    "file_name": "image.png",
    "content_type": "image/png",
    "size": 1024000
  }
}

Input Schema

The following parameters are accepted in the request body.

Total: 23Required: 2Optional: 21

modelstringrequired

Model name.

Default: "meshy-v7/multi-image-to-3d"

meshy-v7/multi-image-to-3d

reference_imagesarray[string]required

1 to 4 images of the same object from different angles. Each may be a public URL, base64 data URI, or asset reference (asset://<ASSET_ID>); formats jpg/jpeg/png. The first image is the primary (front) view — the order of the rest does not matter.

Min items: 1Max items: 4

ultra_modeboolean

Higher-fidelity geometry with finer surface detail. Takes longer and costs 5 extra credits.

Default: false

should_textureboolean

Generate textures. Turn it off for an untextured mesh — faster and cheaper.

Default: true

enable_pbrboolean

Also generate PBR maps (metallic, roughness, normal) alongside the base colour. Requires `should_texture`.

Default: false

texture_resolutionstring

Base colour texture resolution: 2k (2048²), 4k (4096²) or 8k (8192²). 8k costs 5 extra credits.

Default: "2k"

2k4k8k

texture_promptstring

Extra prompt describing the surface material. Up to 800 characters. Cannot be combined with `texture_images`.

texture_imagestring

Single reference image guiding the texture, as a public URL, base64 data URI, or asset reference (asset://<ASSET_ID>). Cannot be combined with `texture_images`. `texture_prompt` takes priority when both are given.

Format: uri

texture_imagesarray[string]

1 to 4 multi-view images guiding the texture only, independent of `reference_images` (different images and a different count are fine). The first is the primary (front) view. Cannot be combined with `texture_image` or `texture_prompt`.

Min items: 1Max items: 4

image_enhancementboolean

Pre-process the source images for a better reconstruction. Turn it off to preserve their exact appearance with no style processing.

Default: true

remove_lightingboolean

Strip baked highlights and shadows from the base colour texture so the model sits correctly under your own lighting. Supported on Meshy 7 for multi-image input.

Default: true

should_remeshboolean

Run the remesh phase. Leave off for the highest-quality mesh; turn it on when you need a specific polygon budget via `target_polycount` or `decimation_mode`.

Default: false

topologystring

Topology of the remeshed output. `quad` produces a quad-dominant mesh, `triangle` a decimated triangle mesh. Requires `should_remesh`.

Default: "triangle"

trianglequad

target_polycountinteger

Target face count for the remesh phase: 100-300000, default 30000. Requires `should_remesh`, and is ignored when `decimation_mode` is set.

Default: 30000Min: 100Max: 300000

decimation_modeinteger

Adaptive decimation level, used instead of an exact `target_polycount`. 1 = ultra, 2 = high, 3 = medium, 4 = low polycount. Requires `should_remesh`, and takes priority over `target_polycount`.

1234

save_pre_remeshed_modelboolean

Also return the GLB as it was before the remesh phase, so you can compare the two. Requires `should_remesh`.

Default: false

pose_modestring

Force a rest pose for character meshes. Empty applies no specific pose.

Default: ""

a-poset-pose

target_formatsarray[string]

Which 3D file formats to return. Defaults to GLB alone; ask for more only when you need them, since each extra format adds generation and transfer time.

Default: ["glb"]Min items: 1Max items: 6

auto_sizeboolean

Estimate the object's real-world height with AI vision and scale the model accordingly.

Default: false

origin_atstring

Where the model origin sits when `auto_size` is on.

Default: "bottom"

bottomcenter

alpha_thumbnailboolean

Also render a transparent-background (RGBA) preview image alongside the normal thumbnail.

Default: false

multi_view_thumbnailsboolean

Also render right / back / left preview images so the model can be reviewed from four angles without downloading the mesh. Adds roughly 3 seconds.

Default: false

moderationboolean

Screen every source image and the texture prompt for harmful content before generating. A flagged request does not proceed to generation.

Default: false

Example Request Body

{
  "model": "meshy-v7/multi-image-to-3d",
  "reference_images": [
    "https://example.com/file.jpg"
  ],
  "ultra_mode": false,
  "should_texture": true,
  "enable_pbr": false,
  "texture_resolution": "2k",
  "image_enhancement": true,
  "remove_lighting": true,
  "should_remesh": false,
  "topology": "triangle",
  "target_polycount": 30000,
  "save_pre_remeshed_model": false,
  "pose_mode": "",
  "target_formats": [
    "glb"
  ],
  "auto_size": false,
  "origin_at": "bottom",
  "alpha_thumbnail": false,
  "multi_view_thumbnails": false,
  "moderation": false
}

Output Schema

The API returns a prediction response with the generated output URLs.

codeinteger

messagestring

dataunknown

Example Response

{
  "id": "pred_abc123",
  "status": "completed",
  "model": "model-name",
  "outputs": [
    "https://storage.atlascloud.ai/outputs/result.png"
  ],
  "metrics": {
    "predict_time": 8.3
  },
  "created_at": "2025-01-01T00:00:00Z",
  "completed_at": "2025-01-01T00:00:10Z"
}

Atlas Cloud Skills

Atlas Cloud Skills integrates 400+ AI models directly into your AI coding assistant. One command to install, then use natural language to generate images, videos, and chat with LLMs.

Supported Clients

Claude Code

OpenAI Codex

Gemini CLI

Cursor

Windsurf

VS Code

Trae

GitHub Copilot

Cline

Roo Code

Amp

Goose

Replit

40+ supported clients

Install

npx skills add AtlasCloudAI/atlas-cloud-skills

Setup API Key

Get your API key from the Atlas Cloud dashboard and set it as an environment variable.

export ATLASCLOUD_API_KEY="your-api-key-here"

Capabilities

Once installed, you can use natural language in your AI assistant to access all Atlas Cloud models.

Image GenerationGenerate images with models like Nano Banana 2, Z-Image, and more.

Video CreationCreate videos from text or images with Kling, Vidu, Veo, etc.

LLM ChatChat with Qwen, DeepSeek, and other large language models.

Media UploadUpload local files for image editing and image-to-video workflows.

Learn more

github.com/AtlasCloudAI/atlas-cloud-skills

MCP Server

Atlas Cloud MCP Server connects your IDE with 400+ AI models via the Model Context Protocol. Works with any MCP-compatible client.

Supported Clients

Cursor

VS Code

Windsurf

Claude Code

OpenAI Codex

Gemini CLI

Cline

Roo Code

100+ supported clients

Install

npx -y atlascloud-mcp

Configuration

Add the following configuration to your IDE's MCP settings file.

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": [
        "-y",
        "atlascloud-mcp"
      ],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

atlas_generate_imageGenerate images from text prompts.

atlas_generate_videoCreate videos from text or images.

atlas_chatChat with large language models.

atlas_list_modelsBrowse 400+ available AI models.

atlas_quick_generateOne-step content creation with auto model selection.

atlas_upload_mediaUpload local files for API workflows.

Learn more

github.com/AtlasCloudAI/mcp-server

API Schema

{
  "info": {
    "title": "AtlasCloud API",
    "version": "1.0.0",
    "description": "The AtlasCloud API."
  },
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/model/generateImage": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Input"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "The request status."
          }
        }
      },
      "x-api-name": "model_run"
    },
    "/api/v1/model/prediction/{request_id}": {
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "request_id",
            "required": true,
            "schema": {
              "description": "Request ID",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "Result of the request."
          }
        }
      },
      "x-api-name": "model_result"
    }
  },
  "components": {
    "schemas": {
      "Input": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "description": "Model name.",
            "default": "meshy-v7/multi-image-to-3d",
            "enum": [
              "meshy-v7/multi-image-to-3d"
            ]
          },
          "reference_images": {
            "type": "array",
            "description": "1 to 4 images of the same object from different angles. Each may be a public URL, base64 data URI, or asset reference (asset://<ASSET_ID>); formats jpg/jpeg/png. The first image is the primary (front) view — the order of the rest does not matter.",
            "items": {
              "type": "string",
              "format": "uri",
              "x-format": "image"
            },
            "minItems": 1,
            "maxItems": 4,
            "x-accept": ".jpg,.jpeg,.png",
            "x-ui-component": "uploaders"
          },
          "ultra_mode": {
            "type": "boolean",
            "description": "Higher-fidelity geometry with finer surface detail. Takes longer and costs 5 extra credits.",
            "default": false,
            "x-ui-component": "switch"
          },
          "should_texture": {
            "type": "boolean",
            "description": "Generate textures. Turn it off for an untextured mesh — faster and cheaper.",
            "default": true,
            "x-ui-component": "switch"
          },
          "enable_pbr": {
            "type": "boolean",
            "description": "Also generate PBR maps (metallic, roughness, normal) alongside the base colour. Requires `should_texture`.",
            "default": false,
            "x-ui-component": "switch"
          },
          "texture_resolution": {
            "type": "string",
            "description": "Base colour texture resolution: 2k (2048²), 4k (4096²) or 8k (8192²). 8k costs 5 extra credits.",
            "default": "2k",
            "enum": [
              "2k",
              "4k",
              "8k"
            ],
            "x-ui-component": "select"
          },
          "texture_prompt": {
            "type": "string",
            "description": "Extra prompt describing the surface material. Up to 800 characters. Cannot be combined with `texture_images`.",
            "maxLength": 800,
            "x-ui-component": "textarea"
          },
          "texture_image": {
            "type": "string",
            "description": "Single reference image guiding the texture, as a public URL, base64 data URI, or asset reference (asset://<ASSET_ID>). Cannot be combined with `texture_images`. `texture_prompt` takes priority when both are given.",
            "format": "uri",
            "x-format": "image",
            "x-accept": ".jpg,.jpeg,.png",
            "x-ui-component": "uploader"
          },
          "texture_images": {
            "type": "array",
            "description": "1 to 4 multi-view images guiding the texture only, independent of `reference_images` (different images and a different count are fine). The first is the primary (front) view. Cannot be combined with `texture_image` or `texture_prompt`.",
            "items": {
              "type": "string",
              "format": "uri",
              "x-format": "image"
            },
            "minItems": 1,
            "maxItems": 4,
            "x-accept": ".jpg,.jpeg,.png",
            "x-ui-component": "uploaders"
          },
          "image_enhancement": {
            "type": "boolean",
            "description": "Pre-process the source images for a better reconstruction. Turn it off to preserve their exact appearance with no style processing.",
            "default": true,
            "x-ui-component": "switch"
          },
          "remove_lighting": {
            "type": "boolean",
            "description": "Strip baked highlights and shadows from the base colour texture so the model sits correctly under your own lighting. Supported on Meshy 7 for multi-image input.",
            "default": true,
            "x-ui-component": "switch"
          },
          "should_remesh": {
            "type": "boolean",
            "description": "Run the remesh phase. Leave off for the highest-quality mesh; turn it on when you need a specific polygon budget via `target_polycount` or `decimation_mode`.",
            "default": false,
            "x-ui-component": "switch"
          },
          "topology": {
            "type": "string",
            "description": "Topology of the remeshed output. `quad` produces a quad-dominant mesh, `triangle` a decimated triangle mesh. Requires `should_remesh`.",
            "default": "triangle",
            "enum": [
              "triangle",
              "quad"
            ],
            "x-ui-component": "select"
          },
          "target_polycount": {
            "type": "integer",
            "description": "Target face count for the remesh phase: 100-300000, default 30000. Requires `should_remesh`, and is ignored when `decimation_mode` is set.",
            "minimum": 100,
            "maximum": 300000,
            "default": 30000,
            "x-ui-component": "slider"
          },
          "decimation_mode": {
            "type": "integer",
            "description": "Adaptive decimation level, used instead of an exact `target_polycount`. 1 = ultra, 2 = high, 3 = medium, 4 = low polycount. Requires `should_remesh`, and takes priority over `target_polycount`.",
            "enum": [
              1,
              2,
              3,
              4
            ],
            "x-enum-labels": {
              "1": "Ultra",
              "2": "High",
              "3": "Medium",
              "4": "Low"
            },
            "x-ui-component": "select"
          },
          "save_pre_remeshed_model": {
            "type": "boolean",
            "description": "Also return the GLB as it was before the remesh phase, so you can compare the two. Requires `should_remesh`.",
            "default": false,
            "x-ui-component": "switch"
          },
          "pose_mode": {
            "type": "string",
            "description": "Force a rest pose for character meshes. Empty applies no specific pose.",
            "default": "",
            "enum": [
              "",
              "a-pose",
              "t-pose"
            ],
            "x-enum-labels": {
              "": "None"
            },
            "x-ui-component": "select"
          },
          "target_formats": {
            "type": "array",
            "description": "Which 3D file formats to return. Defaults to GLB alone; ask for more only when you need them, since each extra format adds generation and transfer time.",
            "items": {
              "type": "string",
              "enum": [
                "glb",
                "obj",
                "fbx",
                "stl",
                "usdz",
                "3mf"
              ]
            },
            "default": [
              "glb"
            ],
            "minItems": 1,
            "maxItems": 6,
            "x-ui-component": "select"
          },
          "auto_size": {
            "type": "boolean",
            "description": "Estimate the object's real-world height with AI vision and scale the model accordingly.",
            "default": false,
            "x-ui-component": "switch"
          },
          "origin_at": {
            "type": "string",
            "description": "Where the model origin sits when `auto_size` is on.",
            "default": "bottom",
            "enum": [
              "bottom",
              "center"
            ],
            "x-ui-component": "select"
          },
          "alpha_thumbnail": {
            "type": "boolean",
            "description": "Also render a transparent-background (RGBA) preview image alongside the normal thumbnail.",
            "default": false,
            "x-ui-component": "switch"
          },
          "multi_view_thumbnails": {
            "type": "boolean",
            "description": "Also render right / back / left preview images so the model can be reviewed from four angles without downloading the mesh. Adds roughly 3 seconds.",
            "default": false,
            "x-ui-component": "switch"
          },
          "moderation": {
            "type": "boolean",
            "description": "Screen every source image and the texture prompt for harmful content before generating. A flagged request does not proceed to generation.",
            "default": false,
            "x-ui-component": "switch"
          }
        },
        "required": [
          "model",
          "reference_images"
        ],
        "allOf": [
          {
            "if": {
              "properties": {
                "should_texture": {
                  "const": false
                }
              },
              "required": [
                "should_texture"
              ]
            },
            "then": {
              "properties": {
                "enable_pbr": {
                  "x-hidden": true
                },
                "texture_resolution": {
                  "x-hidden": true
                },
                "texture_prompt": {
                  "x-hidden": true
                },
                "texture_image": {
                  "x-hidden": true
                },
                "texture_images": {
                  "x-hidden": true
                },
                "remove_lighting": {
                  "x-hidden": true
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "texture_images": {
                  "type": "array",
                  "minItems": 1
                }
              },
              "required": [
                "texture_images"
              ]
            },
            "then": {
              "properties": {
                "texture_image": {
                  "x-hidden": true
                },
                "texture_prompt": {
                  "x-hidden": true
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "should_remesh": {
                  "const": true
                }
              },
              "required": [
                "should_remesh"
              ]
            },
            "else": {
              "properties": {
                "topology": {
                  "x-hidden": true
                },
                "target_polycount": {
                  "x-hidden": true
                },
                "decimation_mode": {
                  "x-hidden": true
                },
                "save_pre_remeshed_model": {
                  "x-hidden": true
                }
              }
            }
          },
          {
            "if": {
              "properties": {
                "auto_size": {
                  "const": true
                }
              },
              "required": [
                "auto_size"
              ]
            },
            "else": {
              "properties": {
                "origin_at": {
                  "x-hidden": true
                }
              }
            }
          }
        ],
        "x-order-properties": [
          "model",
          "reference_images",
          "ultra_mode",
          "should_texture",
          "enable_pbr",
          "texture_resolution",
          "texture_prompt",
          "texture_image",
          "texture_images",
          "image_enhancement",
          "remove_lighting",
          "should_remesh",
          "topology",
          "target_polycount",
          "decimation_mode",
          "save_pre_remeshed_model",
          "pose_mode",
          "target_formats",
          "auto_size",
          "origin_at",
          "alpha_thumbnail",
          "multi_view_thumbnails",
          "moderation"
        ]
      },
      "PredictionResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer"
          },
          "message": {
            "type": "string"
          },
          "data": {
            "$ref": "#/components/schemas/PredictionData"
          }
        }
      },
      "PredictionData": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique ID of the generation task."
          },
          "model": {
            "type": "string",
            "description": "Model used for the generation."
          },
          "outputs": {
            "type": "array",
            "description": "Generated results: the 3D model file URL(s) for every requested format, then any texture maps, then the preview image last. Null or empty until the task completes.",
            "items": {
              "type": "string"
            }
          },
          "files": {
            "type": "array",
            "description": "Structured metadata for each entry in `outputs`, in the same order, so a client can tell the GLB apart from the OBJ or a texture map.",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "description": "Logical file kind, e.g. GLB, OBJ, FBX, USDZ, STL, 3MF, MTL, PRE_REMESHED_GLB, TEXTURE_IMAGE, PREVIEW."
                },
                "content_type": {
                  "type": "string"
                },
                "file_name": {
                  "type": "string"
                }
              }
            }
          },
          "thumbnail": {
            "type": "string",
            "description": "Rendered preview image of the generated model."
          },
          "credits_consumed": {
            "type": "number",
            "description": "Meshy credits the upstream task consumed, captured for auditing."
          },
          "urls": {
            "type": "object",
            "properties": {
              "get": {
                "type": "string"
              }
            }
          },
          "status": {
            "type": "string",
            "description": "Current task status, such as created, processing, completed, or failed."
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "error": {
            "type": "string",
            "description": "Error message returned when the task fails."
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.atlascloud.ai"
    }
  ]
}

LLM-Friendly Prompt Template

# meshy-v7/multi-image-to-3d

> Meshy v7 Multi-Image-to-3D reconstructs one textured 3D model from up to four views of the same object, so the sides and back follow your reference instead of being inferred. Supports independent multi-view texture references and PBR maps up to 8K.


## Overview

- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateImage` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `meshy-v7/multi-image-to-3d`


## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:

- **`model`** (`string`, _required_):
  Model name.
  - Default: `"meshy-v7/multi-image-to-3d"`
  - Options: "meshy-v7/multi-image-to-3d"

- **`reference_images`** (`array[string]`, _required_):
  1 to 4 images of the same object from different angles. Each may be a public URL, base64 data URI, or asset reference (asset://<ASSET_ID>); formats jpg/jpeg/png. The first image is the primary (front) view — the order of the rest does not matter.
  - Min items: 1
  - Max items: 4

- **`ultra_mode`** (`boolean`, _optional_):
  Higher-fidelity geometry with finer surface detail. Takes longer and costs 5 extra credits.
  - Default: `false`

- **`should_texture`** (`boolean`, _optional_):
  Generate textures. Turn it off for an untextured mesh — faster and cheaper.
  - Default: `true`

- **`enable_pbr`** (`boolean`, _optional_):
  Also generate PBR maps (metallic, roughness, normal) alongside the base colour. Requires `should_texture`.
  - Default: `false`

- **`texture_resolution`** (`string`, _optional_):
  Base colour texture resolution: 2k (2048²), 4k (4096²) or 8k (8192²). 8k costs 5 extra credits.
  - Default: `"2k"`
  - Options: "2k", "4k", "8k"

- **`texture_prompt`** (`string`, _optional_):
  Extra prompt describing the surface material. Up to 800 characters. Cannot be combined with `texture_images`.

- **`texture_image`** (`string`, _optional_):
  Single reference image guiding the texture, as a public URL, base64 data URI, or asset reference (asset://<ASSET_ID>). Cannot be combined with `texture_images`. `texture_prompt` takes priority when both are given.

- **`texture_images`** (`array[string]`, _optional_):
  1 to 4 multi-view images guiding the texture only, independent of `reference_images` (different images and a different count are fine). The first is the primary (front) view. Cannot be combined with `texture_image` or `texture_prompt`.
  - Min items: 1
  - Max items: 4

- **`image_enhancement`** (`boolean`, _optional_):
  Pre-process the source images for a better reconstruction. Turn it off to preserve their exact appearance with no style processing.
  - Default: `true`

- **`remove_lighting`** (`boolean`, _optional_):
  Strip baked highlights and shadows from the base colour texture so the model sits correctly under your own lighting. Supported on Meshy 7 for multi-image input.
  - Default: `true`

- **`should_remesh`** (`boolean`, _optional_):
  Run the remesh phase. Leave off for the highest-quality mesh; turn it on when you need a specific polygon budget via `target_polycount` or `decimation_mode`.
  - Default: `false`

- **`topology`** (`string`, _optional_):
  Topology of the remeshed output. `quad` produces a quad-dominant mesh, `triangle` a decimated triangle mesh. Requires `should_remesh`.
  - Default: `"triangle"`
  - Options: "triangle", "quad"

- **`target_polycount`** (`integer`, _optional_):
  Target face count for the remesh phase: 100-300000, default 30000. Requires `should_remesh`, and is ignored when `decimation_mode` is set.
  - Default: `30000`
  - Min: 100
  - Max: 300000

- **`decimation_mode`** (`integer`, _optional_):
  Adaptive decimation level, used instead of an exact `target_polycount`. 1 = ultra, 2 = high, 3 = medium, 4 = low polycount. Requires `should_remesh`, and takes priority over `target_polycount`.
  - Options: 1, 2, 3, 4

- **`save_pre_remeshed_model`** (`boolean`, _optional_):
  Also return the GLB as it was before the remesh phase, so you can compare the two. Requires `should_remesh`.
  - Default: `false`

- **`pose_mode`** (`string`, _optional_):
  Force a rest pose for character meshes. Empty applies no specific pose.
  - Default: `""`
  - Options: "", "a-pose", "t-pose"

- **`target_formats`** (`array[string]`, _optional_):
  Which 3D file formats to return. Defaults to GLB alone; ask for more only when you need them, since each extra format adds generation and transfer time.
  - Default: `["glb"]`
  - Min items: 1
  - Max items: 6

- **`auto_size`** (`boolean`, _optional_):
  Estimate the object's real-world height with AI vision and scale the model accordingly.
  - Default: `false`

- **`origin_at`** (`string`, _optional_):
  Where the model origin sits when `auto_size` is on.
  - Default: `"bottom"`
  - Options: "bottom", "center"

- **`alpha_thumbnail`** (`boolean`, _optional_):
  Also render a transparent-background (RGBA) preview image alongside the normal thumbnail.
  - Default: `false`

- **`multi_view_thumbnails`** (`boolean`, _optional_):
  Also render right / back / left preview images so the model can be reviewed from four angles without downloading the mesh. Adds roughly 3 seconds.
  - Default: `false`

- **`moderation`** (`boolean`, _optional_):
  Screen every source image and the texture prompt for harmful content before generating. A flagged request does not proceed to generation.
  - Default: `false`



**Required Parameters Example**:

```json
{
  "model": "meshy-v7/multi-image-to-3d",
  "reference_images": [
    ""
  ]
}
```


**Full Example**:

```json
{
  "model": "meshy-v7/multi-image-to-3d",
  "reference_images": [
    ""
  ],
  "ultra_mode": false,
  "should_texture": true,
  "enable_pbr": false,
  "texture_resolution": "2k",
  "texture_prompt": "",
  "texture_image": "",
  "texture_images": [
    ""
  ],
  "image_enhancement": true,
  "remove_lighting": true,
  "should_remesh": false,
  "topology": "triangle",
  "target_polycount": 30000,
  "decimation_mode": 0,
  "save_pre_remeshed_model": false,
  "pose_mode": "",
  "target_formats": [
    "glb"
  ],
  "auto_size": false,
  "origin_at": "bottom",
  "alpha_thumbnail": false,
  "multi_view_thumbnails": false,
  "moderation": false
}
```


### Output Schema

The API returns the following output format:


- **`code`** (`integer`, _optional_):

- **`message`** (`string`, _optional_):

- **`data`** (`string`, _optional_):



**Example Response**:

```json
{
  "code": 0,
  "message": "",
  "data": null
}
```


## Usage Examples

### cURL

```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "meshy-v7/multi-image-to-3d",
  "reference_images": [
    ""
  ],
  "ultra_mode": false,
  "should_texture": true,
  "enable_pbr": false,
  "texture_resolution": "2k",
  "texture_prompt": "",
  "texture_image": "",
  "texture_images": [
    ""
  ],
  "image_enhancement": true,
  "remove_lighting": true,
  "should_remesh": false,
  "topology": "triangle",
  "target_polycount": 30000,
  "decimation_mode": 0,
  "save_pre_remeshed_model": false,
  "pose_mode": "",
  "target_formats": [
    "glb"
  ],
  "auto_size": false,
  "origin_at": "bottom",
  "alpha_thumbnail": false,
  "multi_view_thumbnails": false,
  "moderation": false
}'

# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}

# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```

## Additional Resources

### Documentation

- [Model Playground](https://www.atlascloud.ai/models/meshy-v7/multi-image-to-3d)

No 3D output

Meshy 7 Multi-Image-to-3D

Meshy 7 Multi-Image-to-3D reconstructs one textured 3D model from up to four photographs of the same object. Where a single image forces the model to invent the sides and back, several views let it read them — so the parts of an object that a camera can see are the parts that come out right.

Why Choose This?

The back is no longer a guess — feed front, side and rear views and the reconstruction follows your reference rather than a prior.
Texture references of their own — texture_images guides the surface independently of the geometry inputs.
One call, one model — geometry and PBR textures in the same task.
Polygon budgets you control — an exact face count, an adaptive decimation level, or the raw high-detail mesh.
Review before you download — optional four-angle preview renders and a transparent-background thumbnail.

Parameters

Parameter	Required	Description
`model`	Yes	`meshy-v7/multi-image-to-3d`
`reference_images`	Yes	1–4 images of the same object from different angles. Each: public URL, base64 data URI, or `asset://<ASSET_ID>`. jpg/jpeg/png. The first image is the front view.
`ultra_mode`	No	Finer surface detail. Slower, +5 credits. Default: `false`
`should_texture`	No	Generate textures. Default: `true`; `false` returns a bare mesh for less.
`enable_pbr`	No	Also produce metallic / roughness / normal maps. Default: `false`
`texture_resolution`	No	`2k` (default), `4k`, or `8k`.
`texture_prompt`	No	Describe the surface material, up to 800 characters.
`texture_image`	No	A single reference image for the texture.
`texture_images`	No	1–4 multi-view texture references. Cannot be combined with `texture_image` or `texture_prompt`.
`image_enhancement`	No	Pre-process the inputs for a better reconstruction. Default: `true`
`remove_lighting`	No	Strip baked highlights and shadows. Supported on Meshy 7 for multi-image input. Default: `true`
`should_remesh`	No	Run the remesh phase. Default: `false` — leave it off for the best mesh.
`topology`	No	`triangle` (default) or `quad`. Requires `should_remesh`.
`target_polycount`	No	Face count, 100–300000. Default: `30000`. Requires `should_remesh`.
`decimation_mode`	No	Adaptive polycount level `1`–`4` (ultra → low). Requires `should_remesh`; overrides `target_polycount`.
`save_pre_remeshed_model`	No	Also return the GLB from before the remesh. Requires `should_remesh`. Default: `false`
`pose_mode`	No	`a-pose`, `t-pose`, or empty for no forced pose.
`target_formats`	No	Any of `glb`, `obj`, `fbx`, `stl`, `usdz`, `3mf`. Default: `["glb"]`
`auto_size`	No	Scale the model to an AI-estimated real-world height. Default: `false`
`origin_at`	No	`bottom` (default) or `center`, when `auto_size` is on.
`alpha_thumbnail`	No	Also render a transparent-background preview. Default: `false`
`multi_view_thumbnails`	No	Also render right / back / left previews (+~3s). Default: `false`
`moderation`	No	Screen every source image and the texture prompt before generating. Default: `false`

target_formats defaults to GLB alone rather than every format: each extra format is another file to generate and store, so ask for OBJ/FBX/STL/USDZ/3MF only when your pipeline needs them.

topology, target_polycount and decimation_mode only take effect when should_remesh is on — they configure the remesh phase, so with remeshing off they are ignored upstream.

How to Use

curl -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
  -H "Authorization: Bearer $AIP_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "meshy-v7/multi-image-to-3d",
    "reference_images": [
      "https://static.atlascloud.ai/media/images/chair_front.png",
      "https://static.atlascloud.ai/media/images/chair_side.png",
      "https://static.atlascloud.ai/media/images/chair_back.png"
    ],
    "should_texture": true,
    "enable_pbr": true,
    "texture_resolution": "4k",
    "target_formats": ["glb"]
  }'

Generation is asynchronous — poll /api/v1/model/prediction/{request_id} until status is completed, then read the model URLs from outputs. files gives the same URLs with their format and MIME type, and thumbnail is a rendered preview image.

Pricing

Billed per request, in Meshy credits:

Configuration	Credits
Mesh only (`should_texture: false`)	20
Mesh + texture at `2k` / `4k`	30
Mesh + texture at `8k`	35
`ultra_mode`	+5 on top of the above

The price is per request, not per input image — four views cost the same as one. Failed tasks are not charged.

Best Use Cases

Product digitisation — the standard four-angle product shoot converts directly into a 3D listing asset.
Furniture and hard goods — objects whose back and underside matter to the buyer.
Museum and archive pieces — reconstruct from existing photography without a scanner.
Characters and figures — front/side/back reference sheets are exactly what this mode wants.
3D printing — target_formats: ["stl", "3mf"] plus auto_size for a physically-scaled print.

Pro Tips

Order matters for the first image only — put the front view first; the rest can be in any order.
Keep the object identical across shots: same lighting, same finish, same configuration. Contradictory views produce a muddled mesh.
Front / side / back beats four near-identical three-quarter angles. Coverage is what buys accuracy, not count.
Use texture_images when the geometry references are clean studio shots but the material should come from detail photography.
Turn image_enhancement off when your inputs are already clean renders and you need them reproduced exactly.
One good view often beats four mediocre ones — if the extra angles are blurry or inconsistent, drop them.

Notes

reference_images accepts between 1 and 4 images; more are rejected.
Supported input formats are jpg, jpeg and png; other formats are rejected upstream.
texture_resolution must be spelled exactly as documented (lowercase 2k / 4k / 8k): a request is rejected rather than silently priced at a different rate.
texture_images requires Meshy 7 and cannot be combined with texture_image or texture_prompt.
enable_pbr requires should_texture: true.
model_type is not exposed on the Meshy V7 models: smart-topology needs the Smart Topology family (ai_model meshy-t2), which these models do not serve, and the multi-image endpoint has no variants at all.
symmetry_mode and is_a_t_pose are deprecated upstream and are not exposed here; use pose_mode for poses.
Generated files are re-hosted on AtlasCloud storage, so the URLs you receive are ours and stay reachable — Meshy itself deletes API assets after a few days.

Meshy 7 Image-to-3D — the same reconstruction from a single image.
Meshy 7 Text-to-3D — generate a textured model from a written description, no image needed.

Explore Similar Models

NEW

image-to-3D

Meshy v7 Image-to-3D

Meshy v7 Image-to-3D reconstructs a textured 3D model from a single image in one request. Outputs GLB/OBJ/FBX/STL/USDZ/3MF with optional PBR maps up to 8K, a settable polygon budget, and optional four-angle preview renders.

Meshy v7 Text-to-3D

Meshy v7 Text-to-3D generates a 3D mesh from a text prompt in two stages: a preview that produces the untextured geometry, and a refine that textures a preview you kept. Outputs GLB/OBJ/FBX/STL/USDZ/3MF with optional PBR maps up to 8K, a settable polygon budget, and A/T-pose output for characters.

GPT Image 2.5 Sunburst Text-to-Image

GPT Image 2.5 Sunburst generates images from natural-language prompts with arbitrary resolutions up to 3840x2160, five quality tiers including xhigh and max, and first-class transparent backgrounds. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

GPT Image 2.5 Sunburst Edit

GPT Image 2.5 Sunburst Edit applies natural-language instructions to up to 16 reference images, with an optional mask, arbitrary resolutions up to 3840x2160, five quality tiers including xhigh and max, and transparent-background output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

GPT Image 2.5 Flare Text-to-Image

GPT Image 2.5 Flare generates images from natural-language prompts with arbitrary resolutions up to 3840x2160, five quality tiers including xhigh and max, and first-class transparent backgrounds. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

GPT Image 2.5 Flare Edit

GPT Image 2.5 Flare Edit applies natural-language instructions to up to 16 reference images, with an optional mask, arbitrary resolutions up to 3840x2160, five quality tiers including xhigh and max, and transparent-background output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Openai GPT Image 2 Text-to-Image

GPT Image 2 text to image is OpenAI's fast, cost-efficient text-to-image generator powered by GPT-5 guidance. Create photorealistic shots, product renders, concept art, and stylized graphics from natural-language prompts (optionally conditioned with an image). Supports custom aspect ratios, seeds, negative prompts, hex color hints, and style presets. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

GPT Image 2 Developer Text-to-Image generates polished visuals from natural-language prompts, with common aspect ratios and 1k, 2k, or supported 4k output tiers. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Seedream v4.7 Edit Sequential

ByteDance Seedream 4.7 image editing model with batch generation support. Produce a coherent set of edited images from reference inputs.

Seedream v4.7 Edit

ByteDance Seedream 4.7 image editing model. Executes edit instructions precisely while preserving identity, lighting and local structure of the source image.

From

$0.03/PIC

One API for All Media AI.

Explore all models

Meshy v7 Multi-Image-to 3D API by MESHY

INPUT

OUTPUT

Parameters

Code Example

Install

Authentication

HTTP Headers

Submit a request

Submit a Request

Request Body

Response

Check Status

Polling Example

Status Values

Completed Response

Upload Files

Upload Example

Response

Input Schema

Example Request Body

Output Schema

Example Response

Atlas Cloud Skills

Supported Clients

Install

Setup API Key

Capabilities

MCP Server

Supported Clients

Install

Configuration

Available Tools

API Schema

LLM-Friendly Prompt Template

Meshy 7 Multi-Image-to-3D

Why Choose This?

Parameters

How to Use

Pricing

Best Use Cases

Pro Tips

Notes

Related Models

Explore Similar Models

Meshy v7 Image-to-3D

Meshy v7 Text-to-3D

GPT Image 2.5 Sunburst Text-to-Image

GPT Image 2.5 Sunburst Edit

GPT Image 2.5 Flare Text-to-Image

GPT Image 2.5 Flare Edit

Openai GPT Image 2 Text-to-Image

Openai GPT Image 2 Edit

GPT Image 2.5 Flare Developer Edit

GPT Image 2.5 Flare Developer Text-to-Image

GPT Image 2.5 Sunburst Developer Edit

GPT Image 2.5 Sunburst Developer Text-to-Image

GPT Image 2 Developer Edit

GPT Image 2 Developer Text-to-Image

Seedream v4.7 Edit Sequential

Seedream v4.7 Edit

One API for All Media AI.

INPUT

OUTPUT

Parameters

Code Example

Install

Authentication

HTTP Headers

Submit a request

Submit a Request

Request Body

Response

Check Status

Polling Example

Status Values

Completed Response

Upload Files

Upload Example

Response