# Meshy 6 · Image to 3D API

> Meshy 6 minn immaġni għal 3D b’remeshing, mapep PBR, rigging umanojde fakultattiv u animazzjoni

Jibni mudell 3D minn immaġni waħda (`image_url`). `model_type` huwa standard, lowpoly jew smart-topology, it-topoloġija hija triangle jew quad, u `target_polycount` ivarja minn 100 sa 300000 (smart topology massimu 15,000). L-għażliet ikopru t-texturing, mapep PBR, simetrija, poża A jew T, u rigging umanojde bi issettjar tal-animazzjoni minn qabel. L-output jinkludi fajls GLB u FBX.

- Model id: `meshy/v6/image-to-3d`
- Made by: Meshy
- Category: Image to 3D
- Output: 3d
- Price per run: from $0.80 / run (cheapest run $0.80 (800 API credits))
- Run: `POST https://api.doitong.com/v1/run/meshy/v6/image-to-3d`
- Quote: `POST https://api.doitong.com/v1/quote/meshy/v6/image-to-3d`
- Docs page: https://doitong.com/mt/developers/models/meshy/v6/image-to-3d

## Pricing

Price: **from $0.80 / run** (the lowest tier; the quote prices your exact input). Price per run: the input files are measured before the run (length, resolution, frame rate). The quote measures the same files and is exactly what the run charges.

The full example input below costs $1.20 = 1200 API credits (1 run × $1.20).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.com/v1/quote/meshy/v6/image-to-3d` with the same JSON body returns the exact price for that input; the quote is exactly what a run charges. Invalid input is never charged and failed or canceled requests are refunded automatically.

## Input parameters

Send either the canonical name or the native field name (not both). Canonical names are the same across models.

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `image_url` | `image` | string (image URL) | yes |  |  | Ipprovdi l-immaġni sors għall-ħolqien 3D permezz ta’ URL jew URI tad-dejta base64, billi tuża .jpg, .jpeg, .png, AVIF, jew HEIF. Il-konverżjoni awtomatika tieħu ħsieb l-inputs AVIF u HEIF. |
| `model_type` |  | enum (string) | no | `standard` | `standard`, `lowpoly`, `smart-topology` | Modalità tal-mesh 3D: agħżel 'lowpoly' għal riżultat low-poly ottimizzat għal poligoni aktar nodfa; f’din il-modalità Meshy tinjora topology, target_polycount, u should_remesh. Għal riżultat konvenzjonali b’dettall għoli agħżel 'standard', jew agħżel 'smart-topology' biex tuża Meshy-T2 u tikseb partijiet nodfa ġġenerati separatament mill-bidu. |
| `topology` |  | enum (string) | no | `triangle` | `quad`, `triangle` | Għażla tat-topoloġija tal-mudell bejn Triangle għal dettall ġeometriku u Quad għal lixxija tal-wiċċ. |
| `target_polycount` |  | integer | no | `30000` | 100 – 300,000 | Mira tal-għadd tal-poligoni, limitata għal 15,000 meta model_type ikun 'smart-topology'. Jekk il-mira titħalla barra f’dik il-modalità, jintgħażel il-valur prestabbilit aktar baxx ta’ Meshy, 4,000. |
| `symmetry_mode` |  | enum (string) | no | `auto` | `off`, `auto`, `on` | Agħżel jekk il-ġenerazzjoni tal-mudell tisforzax is-simetrija b’On, tneħħihiex b’Off, jew tiddeċidix awtomatikament b’Auto. |
| `should_remesh` |  | boolean | no | `true` |  | Jattiva jew jitfi l-istadju tar-remeshing. |
| `should_texture` |  | boolean | no | `true` |  | Jattiva jew jitfi l-ġenerazzjoni tat-texture. |
| `enable_pbr` |  | boolean | no | `false` |  | Iżid mapep PBR metalliċi, ta’ roughness u normali flimkien mal-kulur bażi. |
| `is_a_t_pose` |  | boolean | no | `false` |  | Swiċċ tal-ġenerazzjoni tat-T-pose attivat b’true; deprecated favur pose_mode. |
| `pose_mode` |  | enum (string) | no | `` | `a-pose`, `t-pose`, `` | Ħalli s-stringa vojta biex ma tispeċifikax il-pose tal-mudell iġġenerat, jew itlob A-pose b’'a-pose' jew T-pose b’'t-pose'. |
| `texture_prompt` |  | string \| null | no |  | ≤ 600 characters | Istruzzjonijiet tat-test li jidderieġu l-ġenerazzjoni tat-texture. |
| `texture_image_url` |  | string (image URL) \| null | no |  |  | Immaġni ta’ referenza 2D li tidderieġi l-ġenerazzjoni tat-texture. |
| `enable_rigging` |  | boolean | no | `false` |  | Rigging awtomatiku umanojdi, l-aktar effettiv għal mudelli umanojdi li r-riġlejn tagħhom jintgħarfu b’mod ċar. L-attivazzjoni tiegħu tagħmel ir-rigging tal-mudell iġġenerat u tipprovdi animazzjonijiet bażiċi għall-mixi u t-tmexxija. |
| `rigging_height_meters` |  | number | no | `1.7` | > 0 | Ipprovdi għoli stmat tal-karattru f’metri meta enable_rigging ikun true; inkella, dan il-valur ma jkollu l-ebda effett. |
| `enable_animation` |  | boolean | no | `false` |  | Jekk il-mudell rigged jirċevix animazzjoni preset, li teħtieġ li enable_rigging ikun true. |
| `animation_action_id` |  | integer | no | `92` |  | ID tal-animazzjoni preset tal-librerija Meshy, bl-azzjonijiet disponibbli elenkati f’https://docs.meshy.ai/en/api/animation-library. Il-validazzjoni u l-użu japplikaw biss meta enable_animation ikun true: valuri barra [0, 696] jiġu rrifjutati b’422, u "Idle" jikkorrispondi għal `0`. |
| `enable_safety_checker` |  | boolean | no | `true` |  | Swiċċ tal-kontroll tas-sikurezza tal-ipproċessar: true jagħmel kontroll tas-sikurezza tal-input prerekwiżit għall-ipproċessar. |

File parameters (`image`, `texture_image_url`) take a public `https://` URL, a `data:` URI up to 10 MB, or the `file_url` of an upload from `POST /files`.

