# Meshy V7 Text to 3D API

> Meshy 7 ile metinden 3D: ön izleme veya tam mod, 2k geometri, PBR, iskelet oluşturma ve animasyon seçenekleri

İsteğe bağlı `enable_prompt_expansion` ile en fazla 600 karakterlik `prompt` üzerinden 3D model üretir. `mode`, dokusuz geometri veya dokulu model döndürür. `model_type` ile standard, lowpoly veya smart-topology seçin, `target_polycount` değerini 100 ile 300000 arasında ayarlayın ve standard veya 2k `geometry_resolution` seçin. Humanoid karakterlere iskelet ve animasyon ön ayarları eklenebilir.

- Model id: `meshy/v7/text-to-3d`
- Made by: Meshy
- Category: Text 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/v7/text-to-3d`
- Quote: `POST https://api.doitong.com/v1/quote/meshy/v7/text-to-3d`
- Docs page: https://doitong.com/tr/developers/models/meshy/v7/text-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/v7/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 model olarak temsil edilecek nesnenin 600 karakterle sınırlı açıklaması. |
| `mode` |  | enum (string) | no | `full` | `preview`, `full` | Üretim modu: 'preview' dokusuz geometri, 'full' ise preview ve refine'ı birleştirerek dokulu model üretir. |
| `seed` |  | integer \| null | no |  |  | Daha önceki bir sonucu genellikle yeniden üretmek için bu tohumu değişmeden kalan istemle birlikte yeniden kullanın. |
| `model_type` |  | enum (string) | no | `standard` | `standard`, `lowpoly`, `smart-topology` | 3D mesh modu: daha temiz poligonlar için optimize edilmiş düşük poligonlu sonuç için 'lowpoly' seçin; bu modda Meshy topology, target_polycount ve should_remesh değerlerini yok sayar. Geleneksel yüksek ayrıntılı sonuç için 'standard' veya geometri (preview) adımında Meshy-T2 kullanıp başlangıçtan itibaren ayrı oluşturulan temiz parçalar elde etmek için 'smart-topology' seçin. |
| `topology` |  | enum (string) | no | `triangle` | `quad`, `triangle` | Geometrik ayrıntı için Triangle ile yüzey pürüzsüzlüğü için Quad arasındaki model topolojisi seçimi. |
| `target_polycount` |  | integer | no | `30000` | 100 – 300,000 | model_type 'smart-topology' olduğunda 15,000 ile sınırlanan poligon sayısı hedefi. Bu modda hedef belirtilmezse Meshy'nin daha düşük varsayılanı olan 4,000 seçilir. |
| `should_remesh` |  | boolean | no | `true` |  | Bunu false olarak ayarlayarak yeniden mesh oluşturmayı atlayın ve ham üçgen mesh'i alın; aksi halde yeniden mesh oluşturma aşamasını etkinleştirin. |
| `symmetry_mode` |  | enum (string) | no | `auto` | `off`, `auto`, `on` | Model oluşturulurken uygulanan simetri ayarı. |
| `enable_pbr` |  | boolean | no | `false` |  | Temel rengin yanında metallic, roughness ve normal PBR haritalarının üretimini denetler. |
| `is_a_t_pose` |  | boolean | no | `false` |  | true ile etkinleştirilen T-pose üretim anahtarı; pose_mode lehine kullanımdan kaldırılmıştır. |
| `pose_mode` |  | enum (string) | no | `` | `a-pose`, `t-pose`, `` | Üretilen modelin pozunu belirtmemek için dizeyi boş bırakın; 'a-pose' ile A-pose veya 't-pose' ile T-pose isteyin. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Büyük dil modelinin istemi ayrıntılarla zenginleştirmesine izin verir. Bu genişletmenin etkinleştirilmesi istemin anlamını değiştirmez. |
| `texture_prompt` |  | string \| null | no |  | ≤ 600 characters | 'full' modunda ek bir metin istemiyle dokulandırmayı yönlendirir; diğer modlar bunu kullanmaz. |
| `texture_image_url` |  | string (image URL) \| null | no |  |  | Yalnızca 'full' modunda uygulanan doku üretimi için 2D referans görseli. |
| `enable_rigging` |  | boolean | no | `false` |  | İnsansı modellerde ve uzuvları açıkça ayırt edilebilen karakterlerde en etkili otomatik insansı rig. Etkinleştirildiğinde üretilen modele rig uygular ve yürüme ile koşma için temel animasyonlar sağlar. |
| `rigging_height_meters` |  | number | no | `1.7` | > 0 | enable_rigging true olduğunda metre cinsinden tahmini karakter yüksekliği sağlayın; aksi halde bu değer etkisizdir. |
| `enable_animation` |  | boolean | no | `false` |  | Rig uygulanmış modelin, enable_rigging değerinin true olmasını gerektiren bir ön ayar animasyonu alıp almayacağı. |
| `animation_action_id` |  | integer | no | `92` |  | Meshy kitaplığındaki animasyon ön ayarı kimliği; kullanılabilir eylemler https://docs.meshy.ai/en/api/animation-library adresinde listelenir. Doğrulama ve kullanım yalnızca enable_animation true olduğunda geçerlidir: [0, 696] dışındaki değerler 422 ile reddedilir ve "Idle" değeri `0` ile eşleşir. |
| `enable_safety_checker` |  | boolean | no | `true` |  | Ön işleme güvenlik kontrolü anahtarı: true, girdi güvenlik kontrolünü işlemenin ön koşulu yapar. |
| `geometry_resolution` |  | enum (string) \| null | no |  | `standard`, `2k` | Mesh geometrisi çözünürlüğü; desteklenen Meshy-7 seçenekleri standard ve 2k'dir. |
| `ultra_mode` |  | boolean | no | `false` |  | geometry_resolution ile değiştirilen kullanımdan kaldırılmış seçenek; ikisi de sağlanırsa geometry_resolution önceliklidir. Bunun yerine geometry_resolution='2k' kullanın. |

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/v7/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/v7/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/v7/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/v7/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/v7/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": 1200,
    "usd": "1.20",
    "charged": 1200,
    "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 | 3D modeli GLB olarak içeren animasyon sonucu; enable_animation true olmadıkça yanıt bu sonucu içermez. |
