# Meshy 6 · Text to 3D API

> Tekstistä 3D-malliksi muuntava generaattori, jossa on esikatselu- ja teksturoidut tilat sekä valinnaiset PBR-, luustotus- ja animaatioasetukset

Rakentaa 3D-mallin enintään 600 merkin tekstimuotoisesta `prompt`-kehotteesta. `mode` valitsee teksturoimattoman geometrian (`preview`) tai teksturoidun tuloksen (`full`). `model_type` voi olla standard, lowpoly tai smart-topology, ja `target_polycount` vaihtelee välillä 100–300000; smart topology -tilan enimmäisarvo on 15000. Malliin voi myös lisätä PBR-kartat, asennon, humanoidin luustotuksen ja animaatioesiasetuksen.

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

## Pricing

Price: **$0.80 / request**. Billed once per request.

The full example input below costs $0.80 = 800 API credits (1 request × 800 API credits).

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/text-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

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `prompt` |  | string | yes |  | ≤ 600 characters | 3D-mallina esitettävän objektin kuvaus, enintään 600 merkkiä. |
| `mode` |  | enum (string) | no | `full` | `preview`, `full` | Generointitila: 'preview' tuottaa geometrian ilman tekstuureja, kun taas 'full' tuottaa teksturoidun mallin yhdistämällä preview- ja refine-vaiheet. |
| `seed` |  | integer \| null | no |  |  | Käytä tätä siementä muuttumattoman kehotteen kanssa yleensä aiemman tuloksen toistamiseen. |
| `model_type` |  | enum (string) | no | `standard` | `standard`, `lowpoly`, `smart-topology` | 3D-verkon tila: valitse 'lowpoly' puhtaampiin polygoneihin optimoitua low-poly-tulosta varten; tässä tilassa Meshy ohittaa topologian, target_polycount-arvon ja should_remesh-arvon. Tavanomaiseen tarkkaan tulokseen valitse 'standard' tai 'smart-topology', jolloin Meshy-T2:ta käytetään geometrian (preview) vaiheessa ja puhtaat osat tuotetaan alusta alkaen erikseen. |
| `topology` |  | enum (string) | no | `triangle` | `quad`, `triangle` | Mallin topologiavalinta: Triangle geometriseen yksityiskohtaisuuteen tai Quad pinnan tasaisuuteen. |
| `target_polycount` |  | integer | no | `30000` | 100 – 300,000 | Polygonimäärän tavoite, joka rajoitetaan arvoon 15,000, kun model_type on 'smart-topology'. Jos tavoite jätetään tässä tilassa pois, Meshyn pienempi oletus on 4,000. |
| `should_remesh` |  | boolean | no | `true` |  | Ohita uudelleenverkotus ja vastaanota raaka kolmioverkko asettamalla arvoksi false; muuten uudelleenverkotusvaihe otetaan käyttöön. |
| `symmetry_mode` |  | enum (string) | no | `auto` | `off`, `auto`, `on` | Mallin generoinnin aikana käytettävä symmetria-asetus. |
| `enable_pbr` |  | boolean | no | `false` |  | Määrittää, generoidaanko perusvärin ohella metallisuus-, karheus- ja normaalit PBR-kartat. |
| `is_a_t_pose` |  | boolean | no | `false` |  | true-arvolla aktivoitava T-asennon generointikytkin; vanhentunut pose_mode-asetuksen hyväksi. |
| `pose_mode` |  | enum (string) | no | `` | `a-pose`, `t-pose`, `` | Jätä merkkijono tyhjäksi, jos et halua määrittää generoidun mallin asentoa, tai pyydä A-asentoa arvolla 'a-pose' tai T-asentoa arvolla 't-pose'. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Sallii suuren kielimallin täydentää kehotetta yksityiskohdilla. Laajennuksen käyttöönotto ei muuta kehotteen merkitystä. |
| `texture_prompt` |  | string \| null | no |  | ≤ 600 characters | Ohjaa teksturointia ylimääräisellä tekstikehotteella 'full'-tilassa; muut tilat eivät käytä sitä. |
| `texture_image_url` |  | string (image URL) \| null | no |  |  | Tekstuurien generointiin käytettävä 2D-viitekuva, jota käytetään vain 'full'-tilassa. |
| `enable_rigging` |  | boolean | no | `false` |  | Automaattinen humanoidin riggaus, joka toimii parhaiten malleilla, joiden raajat erottuvat selkeästi. Käyttöönotto rigaa generoidun mallin ja toimittaa perusanimaatiot kävelyä ja juoksua varten. |
| `rigging_height_meters` |  | number | no | `1.7` | > 0 | Anna hahmon arvioitu korkeus metreinä, kun enable_rigging on true; muuten arvolla ei ole vaikutusta. |
| `enable_animation` |  | boolean | no | `false` |  | Määrittää, saako rigattu malli esiasetetun animaation; tämä edellyttää, että enable_rigging on true. |
| `animation_action_id` |  | integer | no | `92` |  | Meshy-kirjaston animaation esiasetustunnus; käytettävissä olevat toiminnot on lueteltu osoitteessa https://docs.meshy.ai/en/api/animation-library. Kelpoisuuden tarkistus ja käyttö koskevat vain tilannetta, jossa enable_animation on true: alueen [0, 696] ulkopuoliset arvot hylätään vastauksella 422, ja "Idle" vastaa arvoa `0`. |
| `enable_safety_checker` |  | boolean | no | `true` |  | Esikäsittelyn turvatarkistuksen kytkin: true tekee syötteen turvatarkistuksesta käsittelyn edellytyksen. |