## Example input

Required parameters only:

```json
{
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}
```

A fuller example:

```json
{
  "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}
```

## Run it

Set `DOITONG_API_KEY` to a key from https://doitong.com/developers/dashboard#keys. `?wait=20` returns the finished request in the same call when it is ready within 20 seconds; otherwise poll `GET /requests/{id}` (it also accepts `?wait=`), or pass `webhook_url`.

### curl

```bash
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/meshy/v6/image-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/meshy/v6/image-to-3d?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
```

### Python

```python
import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v6/image-to-3d", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
```

### MCP

The MCP server at `https://api.doitong.com/v1/mcp` exposes the tools `search_models`, `get_model`, `quote`, `run`, `get_request`, `cancel_request`, `list_requests`, `create_upload` and `get_account`. A `run` call for this model:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "meshy/v6/image-to-3d",
      "input": {
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "wait_seconds": 20
    }
  }
}
```

## Response

Every call returns a request object. `status` is one of `queued`, `running`, `succeeded`, `failed`, `canceled`. `outputs` lists the generated files with URLs on our storage (kept forever, or 7 days with `?storage=temporary`; `storage` says which); `output` is the model's own result object with the same URLs.

```json
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "meshy/v6/image-to-3d",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1200,
    "usd": "1.20",
    "charged": 1200,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "animation_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "animation_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "thumbnail": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "model_urls": {
      "glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "obj": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "usdz": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "blend": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "stl": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "texture_urls": [
      {
        "base_color": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "metallic": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "normal": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        },
        "roughness": {
          "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
          "content_type": "image/jpeg",
          "file_name": "0-output.jpeg",
          "file_size": 1843200
        }
      }
    ],
    "seed": 42,
    "rigged_character_glb": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "rigged_character_fbx": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "basic_animations": {
      "walking_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "walking_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_fbx": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      },
      "running_armature_glb": {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200
      }
    },
    "rig_task_id": "string"
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `animation_glb` | object {url, content_type, file_name, file_size} \| null | Riżultat tal-animazzjoni li fih il-mudell 3D bħala GLB; ir-rispons ma jinkludix dan ir-riżultat sakemm enable_animation ma jkunx true. |
| `animation_fbx` | object {url, content_type, file_name, file_size} \| null | Riżultat tal-animazzjoni li fih il-mudell 3D bħala FBX; ir-rispons ma jinkludix dan ir-riżultat sakemm enable_animation ma jkunx true. |
| `model_glb` | object {url, content_type, file_name, file_size} | Fajl GLB li fih l-oġġett 3D iġġenerat. |
| `thumbnail` | object {url, content_type, file_name, file_size} \| null | Thumbnail li juri preview tal-mudell iġġenerat. |
| `model_urls` | object {glb, fbx, obj, usdz, blend, stl} | Links għall-mudell 3D f'diversi formati. |
| `texture_urls` | array of object {base_color, metallic, normal, roughness} | Oġġetti tal-fajls tat-texture f’firxa strutturata biex taqbel mal-Meshy API. |
| `seed` | integer \| null | Seed tal-ġenerazzjoni, meta jkun disponibbli. |
| `rigged_character_glb` | object {url, content_type, file_name, file_size} \| null | Riżultat tar-rigging ikkunsinnat bħala fajl ta’ karattru GLB; assenti mir-rispons sakemm enable_rigging ma jkunx true. |
| `rigged_character_fbx` | object {url, content_type, file_name, file_size} \| null | Riżultat tar-rigging ikkunsinnat bħala fajl ta’ karattru FBX; assenti mir-rispons sakemm enable_rigging ma jkunx true. |
| `basic_animations` | object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} \| null | Animazzjonijiet bażiċi tal-mixi u t-tmexxija, inklużi biss jekk enable_rigging ikun true. |
| `rig_task_id` | string \| null | Identifikatur għall-kompitu tar-rigging; inkluż biss jekk enable_rigging ikun true. |

