# Meshy 6 Preview · Text to 3D API

> Téacs-go-3D Meshy 6 Preview le mód réamhamhairc nó lán-uigeachta agus leathnú roghnach leide

Gineann sé samhail 3D ó leid suas le 600 carachtar. Is é `mode` preview do gheoiméadracht gan uigeacht nó full do mhúnla le huigeacht. I measc na roghanna tá `enable_prompt_expansion`, cineál mogalla, topology, `target_polycount` (100 go 300000), mapaí PBR, mód staide agus rigáil daonnóideach le réamhshocruithe beochana.

- Model id: `meshy/v6-preview/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.ru/v1/run/meshy/v6-preview/text-to-3d`
- Quote: `POST https://api.doitong.ru/v1/quote/meshy/v6-preview/text-to-3d`
- Docs page: https://doitong.com/ga/developers/models/meshy/v6-preview/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.ru/v1/quote/meshy/v6-preview/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 | Cur síos ar an réad atá le léiriú mar shamhail 3D, teoranta do 600 carachtar. |
| `mode` |  | enum (string) | no | `full` | `preview`, `full` | Mód giniúna: aschuir 'preview' céimseata gan uigeachtaí, agus aschuir 'full' samhail uigeach trí preview agus refine a chomhcheangal. |
| `seed` |  | integer \| null | no |  |  | Athúsáid an síol seo le leid gan athrú chun toradh níos luaithe a atáirgeadh de ghnáth. |
| `model_type` |  | enum (string) | no | `standard` | `standard`, `lowpoly`, `smart-topology` | Mód mogall 3D: roghnaigh 'lowpoly' le haghaidh aschur íseal-pholagán optamaithe do pholagáin níos glaine; sa mhód seo déanann Meshy neamhaird de topology, target_polycount agus should_remesh. Le haghaidh gnáth-aschur ardsonraí roghnaigh 'standard', nó 'smart-topology' chun Meshy-T2 a úsáid le linn na céime céimseata (preview) agus páirteanna glana a ghiniúint ar leith ón tús. |
| `topology` |  | enum (string) | no | `triangle` | `quad`, `triangle` | Rogha topology na samhla idir Triangle le haghaidh sonraí geoiméadracha agus Quad le haghaidh réidhe dromchla. |
| `target_polycount` |  | integer | no | `30000` | 100 – 300,000 | Sprioc líon na bpolagán, teoranta do 15,000 nuair atá model_type 'smart-topology'. Mura sonraítear an sprioc sa mhód sin, roghnaítear réamhshocrú níos ísle Meshy de 4,000. |
| `should_remesh` |  | boolean | no | `true` |  | Scipeáil athmhogalú agus faigh an mogall triantánach amh trí false a shocrú; murach sin, cumasaigh céim an athmhogalaithe. |
| `symmetry_mode` |  | enum (string) | no | `auto` | `off`, `auto`, `on` | Socrú siméadrachta a chuirtear i bhfeidhm agus an tsamhail á giniúint. |
| `enable_pbr` |  | boolean | no | `false` |  | Rialaíonn sé giniúint léarscáileanna PBR miotalachta, garbhachta agus normálta taobh leis an mbundath. |
| `is_a_t_pose` |  | boolean | no | `false` |  | Lascthrealamh giniúna T-pose a ghníomhaíonn true; tá sé as feidhm i bhfabhar pose_mode. |
| `pose_mode` |  | enum (string) | no | `` | `a-pose`, `t-pose`, `` | Fág an teaghrán folamh chun staidiúir na samhla ginte a fhágáil gan sonrú, nó iarr A-pose le 'a-pose' nó T-pose le 't-pose'. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Lig do mhúnla mór teanga an leid a shaibhriú le sonraí. Ní athraíonn cumasú an leathnaithe brí na leide. |
| `texture_prompt` |  | string \| null | no |  | ≤ 600 characters | Treoraigh uigeacht le leid téacs bhreise sa mhód 'full'; ní úsáideann na móid eile í. |
| `texture_image_url` |  | string (image URL) \| null | no |  |  | Íomhá thagartha 2D do ghiniúint uigeachta, curtha i bhfeidhm sa mhód 'full' amháin. |
| `enable_rigging` |  | boolean | no | `false` |  | Rigáil uathoibríoch dhaonna, is éifeachtaí do shamhlacha daonna a bhfuil a ngéaga in-idirdhealaithe go soiléir. Trí í a chumasú, rigáiltear an tsamhail ginte agus soláthraítear beochana bunúsacha siúil agus reatha. |
| `rigging_height_meters` |  | number | no | `1.7` | > 0 | Soláthair airde mheasta an charachtair i méadar nuair atá enable_rigging fíor; murach sin, níl aon éifeacht ag an luach seo. |
| `enable_animation` |  | boolean | no | `false` |  | An bhfaigheann an tsamhail rigáilte beochan réamhshocraithe, rud a éilíonn go mbeadh enable_rigging fíor. |
| `animation_action_id` |  | integer | no | `92` |  | Aitheantas réamhshocraithe beochana leabharlann Meshy, agus na gníomhartha atá ar fáil liostaithe ag https://docs.meshy.ai/en/api/animation-library. Ní bhaineann bailíochtú agus úsáid leis ach nuair atá enable_animation fíor: diúltaítear do luachanna lasmuigh de [0, 696] le 422, agus comhfhreagraíonn "Idle" do `0`. |
| `enable_safety_checker` |  | boolean | no | `true` |  | Lascthrealamh seiceála sábháilteachta réamhphróiseála: déanann true seiceáil sábháilteachta ionchuir réamhriachtanach don phróiseáil. |

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.ru/v1/run/meshy/v6-preview/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.ru/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-preview/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.ru/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-preview/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.ru/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-preview/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-preview/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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `animation_glb` | object {url, content_type, file_name, file_size} \| null | Toradh beochana ina bhfuil an tsamhail 3D mar GLB; fágann an freagra an toradh seo ar lár mura bhfuil enable_animation fíor. |
| `animation_fbx` | object {url, content_type, file_name, file_size} \| null | Toradh beochana ina bhfuil an tsamhail 3D mar FBX; fágann an freagra an toradh seo ar lár mura bhfuil enable_animation fíor. |
| `model_glb` | object {url, content_type, file_name, file_size} | Comhad GLB ina bhfuil an réad 3D ginte. |
| `thumbnail` | object {url, content_type, file_name, file_size} \| null | Mionsamhail a thaispeánann réamhamharc den tsamhail ginte. |
| `model_urls` | object {glb, fbx, obj, usdz, blend, stl} | Naisc chuig an tsamhail 3D i bhformáidí éagsúla. |
| `texture_urls` | array of object {base_color, metallic, normal, roughness} | Comhaid uigeachta léirithe mar eagar réad. |
| `seed` | integer \| null | Luach síl a úsáidtear le linn na giniúna. |
| `prompt` | string | Leid téacs a soláthraíodh don ghiniúint. |
| `actual_prompt` | string \| null | Leid a cuireadh i bhfeidhm i ndáiríre ar an nginiúint nuair a bhí leathnú leide cumasaithe. |
| `rigged_character_glb` | object {url, content_type, file_name, file_size} \| null | Toradh rigála seachadta mar chomhad carachtair GLB; níl sé sa fhreagra mura bhfuil enable_rigging fíor. |
| `rigged_character_fbx` | object {url, content_type, file_name, file_size} \| null | Toradh rigála seachadta mar chomhad carachtair FBX; níl sé sa fhreagra mura bhfuil enable_rigging fíor. |
| `basic_animations` | object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} \| null | Beochana bunúsacha siúil agus reatha, san áireamh ach amháin má tá enable_rigging fíor. |
| `rig_task_id` | string \| null | Aitheantóir don tasc rigála; san áireamh ach amháin má tá enable_rigging fíor. |

## Related models

- [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 6 · Text to 3D](https://doitong.com/developers/models/meshy/v6/text-to-3d.md) (`meshy/v6/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-preview/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-preview/text-to-3d
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.ru/v1/models/meshy/v6-preview/text-to-3d