File parameters (`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
{
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
```

A fuller example:

```json
{
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
}
```

## 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/text-to-3d?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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/text-to-3d?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }),
});
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 = {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/meshy/v6/text-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/text-to-3d",
      "input": {
        "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
      },
      "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/text-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": 800,
    "usd": "0.80",
    "charged": 800,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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,
    "prompt": "A rustic, antique wooden treasure chest with a curved, domed lid, constructed from weathered, dark brown planks exhibiting prominent wood grain and subtle distress. It's heavily reinforced with broad, dark grey, oxidized metal bands secured by numerous circular rivets. Ornate, dark iron decorative elements featuring swirling foliate patterns and dragon motifs adorn the corners and lid. A prominent, circular, intricately carved metal lock plate with a central keyhole dominates the front, flanked by two large, dark metallic pull rings.",
    "actual_prompt": "string",
    "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 | Animaatiotulos, joka sisältää 3D-mallin GLB-muodossa; vastaus ei sisällä tulosta, ellei enable_animation ole true. |
| `animation_fbx` | object {url, content_type, file_name, file_size} \| null | Animaatiotulos, joka sisältää 3D-mallin FBX-muodossa; vastaus ei sisällä tulosta, ellei enable_animation ole true. |
| `model_glb` | object {url, content_type, file_name, file_size} | Generoidun 3D-objektin sisältävä GLB-tiedosto. |
| `thumbnail` | object {url, content_type, file_name, file_size} \| null | Generoidun mallin esikatselun näyttävä pikkukuva. |
| `model_urls` | object {glb, fbx, obj, usdz, blend, stl} | Linkit 3D-malliin eri muodoissa. |
| `texture_urls` | array of object {base_color, metallic, normal, roughness} | Tekstuuritiedostot objektitaulukkona. |
| `seed` | integer \| null | Generoinnissa käytettävä siemenarvo. |
| `prompt` | string | Generointiin annettu tekstikehote. |
| `actual_prompt` | string \| null | Generointiin tosiasiassa käytetty kehote, kun kehotteen laajennus oli käytössä. |
| `rigged_character_glb` | object {url, content_type, file_name, file_size} \| null | GLB-hahmotiedostona toimitettava riggaustulos; puuttuu vastauksesta, ellei enable_rigging ole true. |
| `rigged_character_fbx` | object {url, content_type, file_name, file_size} \| null | FBX-hahmotiedostona toimitettava riggaustulos; puuttuu vastauksesta, ellei enable_rigging ole true. |
| `basic_animations` | object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} \| null | Perus- ja juoksuanimaatiot, jotka sisällytetään vain, jos enable_rigging on true. |
| `rig_task_id` | string \| null | Riggaustehtävän tunniste; sisällytetään vain, jos enable_rigging on true. |

## Related models

- [Meshy 6 · Image to 3D](https://doitong.com/developers/models/meshy/v6/image-to-3d.md) (`meshy/v6/image-to-3d`): from $0.80 / run
- [Meshy 6 Preview · Text to 3D](https://doitong.com/developers/models/meshy/v6-preview/text-to-3d.md) (`meshy/v6-preview/text-to-3d`): $0.80 / request
- [Meshy 7.1 Text to 3D](https://doitong.com/developers/models/meshy/v7.1/text-to-3d.md) (`meshy/v7.1/text-to-3d`): from $0.80 / run
- [Meshy V7 Text to 3D](https://doitong.com/developers/models/meshy/v7/text-to-3d.md) (`meshy/v7/text-to-3d`): from $0.80 / run
- [Hunyuan 3d](https://doitong.com/developers/models/hunyuan-3d/v3.1/rapid/text-to-3d.md) (`hunyuan-3d/v3.1/rapid/text-to-3d`): from $0.225 / request
- [Hunyuan 3D Pro Text to 3D](https://doitong.com/developers/models/hunyuan-3d/v3.1/pro/text-to-3d.md) (`hunyuan-3d/v3.1/pro/text-to-3d`): $0.375 / run
- [Hunyuan Motion \[0.46B\]](https://doitong.com/developers/models/hunyuan-motion/fast.md) (`hunyuan-motion/fast`): $0.06 / request
- [Hunyuan Motion \[1B\]](https://doitong.com/developers/models/hunyuan-motion.md) (`hunyuan-motion`): $0.08 / request

## Links

- HTML page: https://doitong.com/developers/models/meshy/v6/text-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/text-to-3d
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/meshy/v6/text-to-3d