Skip to main content
ArtEmotion
3D

Smart Topology Image to 3D

Credit-based pricing. Supports reference images.

Smart Topology Image to 3D preview
Output
3D mesh
Aspect ratio
1:1
Resolution
1024

Inputs

  • Reference image (required)
LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=meshy/smart-topology/image-to-3d.

POST/api/v1/generate17 fields · 2 required
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
target_polycountnumberOptionalGenerate directly at this approximate face count (100-15,000). No separate remesh pass is used. · Default: 4000 · Range: 100–15000
should_texturebooleanOptionalGenerate base-color textures. Turning this off uses the lower untextured price. · Default: true
enable_pbrbooleanOptionalGenerate metallic, roughness, and normal maps in addition to base color. Requires Texture. · Default: false
texture_promptstringOptionalOptional material or appearance guidance. Maximum 600 characters.
texture_image_urlstringOptionalOptional JPG or PNG image to guide texturing. A texture prompt takes priority when both are provided.
pose_modestringOptionalRequest an A-pose or T-pose for character inputs. · Allowed: , a-pose, t-pose · Default:
auto_sizebooleanOptionalEstimate the object's real-world height and scale the output automatically. · Default: false
origin_atstringOptionalOrigin position when Auto Size is enabled. · Allowed: bottom, center · Default: bottom
aspect_ratiostringOptionalAllowed: 1:1
resolutionstringOptionalAllowed: 1024
reference_image_urlstringRequiredFormat: uri
Minimal request example
{
  "model_id": "meshy/smart-topology/image-to-3d",
  "reference_image_url": "https://example.com/reference_image"
}
Raw JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fsmart-topology%2Fimage-to-3d",
  "title": "Smart Topology Image to 3D generation request",
  "description": "Request body accepted by POST /api/v1/generate for meshy/smart-topology/image-to-3d.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "meshy/smart-topology/image-to-3d",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "target_polycount": {
      "title": "Target Face Count",
      "description": "Generate directly at this approximate face count (100-15,000). No separate remesh pass is used.",
      "default": 4000,
      "type": "number",
      "minimum": 100,
      "maximum": 15000,
      "multipleOf": 100
    },
    "should_texture": {
      "title": "Texture",
      "description": "Generate base-color textures. Turning this off uses the lower untextured price.",
      "default": true,
      "type": "boolean"
    },
    "enable_pbr": {
      "title": "Enable PBR",
      "description": "Generate metallic, roughness, and normal maps in addition to base color. Requires Texture.",
      "default": false,
      "type": "boolean"
    },
    "texture_prompt": {
      "title": "Texture Prompt",
      "description": "Optional material or appearance guidance. Maximum 600 characters.",
      "type": "string"
    },
    "texture_image_url": {
      "title": "Texture Guide Image",
      "description": "Optional JPG or PNG image to guide texturing. A texture prompt takes priority when both are provided.",
      "type": "string"
    },
    "pose_mode": {
      "title": "Pose Mode",
      "description": "Request an A-pose or T-pose for character inputs.",
      "default": "",
      "type": "string",
      "enum": [
        "",
        "a-pose",
        "t-pose"
      ]
    },
    "auto_size": {
      "title": "Auto Size",
      "description": "Estimate the object's real-world height and scale the output automatically.",
      "default": false,
      "type": "boolean"
    },
    "origin_at": {
      "title": "Origin",
      "description": "Origin position when Auto Size is enabled.",
      "default": "bottom",
      "type": "string",
      "enum": [
        "bottom",
        "center"
      ]
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024"
      ]
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "reference_image_url"
  ],
  "additionalProperties": false
}

FAQ

How much does Smart Topology Image to 3D cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if Smart Topology Image to 3D fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Smart Topology Image to 3D from the API?

Yes. Use POST /api/v1/generate with model_id: "meshy/smart-topology/image-to-3d". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with Smart Topology Image to 3D?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.