## Related models

- [Meshy 6 · Text to 3D](https://doitong.com/developers/models/meshy/v6/text-to-3d.md) (`meshy/v6/text-to-3d`): $0.80 / request
- [Meshy 6 Preview · Image to 3D](https://doitong.com/developers/models/meshy/v6-preview/image-to-3d.md) (`meshy/v6-preview/image-to-3d`): from $0.80 / run
- [Meshy 7.1 Image to 3D](https://doitong.com/developers/models/meshy/v7.1/image-to-3d.md) (`meshy/v7.1/image-to-3d`): from $0.80 / run
- [Meshy 7.1 Multi Image to 3D](https://doitong.com/developers/models/meshy/v7.1/multi-image-to-3d.md) (`meshy/v7.1/multi-image-to-3d`): from $0.80 / run
- [Meshy V7 Image to 3D](https://doitong.com/developers/models/meshy/v7/image-to-3d.md) (`meshy/v7/image-to-3d`): from $0.80 / run
- [Meshy V7 Multi Image to 3D](https://doitong.com/developers/models/meshy/v7/multi-image-to-3d.md) (`meshy/v7/multi-image-to-3d`): from $0.80 / run
- [Hi3D Image to 3D](https://doitong.com/developers/models/hitem3d/hi3d/image-to-3d.md) (`hitem3d/hi3d/image-to-3d`): $0.50 / run
- [Hi3D Image to 3D · v3.0](https://doitong.com/developers/models/hitem3d/hi3d/v3.0/image-to-3d.md) (`hitem3d/hi3d/v3.0/image-to-3d`): from $1.80 / run

## Links

- HTML page: https://doitong.com/developers/models/meshy/v6/image-to-3d
- All models and guides for AI agents: https://doitong.com/developers/llms.txt
- OpenAPI 3.1 with this model's typed request body: https://doitong.com/developers/openapi.json?model=meshy/v6/image-to-3d
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/meshy/v6/image-to-3d