Meshy Resize API

meshy/resize

Meshy Resize scales a 3D model to a real-world height or size and sets its origin. 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.04per run·~25 / $1

ExamplesView all

3D

Related Models

README

Meshy Resize

Meshy Resize adjusts the real-world scale and origin of an existing 3D model. Set a target height, resize by the longest side, or let the model estimate an appropriate real-world size automatically.

Why Choose This?

  • Real-world sizing — Resize a model using dimensions measured in meters.
  • Flexible sizing methods — Set the total height, longest side, or use automatic size estimation.
  • Proportional scaling — Resize the model while preserving its proportions.
  • Origin control — Place the model origin at the bottom or center.
  • Multiple 3D formats — Supports common formats including GLB, GLTF, FBX, OBJ, and STL.

Parameters

ParameterRequiredDescription
modelYesSource 3D model in GLB, GLTF, FBX, OBJ, or STL format.
resize_heightConditionalTarget model height in meters. Must be greater than 0.
resize_longest_sideConditionalTarget length of the model's longest side in meters. Must be greater than 0.
auto_sizeConditionalAutomatically estimate the object's real-world height and resize the model accordingly.
origin_atNoPosition of the model origin after resizing: bottom or center. Default: bottom.

Use exactly one of resize_height, resize_longest_side, or auto_size=true.

How to Use

  1. Upload a model — Provide the source 3D file.
  2. Choose a sizing method — Set resize_height, set resize_longest_side, or enable auto_size.
  3. Choose the origin — Select bottom or center.
  4. Submit — Resize and retrieve the processed model.

Pricing

$0.04 per model.

Sizing method and origin placement do not add separate charges.

Best Use Cases

  • 3D printing — Scale models to a specific real-world size before slicing.
  • Product visualization — Match digital assets to approximate physical dimensions.
  • Game and scene assets — Normalize model scale before importing into a scene.
  • Asset preparation — Standardize model dimensions across different sources.
  • Origin adjustment — Move the origin to the bottom or center for easier placement.

Pro Tips

  • Use resize_height when the model's overall height is the important dimension.
  • Use resize_longest_side when the largest dimension should match a specific size.
  • Use auto_size when you want an estimated real-world scale without specifying a dimension manually.
  • Use origin_at=bottom when the model should sit naturally on a ground plane.
  • Use origin_at=center when centered positioning is more useful for downstream editing or placement.

Notes

  • Exactly one sizing method must be used: resize_height, resize_longest_side, or auto_size=true.
  • Explicit dimensions are measured in meters and must be greater than 0.
  • Model proportions are preserved during resizing.
  • auto_size estimates an appropriate real-world height and resizes the model to that scale.
  • origin_at supports bottom and center and defaults to bottom.
  • GLB, OBJ, FBX, and STL inputs keep their format in the resized result.
  • GLTF inputs are returned as GLB.
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.

Resize API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/meshy/resize 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 Resize below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "model": "example",
    "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/resize" \
  -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/resize";
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",
        "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",
    "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/resize", 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)

Resize API — Frequently asked questions

What is the Resize API?

Resize is a Meshy model for 3D asset generation from images, exposed as a REST API on WaveSpeedAI. Meshy Resize scales a 3D model to a real-world height or size and sets its origin. 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 Resize 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/resize.

How much does Resize cost per run or per second?

Resize starts at $0.04 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 Resize accept?

Key inputs: `auto_size`, `model`, `origin_at`, `resize_height`, `resize_longest_side`. 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/resize.

How long does Resize take to generate?

Reported generation time on WaveSpeedAI is around 20 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 Resize 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/resize for AI agents and LLMs