Meshy Remesh API

meshy/remesh

Meshy Remesh rebuilds a 3D model at a target polycount, as triangles or quads. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Image to 3D
Input

Drag & drop or click to upload

Idle

3D

$0.2per run·~50 / $10

ExamplesView all

3D

Related Models

README

Meshy Remesh

Meshy Remesh rebuilds an existing 3D model with cleaner topology and a target polygon count. Choose triangle or quad topology, control mesh density, and optionally adjust the model's scale and origin.

Why Choose This?

  • Topology rebuilding — Rebuild irregular or overly dense meshes for downstream workflows.
  • Triangle or quad output — Choose the topology that fits your editing or production needs.
  • Polygon control — Set a target face count from 100 to 300000.
  • Proportional scaling — Optionally estimate an appropriate real-world scale.
  • Origin control — Position the model origin at the bottom or center.

Parameters

ParameterRequiredDescription
modelYesSource 3D model in GLB, GLTF, FBX, OBJ, or STL format.
topologyNoRemeshed topology: triangle or quad. Default: triangle.
target_polycountNoTarget number of faces from 100 to 300000. Default: 30000. The final face count may differ depending on the model geometry.
auto_sizeNoEstimate the object's real-world height and resize the model accordingly. Default: false.
origin_atNoPosition the model origin at bottom or center.

How to Use

  1. Upload a model — Provide the source 3D file.
  2. Choose topology — Select triangle or quad.
  3. Set polygon count — Choose the target number of faces.
  4. Configure scale optional — Enable auto_size when estimated real-world scaling is needed.
  5. Choose origin optional — Place the origin at the bottom or center.
  6. Submit — Generate and retrieve the remeshed model.

Pricing

$0.20 per model.

Topology, target polygon count, automatic sizing, and origin placement do not add separate charges.

Best Use Cases

  • Game assets — Reduce or standardize polygon counts for real-time workflows.
  • 3D editing — Create cleaner topology before further modeling or sculpting.
  • UV preparation — Remesh dense or irregular geometry before UV unwrapping.
  • Rigging preparation — Create more manageable topology before character rigging.
  • Asset optimization — Reduce mesh complexity for downstream applications.

Pro Tips

  • Use a lower target_polycount when performance and file size are more important than fine detail.
  • Increase the target count when the source contains small or complex features.
  • Use triangle for general-purpose optimized meshes.
  • Use quad when quad-dominant topology is preferred for downstream editing.
  • Review the remeshed result before continuing with UV, texture, or rigging workflows.

Notes

  • topology defaults to triangle.
  • target_polycount supports values from 100 to 300000 and defaults to 30000.
  • The requested polygon count is a target and may not exactly match the final result.
  • Lower polygon counts may reduce small geometric details.
  • auto_size estimates the object's real-world height and rescales the model accordingly.
  • origin_at supports bottom and center.
  • Meshy now recommends using the dedicated Resize workflow for new integrations that need automatic sizing or origin adjustment.
Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

Remesh API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/meshy/remesh with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Remesh below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "model": "example",
    "topology": "triangle",
    "target_polycount": 30000,
    "auto_size": false,
    "origin_at": "bottom"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/meshy/remesh" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/meshy/remesh";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "model": "example",
        "topology": "triangle",
        "target_polycount": 30000,
        "auto_size": false,
        "origin_at": "bottom"
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "model": "example",
    "topology": "triangle",
    "target_polycount": 30000,
    "auto_size": False,
    "origin_at": "bottom"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/meshy/remesh", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

Remesh API — Frequently asked questions

What is the Remesh API?

Remesh is a Meshy model for 3D asset generation from images, exposed as a REST API on WaveSpeedAI. Meshy Remesh rebuilds a 3D model at a target polycount, as triangles or quads. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Remesh API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates Python, JavaScript, and cURL examples for submitting requests and polling results. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/meshy/remesh.

How much does Remesh cost per run or per second?

Remesh starts at $0.2 per run or per second. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Remesh accept?

Key inputs: `auto_size`, `model`, `origin_at`, `target_polycount`, `topology`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/meshy/remesh.

How long does Remesh take to generate?

Reported generation time on WaveSpeedAI is around 116 seconds per request. This is an estimate, not a latency guarantee; queue time and input settings can change the total wait. live status is visible in the prediction record.

Can I use Remesh outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Meshy). Check the provider's applicable terms and WaveSpeedAI's Terms of Service before commercial use.

llms.txt — meshy/remesh for AI agents and LLMs