| `animation_fbx` | object {url, content_type, file_name, file_size} \| null | 3D modeli FBX olarak içeren animasyon sonucu; enable_animation true olmadıkça yanıt bu sonucu içermez. |
| `model_glb` | object {url, content_type, file_name, file_size} | Üretilen 3D nesneyi içeren GLB dosyası. |
| `thumbnail` | object {url, content_type, file_name, file_size} \| null | Üretilen modelin önizlemesini gösteren küçük görsel. |
| `model_urls` | object {glb, fbx, obj, usdz, blend, stl} | Çeşitli biçimlerdeki 3D model bağlantıları. |
| `texture_urls` | array of object {base_color, metallic, normal, roughness} | Nesne dizisi olarak temsil edilen doku dosyaları. |
| `seed` | integer \| null | Üretim sırasında kullanılan seed değeri. |
| `prompt` | string | Üretim için sağlanan metin istemi. |
| `actual_prompt` | string \| null | İstem genişletme etkinleştirildiğinde üretime gerçekten uygulanan istem metni. |
| `rigged_character_glb` | object {url, content_type, file_name, file_size} \| null | GLB karakter dosyası olarak sunulan rig sonucu; enable_rigging true olmadıkça yanıtta bulunmaz. |
| `rigged_character_fbx` | object {url, content_type, file_name, file_size} \| null | FBX karakter dosyası olarak sunulan rig sonucu; enable_rigging true olmadıkça yanıtta bulunmaz. |
| `basic_animations` | object {walking_glb, walking_fbx, walking_armature_glb, running_glb, running_fbx, running_armature_glb} \| null | Yalnızca enable_rigging true olduğunda dahil edilen temel yürüme ve koşma animasyonları. |
| `rig_task_id` | string \| null | Rig işleminin tanımlayıcısı; yalnızca enable_rigging true olduğunda dahil edilir. |

## Related models

- [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
- [Meshy 7 Retexture](https://doitong.com/developers/models/meshy/v7/retexture.md) (`meshy/v7/retexture`): from $0.30 / request
- [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 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
- [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

## Links

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