Meshy 7.1 API, Meshy 7 API, Meshy 6 API: Pricing, Documentation

by Meshy

Meshy 3D API is a professional-grade 3D generation interface designed to programmatically transform text prompts and 2D images into high-quality, production-ready 3D assets. Known for delivering sculpting-level detail, the system utilizes advanced neural geometry reconstruction to produce clean mesh topology, sharper hard-surface details, and lifelike organic forms. It offers comprehensive features such as automated AI texturing with PBR maps, automatic rigging and animation, and a low-poly mode optimized for real-time game engines. Supporting various industry-standard formats like OBJ, FBX, and GLB, this API enables developers to scale 3D content creation for game development, AR/VR experiences, and high-fidelity 3D printing workflows.

Get API Key
Meshy API

Models Version

WELCOME BONUS

Get 10% Cashback on Your First Payment (up to $500)

Add funds and get 10% cashback on your first payment (up to $500).

Claim Your Cashback →

Meshy Rigging API Documentation

Make a static 3D character ready to animate: send the URL of a humanoid character's GLB file and get it back rigged, with a skeleton bound to the mesh, as GLB and FBX, plus walking and running clips. Set enable_animation to also get one motion from a library of about 680 presets. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED.

POST https://gateway.pixazo.ai/meshy-rigging/v1/rig

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Auto-Rigging - Meshy Rigging

Request Code

POST https://gateway.pixazo.ai/meshy-rigging/v1/rig
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb"
}
import requests

url = "https://gateway.pixazo.ai/meshy-rigging/v1/rig"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb"
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-rigging/v1/rig", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb"
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-rigging/v1/rig' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb"}'

Output

{
  "request_id": "meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default, one callback on COMPLETED/ERROR) or sync (per-poll callbacks).

Callback Payload (success)

{
  "request_id": "meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-rigging",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb"
    ],
    "media_type": "model/gltf-binary",
    "rigged_character_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb",
    "rigged_character_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/V91JI2-ks8j36kFu22-vi_rigged_character.fbx",
    "basic_animations": {
      "walking_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/FgFSUXtZ8bDR4ZjTK0-M5_walking.glb",
      "walking_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/Fns8s1cCL0bvJ0SR02YXj_walking.fbx",
      "running_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/Bh274vbFIG9CwGt_GW0PD_running.glb",
      "running_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/kyiMS6gynDee19smpJ56__running.fbx",
      "walking_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/maWsWJrC7HnBHMpBtf8h7_walking_armature.glb",
      "running_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/sqC2g4AUdGZHV8axQvXSr_running_armature.glb"
    }
  },
  "created_at": "2026-11-12T12:57:43.329Z",
  "updated_at": "2026-11-12 12:58:59",
  "completed_at": "2026-11-12 12:58:58"
}

Failure callback shape

{
  "request_id": "meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-rigging",
  "error": "Generation failed: the request was rejected (model_url: Model format not supported: failed to process model for rigging: invalid model file format .txt, supported formats: [.glb]).",
  "output": null,
  "created_at": "2026-11-12T12:57:45.931Z",
  "updated_at": "2026-11-12 12:58:01",
  "completed_at": "2026-11-12 12:58:01"
}

Callbacks are idempotent on request_id — de-duplicate on it. Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
model_urlYesrequiredstring—A public http(s) URL of a GLB file, up to 50 MB
The character to rig, as GLB (binary glTF). One humanoid character with clearly separated arms and legs, ideally in an A-pose or T-pose.
height_metersNonumber1.7Greater than 0
The character's approximate height in meters; it scales the skeleton.
skeleton_templateNostringmeshyrigmixamo, ue5_mannequin, unity_humanoid, maya_human_ik, blender_rigify_basic_human, max_biped, cc5_hd_neutral_base, daz_genesis9, meshyrig
The skeleton layout, to match the engine or tool you use. Every clip made from the rig uses the same skeleton.
include_fingersNobooleanfalsetrue, false
Also rig the fingers.
enable_animationNobooleanfalsetrue, false
Also apply one preset (animation_action_id) and return it as animation_glb and animation_fbx.
animation_action_idNointeger920 to 696
The preset applied when enable_animation is true, for example 0 (Idle) or 30 (Casual Walk). Browse the presets in Meshy's animation library.
enable_safety_checkerNobooleantruetrue
The input is checked for unsafe content. It cannot be turned off.

How usage is measured

Billed per rig: one rate for a rig on its own, and a higher one when enable_animation is true (the preset clip). The skeleton, the fingers and the walking and running clips do not change the price. The rates are in the pricing panel on this page. Nothing is charged for a request that fails.

Parameters not supported

Rejected with 400

Checked when you submit: the request is rejected before it is queued.

ParameterWhyUse instead
model_url missingThe character is required.A public URL of its GLB file
image_url, image_urls, images, imageRigging works on a 3D model, not a picture.model_url
promptRigging works from the 3D model alone; there is no text prompt.—
animation_action_idsThis endpoint applies one preset.animation_action_id with enable_animation, or the Meshy Rigging Multi-Animation API for several clips
animation_action_id outside 0 to 696Not a preset id.An id from the animation library
skeleton_template not in the listOnly the nine layouts above.One of the listed values
height_meters of 0 or lessA height must be positive.—
enable_riggingThis endpoint always rigs.—
rigging_height_metersThat is Meshy 7's name for it.height_meters
output_formatEvery file is returned as both GLB and FBX.—
num_images, number_of_images, batch_size, n, countOne character per request.One request per character
modelThis endpoint always runs Meshy Rigging.—
input, parametersNot accepted by this endpoint.Send the parameters at the top level of the JSON body
webhook_url, callback_urlWebhooks are set by header.X-Webhook-URL header
enable_safety_checker set to falseThe safety check cannot be turned off.—
model_url that cannot be downloadedThe file is fetched when you submit; if the URL answers an error (for example 404), the 400 says so under failures.A public URL that serves the file

Accepted, then the request fails

These pass the submit check, so the submit returns 202, but the request then fails with status: "ERROR". Nothing is charged.

ParameterWhen the request fails
model_urlThe file downloads but is not a 3D model, for example a web page or a text file.
model_urlThe model is not a humanoid character, for example an animal or an object, so it cannot be rigged.
skeleton_template, include_fingersSome characters can only be rigged with meshyrig and without fingers; other settings then fail.
model_urlThe content is blocked by the safety check.

Accepted but ignored

Any other parameter is dropped and has no effect.

The output files

A completed request names every file in output. output.media_url holds the rigged character as GLB, the same file as output.rigged_character_glb. The rig has 24 joints. Measured at launch on a 3.9 MB textured character, with enable_animation on (30 (Casual Walk)):

Key in outputFileSize (measured at launch)
rigged_character_glbThe rigged character, GLB (also media_url[0])4.9 MB
rigged_character_fbxThe rigged character, FBX4.3 MB
animation_glbThe preset clip, GLB (only with enable_animation)5.0 MB
animation_fbxThe preset clip, FBX (only with enable_animation)4.4 MB
basic_animations.walking_glbWalking clip, GLB4.9 MB
basic_animations.walking_fbxWalking clip, FBX4.3 MB
basic_animations.running_glbRunning clip, GLB4.9 MB
basic_animations.running_fbxRunning clip, FBX4.3 MB
basic_animations.walking_armature_glbWalking clip, skeleton only (no character mesh or textures), GLB90 KB
basic_animations.running_armature_glbRunning clip, skeleton only (no character mesh or textures), GLB79 KB

Every GLB except the two skeleton-only clips carries the whole textured character, so each clip can be used on its own. GLB opens in three.js, Babylon.js and Blender; FBX imports into Unity, Unreal Engine, Maya and 3ds Max. Download the files and keep your own copies.

Input tips

ItemGuidance
CharacterOne humanoid character: a head, two arms and two legs, clearly separated. Animals, objects and scenes cannot be rigged.
PoseAn A-pose or a T-pose, facing forward, gives the cleanest rig.
FileGLB (binary glTF) up to 50 MB. Convert other formats (OBJ, FBX, glTF with separate files) to GLB first.
SourceAny 3D model works, including one made with a text-to-3D or image-to-3D API: the example above rigs a character made with our Meshy 7.1 text-to-3D API.
SkeletonPick skeleton_template for the engine you target; leave it out for Meshy's own skeleton.

Timing

At launch, a rig took about 70 seconds from submit to result, and a rig with one preset about 90 seconds. Polling the status endpoint every 10 seconds is enough, or use a Webhook.

Example Request

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb"
}

Example Response

{
  "request_id": "meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Example: a rig with one preset

Request

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb",
  "enable_animation": true,
  "animation_action_id": 30
}

Completed response

{
  "request_id": "meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-rigging",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb"
    ],
    "media_type": "model/gltf-binary",
    "rigged_character_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb",
    "rigged_character_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/49m8-1rsRyiX34i0TtJ3u_rigged_character.fbx",
    "animation_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/a74X0Afpy4yr7ztJ8k8i__animation.glb",
    "animation_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/G6UC0S98cu5rVaR2lKr_D_animation.fbx",
    "basic_animations": {
      "walking_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/8u3zH6vloV_XBqF0ayAJW_walking.glb",
      "walking_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/Bw1-1ThXyAuLsdnoPmTr7_walking.fbx",
      "running_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/nMmVnh9VoK-QkEz0YS2ge_running.glb",
      "running_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/e21kNEM-JRgubd4MEcoEa_running.fbx",
      "walking_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/QEL-auwSQEXJtmG2eZBft_walking_armature.glb",
      "running_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/MTWoC9xaEanwchBsk_IeD_running_armature.glb"
    }
  },
  "created_at": "2026-11-12T12:57:44.300Z",
  "updated_at": "2026-11-12 12:59:22",
  "completed_at": "2026-11-12 12:59:21"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks (see Webhook section).

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Bad request — the body failed the submit check (see Request Parameters) and was not queued.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance.
403Forbidden.
429Too many requests.
500Internal server error.

Error Responses

A 400 names every rejected parameter in violations. This one was sent {"animation_action_ids": [30, 92]} along with a valid model_url:

{
  "error": "Invalid request parameters",
  "message": "'animation_action_ids' is not supported here: this endpoint animates one preset ('animation_action_id' with 'enable_animation': true). For several clips from one rig, use the Meshy Rigging Multi-Animation API.",
  "violations": [
    "'animation_action_ids' is not supported here: this endpoint animates one preset ('animation_action_id' with 'enable_animation': true). For several clips from one rig, use the Meshy Rigging Multi-Animation API."
  ]
}

A model_url that cannot be downloaded is also a 400, with the reason under failures:

{
  "request_id": "meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "error": "Asset proxy failed",
  "message": "Failed to proxy asset https://raw.githubusercontent.com/github/gitignore/main/no-such-model.glb: 404 Not Found",
  "failures": [
    {
      "url": "https://raw.githubusercontent.com/github/gitignore/main/no-such-model.glb",
      "error": "404 Not Found"
    }
  ]
}

A file that is not a 3D model passes the submit check and then fails; nothing is charged:

{
  "request_id": "meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-rigging",
  "error": "Generation failed: the request was rejected (model_url: Model format not supported: failed to process model for rigging: invalid model file format .txt, supported formats: [.glb]).",
  "output": null,
  "created_at": "2026-11-12T12:57:45.931Z",
  "updated_at": "2026-11-12 12:58:01",
  "completed_at": "2026-11-12 12:58:01"
}

Retrieving Results

Poll the status endpoint with the request_id until status is COMPLETED or ERROR, then download the files named in output.

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

Captured from a real Meshy Rigging request at launch; the request id is masked.

{
  "request_id": "meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-rigging",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb"
    ],
    "media_type": "model/gltf-binary",
    "rigged_character_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb",
    "rigged_character_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/V91JI2-ks8j36kFu22-vi_rigged_character.fbx",
    "basic_animations": {
      "walking_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/FgFSUXtZ8bDR4ZjTK0-M5_walking.glb",
      "walking_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/Fns8s1cCL0bvJ0SR02YXj_walking.fbx",
      "running_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/Bh274vbFIG9CwGt_GW0PD_running.glb",
      "running_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/kyiMS6gynDee19smpJ56__running.fbx",
      "walking_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/maWsWJrC7HnBHMpBtf8h7_walking_armature.glb",
      "running_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging/sqC2g4AUdGZHV8axQvXSr_running_armature.glb"
    }
  },
  "created_at": "2026-11-12T12:57:43.329Z",
  "updated_at": "2026-11-12 12:58:59",
  "completed_at": "2026-11-12 12:58:58"
}

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED or ERROR.
model_idstringThe model that handled the request.
errorstring or nullError message when status is ERROR; otherwise null.
output.media_urlarray of stringsThe rigged character as GLB (one URL).
output.media_typestringmodel/gltf-binary.
output.rigged_character_glbstringThe rigged character, GLB (the same file as media_url[0]).
output.rigged_character_fbxstringThe rigged character, FBX.
output.animation_glbstringThe preset clip, GLB. Only with enable_animation.
output.animation_fbxstringThe preset clip, FBX. Only with enable_animation.
output.basic_animationsobjectWalking and running clips: walking_glb, walking_fbx, running_glb, running_fbx, walking_armature_glb, running_armature_glb.
created_atstringRequest creation timestamp.
updated_atstringLast status change timestamp.
completed_atstringCompletion timestamp.
polling_urlstringStatus URL for this request (in the submit response).

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure). Treat any status other than QUEUED, PROCESSING or COMPLETED as a failure.

Meshy Rigging API Pricing

A rig is one rate; adding one preset animation (enable_animation) costs more. The skeleton, the fingers and the included walking and running clips do not change the price.

OptionPrice (USD)
Rig (default)$0.21
Rig + one preset animation$0.336
Image to Image (3D Models — Rigging + Animations)

Meshy Rigging API Documentation

Rig a humanoid 3D character and animate it with several presets in one request: send the URL of its GLB file and 1 to 10 preset ids, and get the rigged character (GLB and FBX), walking and running clips, and one clip per preset, in your order. All clips share one skeleton. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED.

POST https://gateway.pixazo.ai/meshy-rigging-multi-animation/v1/rig

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Rigging + Animations - Meshy Rigging Multi-Animation

Request Code

POST https://gateway.pixazo.ai/meshy-rigging-multi-animation/v1/rig
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb",
  "animation_action_ids": [
    30,
    92
  ]
}
import requests

url = "https://gateway.pixazo.ai/meshy-rigging-multi-animation/v1/rig"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb",
  "animation_action_ids": [
    30,
    92
  ]
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-rigging-multi-animation/v1/rig", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb",
  "animation_action_ids": [
    30,
    92
  ]
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-rigging-multi-animation/v1/rig' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb", "animation_action_ids": [30, 92]}'

Output

{
  "request_id": "meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default, one callback on COMPLETED/ERROR) or sync (per-poll callbacks).

Callback Payload (success)

{
  "request_id": "meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-rigging-multi-animation",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb"
    ],
    "media_type": "model/gltf-binary",
    "rigged_character_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb",
    "rigged_character_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/QI_I5fGsV6Ngs1VfFlMCI_rigged_character.fbx",
    "animations": [
      {
        "action_id": 30,
        "animation_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/V7Ksu5q-gp12C5s8G0ODM_animation.glb",
        "animation_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/IHNzRXvP-91t8hscTvusa_animation.fbx"
      },
      {
        "action_id": 92,
        "animation_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/V0JVYyAdNJdKI2TbIczjc_animation.glb",
        "animation_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/8JHsOwBzG31Jqfzf8HxgK_animation.fbx"
      }
    ],
    "basic_animations": {
      "walking_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/yfK-csd5PWSvT4XrwZ8bO_walking.glb",
      "walking_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/sNWznhzkvTL29c6xEu9oM_walking.fbx",
      "running_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/0_H5vDFIuCBSEbGsADW5T_running.glb",
      "running_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/RrlG5YBV9ywghdZh7_uFN_running.fbx",
      "walking_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/e7Mr0HT7znE7taPii4v_7_walking_armature.glb",
      "running_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/lDpmy-sU57uVoQ6eTC392_running_armature.glb"
    }
  },
  "created_at": "2026-11-12T12:57:45.312Z",
  "updated_at": "2026-11-12 12:59:51",
  "completed_at": "2026-11-12 12:59:50"
}

Failure callback shape

{
  "request_id": "meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-rigging-multi-animation",
  "error": "Generation failed: the request was rejected (model_url: Model format not supported: failed to process model for rigging: invalid model file format .txt, supported formats: [.glb]).",
  "output": null,
  "created_at": "2026-11-12T13:01:56.773Z",
  "updated_at": "2026-11-12 13:02:10",
  "completed_at": "2026-11-12 13:02:10"
}

Callbacks are idempotent on request_id — de-duplicate on it. Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
model_urlYesrequiredstring—A public http(s) URL of a GLB file, up to 50 MB
The character to rig, as GLB (binary glTF). One humanoid character with clearly separated arms and legs, ideally in an A-pose or T-pose.
height_metersNonumber1.7Greater than 0
The character's approximate height in meters; it scales the skeleton.
skeleton_templateNostringmeshyrigmixamo, ue5_mannequin, unity_humanoid, maya_human_ik, blender_rigify_basic_human, max_biped, cc5_hd_neutral_base, daz_genesis9, meshyrig
The skeleton layout, to match the engine or tool you use. Every clip made from the rig uses the same skeleton.
include_fingersNobooleanfalsetrue, false
Also rig the fingers.
animation_action_idsYesrequiredarray of integers—1 to 10 ids, each 0 to 696
One clip per id, returned in the same order, for example [30, 92]: Casual Walk and Double Combo Attack. A repeated id makes one clip. Browse the presets in Meshy's animation library.
enable_safety_checkerNobooleantruetrue
The input is checked for unsafe content. It cannot be turned off.

How usage is measured

Billed per rig plus per animation clip: each distinct id in animation_action_ids is one clip, and a repeated id counts once. The skeleton, the fingers and the walking and running clips do not change the price. The rates are in the pricing panel on this page. Nothing is charged for a request that fails.

Parameters not supported

Rejected with 400

Checked when you submit: the request is rejected before it is queued.

ParameterWhyUse instead
model_url missingThe character is required.A public URL of its GLB file
image_url, image_urls, images, imageRigging works on a 3D model, not a picture.model_url
promptRigging works from the 3D model alone; there is no text prompt.—
animation_action_idThis endpoint takes a list.animation_action_ids
enable_animationEvery id in the list becomes a clip.—
animation_action_ids empty, missing or with more than 10 ids1 to 10 ids per request.Split longer lists over several requests
skeleton_template not in the listOnly the nine layouts above.One of the listed values
height_meters of 0 or lessA height must be positive.—
enable_riggingThis endpoint always rigs.—
rigging_height_metersThat is Meshy 7's name for it.height_meters
output_formatEvery file is returned as both GLB and FBX.—
num_images, number_of_images, batch_size, n, countOne character per request.One request per character
modelThis endpoint always runs Meshy Rigging Multi-Animation.—
input, parametersNot accepted by this endpoint.Send the parameters at the top level of the JSON body
webhook_url, callback_urlWebhooks are set by header.X-Webhook-URL header
enable_safety_checker set to falseThe safety check cannot be turned off.—
model_url that cannot be downloadedThe file is fetched when you submit; if the URL answers an error (for example 404), the 400 says so under failures.A public URL that serves the file

Accepted, then the request fails

These pass the submit check, so the submit returns 202, but the request then fails with status: "ERROR". Nothing is charged.

ParameterWhen the request fails
model_urlThe file downloads but is not a 3D model, for example a web page or a text file.
model_urlThe model is not a humanoid character, for example an animal or an object, so it cannot be rigged.
skeleton_template, include_fingersSome characters can only be rigged with meshyrig and without fingers; other settings then fail.
animation_action_idsAn id is outside 0 to 696.
model_urlThe content is blocked by the safety check.

Accepted but ignored

Any other parameter is dropped and has no effect.

The output files

A completed request names every file in output. output.media_url holds the rigged character as GLB, the same file as output.rigged_character_glb. The rig has 24 joints. Measured at launch on a 3.9 MB textured character, with [30, 92]:

Key in outputFileSize (measured at launch)
rigged_character_glbThe rigged character, GLB (also media_url[0])4.9 MB
rigged_character_fbxThe rigged character, FBX4.3 MB
animations[0].animation_glbClip 1, 30 (Casual Walk), GLB5.0 MB
animations[0].animation_fbxClip 1, 30 (Casual Walk), FBX4.4 MB
animations[1].animation_glbClip 2, 92 (Double Combo Attack), GLB5.0 MB
animations[1].animation_fbxClip 2, 92 (Double Combo Attack), FBX4.4 MB
basic_animations.walking_glbWalking clip, GLB4.9 MB
basic_animations.walking_fbxWalking clip, FBX4.3 MB
basic_animations.running_glbRunning clip, GLB4.9 MB
basic_animations.running_fbxRunning clip, FBX4.3 MB
basic_animations.walking_armature_glbWalking clip, skeleton only (no character mesh or textures), GLB89 KB
basic_animations.running_armature_glbRunning clip, skeleton only (no character mesh or textures), GLB79 KB

Every GLB except the two skeleton-only clips carries the whole textured character, so each clip can be used on its own. GLB opens in three.js, Babylon.js and Blender; FBX imports into Unity, Unreal Engine, Maya and 3ds Max. Download the files and keep your own copies.

Input tips

ItemGuidance
CharacterOne humanoid character: a head, two arms and two legs, clearly separated. Animals, objects and scenes cannot be rigged.
PoseAn A-pose or a T-pose, facing forward, gives the cleanest rig.
FileGLB (binary glTF) up to 50 MB. Convert other formats (OBJ, FBX, glTF with separate files) to GLB first.
SourceAny 3D model works, including one made with a text-to-3D or image-to-3D API: the example above rigs a character made with our Meshy 7.1 text-to-3D API.
SkeletonPick skeleton_template for the engine you target; leave it out for Meshy's own skeleton.

Timing

At launch, a rig with two clips took about 120 seconds from submit to result; the clips are made at the same time. Polling the status endpoint every 10 seconds is enough, or use a Webhook.

Example Request

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-7-1_01a1cfc5-d0ce-70a5-e660-a275e452b82d6/output.glb",
  "animation_action_ids": [
    30,
    92
  ]
}

Example Response

{
  "request_id": "meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks (see Webhook section).

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Bad request — the body failed the submit check (see Request Parameters) and was not queued.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance.
403Forbidden.
429Too many requests.
500Internal server error.

Error Responses

A 400 names every rejected parameter in violations. This one was sent {"animation_action_id": 30, "animation_action_ids": [30]} along with a valid model_url:

{
  "error": "Invalid request parameters",
  "message": "'animation_action_id' is not supported here: send the presets as 'animation_action_ids', a list of 1 to 10 ids.",
  "violations": [
    "'animation_action_id' is not supported here: send the presets as 'animation_action_ids', a list of 1 to 10 ids."
  ]
}

A model_url that cannot be downloaded is also a 400, with the reason under failures:

{
  "request_id": "meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "error": "Asset proxy failed",
  "message": "Failed to proxy asset https://raw.githubusercontent.com/github/gitignore/main/no-such-model.glb: 404 Not Found",
  "failures": [
    {
      "url": "https://raw.githubusercontent.com/github/gitignore/main/no-such-model.glb",
      "error": "404 Not Found"
    }
  ]
}

A file that is not a 3D model passes the submit check and then fails; nothing is charged:

{
  "request_id": "meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-rigging-multi-animation",
  "error": "Generation failed: the request was rejected (model_url: Model format not supported: failed to process model for rigging: invalid model file format .txt, supported formats: [.glb]).",
  "output": null,
  "created_at": "2026-11-12T13:01:56.773Z",
  "updated_at": "2026-11-12 13:02:10",
  "completed_at": "2026-11-12 13:02:10"
}

Retrieving Results

Poll the status endpoint with the request_id until status is COMPLETED or ERROR, then download the files named in output.

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

Captured from a real Meshy Rigging Multi-Animation request at launch; the request id is masked.

{
  "request_id": "meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-rigging-multi-animation",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb"
    ],
    "media_type": "model/gltf-binary",
    "rigged_character_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-rigging-multi-animation_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb",
    "rigged_character_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/QI_I5fGsV6Ngs1VfFlMCI_rigged_character.fbx",
    "animations": [
      {
        "action_id": 30,
        "animation_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/V7Ksu5q-gp12C5s8G0ODM_animation.glb",
        "animation_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/IHNzRXvP-91t8hscTvusa_animation.fbx"
      },
      {
        "action_id": 92,
        "animation_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/V0JVYyAdNJdKI2TbIczjc_animation.glb",
        "animation_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/8JHsOwBzG31Jqfzf8HxgK_animation.fbx"
      }
    ],
    "basic_animations": {
      "walking_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/yfK-csd5PWSvT4XrwZ8bO_walking.glb",
      "walking_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/sNWznhzkvTL29c6xEu9oM_walking.fbx",
      "running_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/0_H5vDFIuCBSEbGsADW5T_running.glb",
      "running_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/RrlG5YBV9ywghdZh7_uFN_running.fbx",
      "walking_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/e7Mr0HT7znE7taPii4v_7_walking_armature.glb",
      "running_armature_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/meshy-rigging-multi-animation/lDpmy-sU57uVoQ6eTC392_running_armature.glb"
    }
  },
  "created_at": "2026-11-12T12:57:45.312Z",
  "updated_at": "2026-11-12 12:59:51",
  "completed_at": "2026-11-12 12:59:50"
}

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED or ERROR.
model_idstringThe model that handled the request.
errorstring or nullError message when status is ERROR; otherwise null.
output.media_urlarray of stringsThe rigged character as GLB (one URL).
output.media_typestringmodel/gltf-binary.
output.rigged_character_glbstringThe rigged character, GLB (the same file as media_url[0]).
output.rigged_character_fbxstringThe rigged character, FBX.
output.animationsarray of objectsOne entry per clip, in the order of animation_action_ids: action_id, animation_glb and animation_fbx.
output.basic_animationsobjectWalking and running clips: walking_glb, walking_fbx, running_glb, running_fbx, walking_armature_glb, running_armature_glb.
created_atstringRequest creation timestamp.
updated_atstringLast status change timestamp.
completed_atstringCompletion timestamp.
polling_urlstringStatus URL for this request (in the submit response).

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure). Treat any status other than QUEUED, PROCESSING or COMPLETED as a failure.

Meshy Rigging API Pricing

One rig plus one rate per animation clip: each distinct id in animation_action_ids is a clip. The skeleton, the fingers and the included walking and running clips do not change the price.

Animation clipsPrice (USD)
1 clip$0.336
2 clips$0.462
3 clips$0.588
4 clips$0.714
5 clips$0.84
6 clips$0.966
7 clips$1.092
8 clips$1.218
9 clips$1.344
10 clips$1.47
2. Meshy 7.1

Meshy 7.1 API Documentation

Generate a 3D model from a text prompt with Meshy 7.1. Returns a GLB. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED, then download the model from output.media_url. 3D generation typically takes a few minutes.

POST https://gateway.pixazo.ai/meshy-7-1/v1/text-to-3d

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Text to 3D - Meshy 7.1

Request Code

POST https://gateway.pixazo.ai/meshy-7-1/v1/text-to-3d
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "prompt": "a weathered wooden treasure chest with iron bands",
  "mode": "full",
  "topology": "triangle",
  "target_polycount": 30000
}
import requests

url = "https://gateway.pixazo.ai/meshy-7-1/v1/text-to-3d"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "prompt": "a weathered wooden treasure chest with iron bands",
  "mode": "full",
  "topology": "triangle",
  "target_polycount": 30000
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-7-1/v1/text-to-3d", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "prompt": "a weathered wooden treasure chest with iron bands",
  "mode": "full",
  "topology": "triangle",
  "target_polycount": 30000
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-7-1/v1/text-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"prompt": "a weathered wooden treasure chest with iron bands", "mode": "full", "topology": "triangle", "target_polycount": 30000}'

Output

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default, one callback on COMPLETED/ERROR) or sync (per-poll callbacks).

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/meshy-7-1/v1/text-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"prompt": "a weathered wooden treasure chest with iron bands", "mode": "full", "topology": "triangle", "target_polycount": 30000}'

Callback Payload (success)

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7-1",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-09-22T11:56:21.804Z",
  "completed_at": "2026-09-22T12:01:44.210Z"
}

Failure callback shape

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-7-1",
  "error": "Description of the failure"
}

Delivery semantics

  • terminal mode: one Webhook callback when the request is COMPLETED or ERROR.
  • sync mode: a Webhook callback on each status change.
  • Callbacks are idempotent on request_id — de-duplicate on it.
  • Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
promptYesrequiredstring—up to 600 characters
What the object is. Describe the object itself rather than a scene — there is no camera or background in a 3D model.
modeNostringfullpreview, full
Controls texturing, and therefore the price. full returns a textured model; preview returns untextured geometry only and costs less. This operation uses mode; the image operations use should_texture instead.
model_typeNostringstandardstandard
Geometry style. Only standard is accepted: Meshy now offers Smart Topology as separate models (Meshy T2 and T2.5), which this API does not include.
enable_prompt_expansionNobooleanfalsetrue, false
Let Meshy expand a short prompt into a fuller description before generating.
seedNointeger—any integer
Same inputs and seed usually reproduce the same model.
topologyNostringtrianglequad, triangle
Quad for smooth surfaces, triangle for detailed geometry.
target_polycountNointeger30000100–300000
Target polygon count of the remeshed model.
should_remeshNobooleantruetrue, false
When false, returns the raw triangular mesh without the remeshing pass.
symmetry_modeNostringautooff, auto, on
Force symmetry on or off, or let Meshy decide.
pose_modeNostring— (no specific pose)a-pose, t-pose, ""
Generate a character in a standard A-pose or T-pose, which is what most rigging tools expect.
texture_promptNostring—up to 600 characters
Text guidance for the texturing pass. Only used on a textured request.
texture_image_urlNostring—https URL, up to 20 MB
A 2D image that guides the texturing pass. Only used on a textured request.
enable_safety_checkerNobooleantruetrue, false
Screen the input before generating.

Good to know

  • Exactly one model is generated per request. There is no batch option: num_images, n, count, batch_size and number_of_images are rejected.
  • should_texture, image_url and image_urls belong to the other operations and are rejected here.
  • Auto-rigging and animation (enable_rigging, enable_animation) are not available on this API, and geometry_resolution is fixed at standard.
  • Cost depends on whether the model is textured; the current rates are in the pricing panel on this page.

Example Request

{
  "prompt": "a weathered wooden treasure chest with iron bands",
  "mode": "full",
  "topology": "triangle",
  "target_polycount": 30000
}

Example Response

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks (see Webhook section).

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Bad request — prompt missing or over 600 characters, mode outside preview/full, an input belonging to another operation, or an unsupported option such as enable_rigging. Anything checkable from the request body alone.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance.
429Too many requests.
500Internal server error.

Only what can be judged from the request body itself is rejected synchronously. Everything that needs an input to be fetched or the model to run is reported through the status endpoint instead, as status: "ERROR". Failed requests are not billed — the hold is released in full.

ConditionHow it surfaces
prompt missing, or longer than 600 characterssynchronous 400
should_texture, image_url or image_urls sent to this operationsynchronous 400
enable_rigging, enable_animation, or a geometry_resolution or model_type other than standardsynchronous 400
A prompt the safety checker rejectsstatus: "ERROR"

Retrieving Results

Poll the status endpoint with the request_id from the submit response until status is COMPLETED (or FAILED/ERROR), then download the model from output.media_url. 3D generation typically takes a few minutes, so poll every 10–15 seconds rather than continuously.

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7-1",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-09-22T11:56:21.804Z",
  "completed_at": "2026-09-22T12:01:44.210Z"
}

Meshy also produces OBJ, FBX and USDZ variants, a preview thumbnail and separate texture files. This API returns the GLB only — it is the single self-contained file that carries mesh, materials and textures together, and it is what the console preview renders.

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED, FAILED, or ERROR.
model_idstringThe model that handled the request.
output.media_urlarrayURL of the generated 3D model (GLB).
output.media_typestringmodel/gltf-binary.
created_atstringRequest creation timestamp.
completed_atstringCompletion timestamp.
errorstringError message when status is FAILED/ERROR.

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or FAILED/ERROR (failure).

How billing is measured

Billing is per generated model, and every request generates exactly one, so the amount held when the request is submitted is the amount charged on completion. The only thing that changes the amount is whether the model is textured — an untextured request costs less. It does not depend on the polygon count, the topology, or how many reference images you send. If the request fails, the hold is released in full.

Meshy 7.1 API Pricing

Textured is the default; an untextured request costs less. Polygon count, topology and the number of reference images do not change the price.

OptionPrice (USD)
Textured (default)$1.26
No texture$0.84
Image to Image (3D Models — Image to 3D)

Meshy 7.1 API Documentation

Turn a single reference image into a 3D model with Meshy 7.1. Returns a GLB. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED, then download the model from output.media_url. 3D generation typically takes a few minutes.

POST https://gateway.pixazo.ai/meshy-7-1/v1/image-to-3d

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Image to 3D - Meshy 7.1

Request Code

POST https://gateway.pixazo.ai/meshy-7-1/v1/image-to-3d
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/nano-banana.jpeg",
  "should_texture": true,
  "topology": "triangle",
  "target_polycount": 30000
}
import requests

url = "https://gateway.pixazo.ai/meshy-7-1/v1/image-to-3d"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/nano-banana.jpeg",
  "should_texture": true,
  "topology": "triangle",
  "target_polycount": 30000
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-7-1/v1/image-to-3d", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/nano-banana.jpeg",
  "should_texture": true,
  "topology": "triangle",
  "target_polycount": 30000
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-7-1/v1/image-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/nano-banana.jpeg", "should_texture": true, "topology": "triangle", "target_polycount": 30000}'

Output

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default, one callback on COMPLETED/ERROR) or sync (per-poll callbacks).

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/meshy-7-1/v1/image-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/nano-banana.jpeg", "should_texture": true, "topology": "triangle", "target_polycount": 30000}'

Callback Payload (success)

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7-1",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-09-22T11:56:21.804Z",
  "completed_at": "2026-09-22T12:01:44.210Z"
}

Failure callback shape

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-7-1",
  "error": "Description of the failure"
}

Delivery semantics

  • terminal mode: one Webhook callback when the request is COMPLETED or ERROR.
  • sync mode: a Webhook callback on each status change.
  • Callbacks are idempotent on request_id — de-duplicate on it.
  • Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
image_urlYesrequiredstring—https URL, up to 20 MB
The reference image: jpg, jpeg, png, avif or heif. A single object on a clean background reconstructs best. Must be publicly reachable; the gateway fetches it before generation.
should_textureNobooleantruetrue, false
Controls texturing, and therefore the price. false returns untextured geometry only and costs less. This operation uses should_texture; text to 3D uses mode instead.
model_typeNostringstandardstandard
Geometry style. Only standard is accepted: Meshy now offers Smart Topology as separate models (Meshy T2 and T2.5), which this API does not include.
seedNointeger—any integer
Same inputs and seed usually reproduce the same model.
topologyNostringtrianglequad, triangle
Quad for smooth surfaces, triangle for detailed geometry.
target_polycountNointeger30000100–300000
Target polygon count of the remeshed model.
should_remeshNobooleantruetrue, false
When false, returns the raw triangular mesh without the remeshing pass.
symmetry_modeNostringautooff, auto, on
Force symmetry on or off, or let Meshy decide.
pose_modeNostring— (no specific pose)a-pose, t-pose, ""
Generate a character in a standard A-pose or T-pose, which is what most rigging tools expect.
texture_promptNostring—up to 600 characters
Text guidance for the texturing pass. Only used on a textured request.
texture_image_urlNostring—https URL, up to 20 MB
A 2D image that guides the texturing pass. Only used on a textured request.
enable_safety_checkerNobooleantruetrue, false
Screen the input before generating.

Good to know

  • Exactly one model is generated per request. There is no batch option: num_images, n, count, batch_size and number_of_images are rejected.
  • mode, prompt and image_urls belong to the other operations and are rejected here.
  • Auto-rigging and animation (enable_rigging, enable_animation) are not available on this API, and geometry_resolution is fixed at standard.
  • Cost depends on whether the model is textured; the current rates are in the pricing panel on this page.

Example Request

{
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/nano-banana.jpeg",
  "should_texture": true,
  "topology": "triangle",
  "target_polycount": 30000
}

Example Response

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks (see Webhook section).

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Bad request — image_url missing, an input belonging to another operation, or an unsupported option such as enable_rigging. Anything checkable from the request body alone.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance.
429Too many requests.
500Internal server error.

Only what can be judged from the request body itself is rejected synchronously. Everything that needs an input to be fetched or the model to run is reported through the status endpoint instead, as status: "ERROR". Failed requests are not billed — the hold is released in full.

ConditionHow it surfaces
image_url missing, or not a stringsynchronous 400
mode, prompt or image_urls sent to this operationsynchronous 400
enable_rigging, enable_animation, or a geometry_resolution or model_type other than standardsynchronous 400
An image URL that is not https, not reachable, or not an imagestatus: "ERROR"

Retrieving Results

Poll the status endpoint with the request_id from the submit response until status is COMPLETED (or FAILED/ERROR), then download the model from output.media_url. 3D generation typically takes a few minutes, so poll every 10–15 seconds rather than continuously.

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7-1",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-09-22T11:56:21.804Z",
  "completed_at": "2026-09-22T12:01:44.210Z"
}

Meshy also produces OBJ, FBX and USDZ variants, a preview thumbnail and separate texture files. This API returns the GLB only — it is the single self-contained file that carries mesh, materials and textures together, and it is what the console preview renders.

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED, FAILED, or ERROR.
model_idstringThe model that handled the request.
output.media_urlarrayURL of the generated 3D model (GLB).
output.media_typestringmodel/gltf-binary.
created_atstringRequest creation timestamp.
completed_atstringCompletion timestamp.
errorstringError message when status is FAILED/ERROR.

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or FAILED/ERROR (failure).

How billing is measured

Billing is per generated model, and every request generates exactly one, so the amount held when the request is submitted is the amount charged on completion. The only thing that changes the amount is whether the model is textured — an untextured request costs less. It does not depend on the polygon count, the topology, or how many reference images you send. If the request fails, the hold is released in full.

Meshy 7.1 API Pricing

Textured is the default; an untextured request costs less. Polygon count, topology and the number of reference images do not change the price.

OptionPrice (USD)
Textured (default)$1.26
No texture$0.84
Image to Image (3D Models — Multi-Image to 3D)

Meshy 7.1 API Documentation

Build one 3D model from up to four photographs of the same object taken from different angles, with Meshy 7.1. More angles give the model more to work with than a single view can. Returns a GLB. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED, then download the model from output.media_url. 3D generation typically takes a few minutes.

POST https://gateway.pixazo.ai/meshy-7-1/v1/multi-image-to-3d

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Multi Image to 3D - Meshy 7.1

Request Code

POST https://gateway.pixazo.ai/meshy-7-1/v1/multi-image-to-3d
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "image_urls": [
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png"
  ],
  "should_texture": true
}
import requests

url = "https://gateway.pixazo.ai/meshy-7-1/v1/multi-image-to-3d"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "image_urls": [
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png"
  ],
  "should_texture": true
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-7-1/v1/multi-image-to-3d", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "image_urls": [
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png"
  ],
  "should_texture": true
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-7-1/v1/multi-image-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"image_urls": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png", "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png"], "should_texture": true}'

Output

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default, one callback on COMPLETED/ERROR) or sync (per-poll callbacks).

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/meshy-7-1/v1/multi-image-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"image_urls": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png", "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png"], "should_texture": true}'

Callback Payload (success)

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7-1",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-09-22T11:56:21.804Z",
  "completed_at": "2026-09-22T12:01:44.210Z"
}

Failure callback shape

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-7-1",
  "error": "Description of the failure"
}

Delivery semantics

  • terminal mode: one Webhook callback when the request is COMPLETED or ERROR.
  • sync mode: a Webhook callback on each status change.
  • Callbacks are idempotent on request_id — de-duplicate on it.
  • Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
image_urlsYesrequiredarray of strings—1–4 https URLs, each up to 20 MB
Images of the same object from different angles — not different objects, and not a sequence. jpg, jpeg, png, avif or heif. Each must be publicly reachable.
should_textureNobooleantruetrue, false
Controls texturing, and therefore the price. false returns untextured geometry only and costs less. This operation uses should_texture; text to 3D uses mode instead.
topologyNostringtrianglequad, triangle
Quad for smooth surfaces, triangle for detailed geometry.
target_polycountNointeger30000100–300000
Target polygon count of the remeshed model.
should_remeshNobooleantruetrue, false
When false, returns the raw triangular mesh without the remeshing pass.
symmetry_modeNostringautooff, auto, on
Force symmetry on or off, or let Meshy decide.
pose_modeNostring— (no specific pose)a-pose, t-pose, ""
Generate a character in a standard A-pose or T-pose, which is what most rigging tools expect.
texture_promptNostring—up to 600 characters
Text guidance for the texturing pass. Only used on a textured request.
texture_image_urlNostring—https URL, up to 20 MB
A 2D image that guides the texturing pass. Only used on a textured request.
enable_safety_checkerNobooleantruetrue, false
Screen the input before generating.

Good to know

  • Exactly one model is generated per request. There is no batch option: num_images, n, count, batch_size and number_of_images are rejected.
  • mode, prompt, image_url, model_type and seed are not available on this operation and are rejected.
  • Auto-rigging and animation (enable_rigging, enable_animation) are not available on this API, and geometry_resolution is fixed at standard.
  • Cost depends on whether the model is textured; the current rates are in the pricing panel on this page.

Example Request

{
  "image_urls": [
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png"
  ],
  "should_texture": true
}

Example Response

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks (see Webhook section).

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Bad request — image_urls missing, empty or longer than 4, an input belonging to another operation, or an unsupported option such as enable_rigging. Anything checkable from the request body alone.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance.
429Too many requests.
500Internal server error.

Only what can be judged from the request body itself is rejected synchronously. Everything that needs an input to be fetched or the model to run is reported through the status endpoint instead, as status: "ERROR". Failed requests are not billed — the hold is released in full.

ConditionHow it surfaces
image_urls missing, empty, or more than 4 entriessynchronous 400
mode, prompt, image_url, model_type or seed sent to this operationsynchronous 400
enable_rigging, enable_animation, or geometry_resolution other than standardsynchronous 400
An image URL that is not https, not reachable, or not an imagestatus: "ERROR"

Retrieving Results

Poll the status endpoint with the request_id from the submit response until status is COMPLETED (or FAILED/ERROR), then download the model from output.media_url. 3D generation typically takes a few minutes, so poll every 10–15 seconds rather than continuously.

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "meshy-7-1_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7-1",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-09-22T11:56:21.804Z",
  "completed_at": "2026-09-22T12:01:44.210Z"
}

Meshy also produces OBJ, FBX and USDZ variants, a preview thumbnail and separate texture files. This API returns the GLB only — it is the single self-contained file that carries mesh, materials and textures together, and it is what the console preview renders.

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED, FAILED, or ERROR.
model_idstringThe model that handled the request.
output.media_urlarrayURL of the generated 3D model (GLB).
output.media_typestringmodel/gltf-binary.
created_atstringRequest creation timestamp.
completed_atstringCompletion timestamp.
errorstringError message when status is FAILED/ERROR.

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or FAILED/ERROR (failure).

How billing is measured

Billing is per generated model, and every request generates exactly one, so the amount held when the request is submitted is the amount charged on completion. The only thing that changes the amount is whether the model is textured — an untextured request costs less. It does not depend on the polygon count, the topology, or how many reference images you send. If the request fails, the hold is released in full.

Meshy 7.1 API Pricing

Textured is the default; an untextured request costs less. Polygon count, topology and the number of reference images do not change the price.

OptionPrice (USD)
Textured (default)$1.26
No texture$0.84
3. Meshy 7

Meshy 7 API Documentation

Generate a textured 3D model in GLB format from a single image with Meshy 7. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED, then download the model.

POST https://gateway.pixazo.ai/meshy-7/v1/image-to-3d

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Image to 3D - Meshy 7

Request Code

POST https://gateway.pixazo.ai/meshy-7/v1/image-to-3d
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/single.png",
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true
}
import requests

url = "https://gateway.pixazo.ai/meshy-7/v1/image-to-3d"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/single.png",
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-7/v1/image-to-3d", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/single.png",
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-7/v1/image-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/single.png", "topology": "triangle", "target_polycount": 30000, "symmetry_mode": "auto", "should_remesh": true, "should_texture": true}'

Output

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. 3D generation regularly runs for several minutes, so a Webhook is usually the better fit here.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default) or sync (per-poll callbacks).

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/meshy-7/v1/image-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/single.png", "topology": "triangle", "target_polycount": 30000, "symmetry_mode": "auto", "should_remesh": true, "should_texture": true}'

Callback Payload (success)

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-08-17T09:14:16.102Z",
  "completed_at": "2026-08-17T09:26:41.870Z"
}

Failure callback shape

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-7",
  "error": "Description of the failure"
}

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
image_urlYesrequiredstring—Image URL or base64 data URI
Source image for the 3D model. Accepts .jpg, .jpeg and .png; AVIF and HEIF are converted automatically.
model_typeNostringstandardstandard
Mesh style. Only standard is accepted: Meshy now offers Smart Topology as separate models (Meshy T2 and T2.5), which this API does not include.
topologyNostringtrianglequad, triangle
Mesh topology. quad suits smooth surfaces, triangle detailed geometry. Ignored when should_remesh is false.
target_polycountNointeger30000100–300000
Target polygon count of the generated mesh. Ignored when should_remesh is false.
symmetry_modeNostringautooff, auto, on
Symmetry behaviour. off disables it, auto decides per object, on enforces it.
should_remeshNobooleantruetrue, false
Run the remesh phase. When false the raw triangular mesh is returned and both topology and target_polycount are ignored.
should_textureNobooleantruetrue, false
Generate textures. Affects the price — see Pricing. Setting false returns an untextured mesh and costs less.
enable_pbrNobooleanfalsetrue, false
Also generate PBR maps (metallic, roughness, normal) alongside base colour. Requires should_texture. Does not affect the price.
pose_modeNostring""a-pose, t-pose, ""
Force the generated character into an A-pose or T-pose. Empty string applies no specific pose.
is_a_t_poseNobooleanfalsetrue, false
Deprecated — use pose_mode instead. Treats the input as already in T-pose.
texture_promptNostring—Up to 600 characters
Text prompt steering the texturing pass. Requires should_texture. Longer values are rejected with 400.
texture_image_urlNostring—Image URL
2D image steering the texturing pass. Requires should_texture.
enable_riggingNobooleanfalsetrue, false
Auto-rig the result as a humanoid character, including basic walk and run animations. Best on humanoid subjects. Adds $0.20 — see Pricing.
rigging_height_metersNonumber1.70.1–10 metres
Approximate character height. Only read when enable_rigging is true.
enable_animationNobooleanfalsetrue, false
Apply an animation preset. Requires enable_rigging — set on its own it has no effect and is not billed. Adds $0.12.
animation_action_idNointeger920–696
Meshy animation preset (0 is Idle). Only read when enable_animation is true; a value outside the range is rejected with 422.
enable_safety_checkerNobooleantruetrue, false
Safety-check the input images before processing.
ultra_modeNobooleanfalsetrue, false
Higher-fidelity geometry with finer surface detail. Affects the price — see Pricing.

Notes

should_texture and ultra_mode are the two price axes on this operation; enable_rigging and enable_animation add fixed amounts on top. enable_animation requires enable_rigging — sent alone it is ignored and not billed.

Example Request

{
  "image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/single.png",
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true
}

Example Response

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks.

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Bad request — a missing or out-of-range parameter. The message names the field.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance.
422Unprocessable entity — the provider rejected a value, e.g. an animation_action_id outside 0–696.
429Too many requests.
500Internal server error.

Retrieving Results

Poll the status endpoint with the request_id until status is COMPLETED (or ERROR), then download output.media_url. A 3D generation typically takes a few minutes, and considerably longer with rigging or animation enabled.

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-08-17T09:14:16.102Z",
  "completed_at": "2026-08-17T09:26:41.870Z"
}

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED or ERROR.
model_idstringThe model that handled the request.
output.media_urlarrayOne URL, pointing at the generated .glb model.
output.media_typestringmodel/gltf-binary.
created_atstringRequest creation timestamp.
completed_atstringCompletion timestamp.
errorstringError message when status is ERROR.

Meshy also produces OBJ, FBX and USDZ variants, a preview thumbnail and separate texture files. This API returns the GLB only — it is the single self-contained file that carries mesh, materials and textures together, and it is what the console preview renders.

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure).

Pricing

Billed per generation. The base rate depends on the options below; add-ons are then added on top.

OptionsResultPrice
should_texture: falseUntextured mesh$0.80
defaultTextured model$1.20
ultra_mode: trueUltra-quality textured model$1.40

Add-ons, charged on top of the base rate: enable_rigging +$0.20, enable_animation +$0.12. Animation requires rigging, so the two together add $0.32.

Failed requests are not billed.

Meshy 7 API Pricing

Base rate depends on texturing and ultra mode; auto-rigging adds $0.20 and animation adds $0.12.

OptionPrice (USD)
Textured (default)$1.20
No texture$0.80
Ultra mode$1.40
Auto-rigging add-on (additional)$0.20
Animation add-on (additional)$0.12
Image to Image (3D Models — Multi-Image to 3D)

Meshy 7 API Documentation

Generate a textured 3D model in GLB format from up to four images of the same object photographed from different angles, with Meshy 7. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED, then download the model.

POST https://gateway.pixazo.ai/meshy-7/v1/multi-image-to-3d

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Multi Image to 3D - Meshy 7

Request Code

POST https://gateway.pixazo.ai/meshy-7/v1/multi-image-to-3d
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "image_urls": [
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-3.png"
  ],
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true
}
import requests

url = "https://gateway.pixazo.ai/meshy-7/v1/multi-image-to-3d"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "image_urls": [
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-3.png"
  ],
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-7/v1/multi-image-to-3d", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "image_urls": [
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-3.png"
  ],
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-7/v1/multi-image-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"image_urls": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png", "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png", "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-3.png"], "topology": "triangle", "target_polycount": 30000, "symmetry_mode": "auto", "should_remesh": true, "should_texture": true}'

Output

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. 3D generation regularly runs for several minutes, so a Webhook is usually the better fit here.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default) or sync (per-poll callbacks).

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/meshy-7/v1/multi-image-to-3d' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"image_urls": ["https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png", "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png", "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-3.png"], "topology": "triangle", "target_polycount": 30000, "symmetry_mode": "auto", "should_remesh": true, "should_texture": true}'

Callback Payload (success)

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-08-17T09:14:16.102Z",
  "completed_at": "2026-08-17T09:26:41.870Z"
}

Failure callback shape

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-7",
  "error": "Description of the failure"
}

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
image_urlsYesrequiredarray of string—1–4 image URLs
Between one and four images of the same object from different angles. Accepts .jpg, .jpeg and .png; AVIF and HEIF are converted automatically. Sending more than four is rejected with 400, not silently truncated.
topologyNostringtrianglequad, triangle
Mesh topology. quad suits smooth surfaces, triangle detailed geometry. Ignored when should_remesh is false.
target_polycountNointeger30000100–300000
Target polygon count of the generated mesh. Ignored when should_remesh is false.
symmetry_modeNostringautooff, auto, on
Symmetry behaviour. off disables it, auto decides per object, on enforces it.
should_remeshNobooleantruetrue, false
Run the remesh phase. When false the raw triangular mesh is returned and both topology and target_polycount are ignored.
should_textureNobooleantruetrue, false
Generate textures. Affects the price — see Pricing. On this operation an untextured model is billed at the same rate as a textured one.
enable_pbrNobooleanfalsetrue, false
Also generate PBR maps (metallic, roughness, normal) alongside base colour. Requires should_texture. Does not affect the price.
pose_modeNostring""a-pose, t-pose, ""
Force the generated character into an A-pose or T-pose. Empty string applies no specific pose.
is_a_t_poseNobooleanfalsetrue, false
Deprecated — use pose_mode instead. Treats the input as already in T-pose.
texture_promptNostring—Up to 600 characters
Text prompt steering the texturing pass. Requires should_texture. Longer values are rejected with 400.
texture_image_urlNostring—Image URL
2D image steering the texturing pass. Requires should_texture.
enable_riggingNobooleanfalsetrue, false
Auto-rig the result as a humanoid character, including basic walk and run animations. Best on humanoid subjects. Adds $0.20 — see Pricing.
rigging_height_metersNonumber1.70.1–10 metres
Approximate character height. Only read when enable_rigging is true.
enable_animationNobooleanfalsetrue, false
Apply an animation preset. Requires enable_rigging — set on its own it has no effect and is not billed. Adds $0.12.
animation_action_idNointeger920–696
Meshy animation preset (0 is Idle). Only read when enable_animation is true; a value outside the range is rejected with 422.
enable_safety_checkerNobooleantruetrue, false
Safety-check the input images before processing.
ultra_modeNobooleanfalsetrue, false
Higher-fidelity geometry with finer surface detail. Affects the price — see Pricing. Charged only when you send it explicitly; omit it and the standard rate applies.

Notes

model_type is not available on this operation — it exists only on the single-image /image-to-3d endpoint, and sending it here has no effect and does not change the price. enable_animation requires enable_rigging; sent alone it is ignored and not billed. All input images must show the same object, or the reconstruction degrades badly.

Example Request

{
  "image_urls": [
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-1.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-2.png",
    "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/meshy-7/multi-3.png"
  ],
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true
}

Example Response

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks.

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Bad request — a missing or out-of-range parameter. The message names the field.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance.
422Unprocessable entity — the provider rejected a value, e.g. an animation_action_id outside 0–696.
429Too many requests.
500Internal server error.

Retrieving Results

Poll the status endpoint with the request_id until status is COMPLETED (or ERROR), then download output.media_url. A 3D generation typically takes a few minutes, and considerably longer with rigging or animation enabled.

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "meshy-7_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-08-17T09:14:16.102Z",
  "completed_at": "2026-08-17T09:26:41.870Z"
}

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED or ERROR.
model_idstringThe model that handled the request.
output.media_urlarrayOne URL, pointing at the generated .glb model.
output.media_typestringmodel/gltf-binary.
created_atstringRequest creation timestamp.
completed_atstringCompletion timestamp.
errorstringError message when status is ERROR.

Meshy also produces OBJ, FBX and USDZ variants, a preview thumbnail and separate texture files. This API returns the GLB only — it is the single self-contained file that carries mesh, materials and textures together, and it is what the console preview renders.

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure).

Pricing

Billed per generation. The base rate depends on the options below; add-ons are then added on top.

OptionsResultPrice
defaultTextured model$1.20
should_texture: falseUntextured mesh — billed at the textured rate$1.20
ultra_mode: trueUltra-quality textured model$1.40

Add-ons, charged on top of the base rate: enable_rigging +$0.20, enable_animation +$0.12. Animation requires rigging, so the two together add $0.32.

Failed requests are not billed.

Meshy 7 API Pricing

Base rate depends on ultra mode; auto-rigging adds $0.20 and animation adds $0.12.

OptionPrice (USD)
Textured (default)$1.20
Ultra mode$1.40
Auto-rigging add-on (additional)$0.20
Animation add-on (additional)$0.12
Image to Image (3D Models — Retexture)

Meshy 7 API Documentation

Give an existing 3D model new textures with Meshy 7 Retexture: send the model in model_url (GLB, glTF, OBJ, FBX or STL) and describe the look in text_style_prompt, or send a picture of the style in image_style_url. Optionally choose a 4k base texture and PBR maps. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED, then download the 3D model from output.media_url.

POST https://gateway.pixazo.ai/meshy-7-retexture/v1/retexture

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Image to Image (3D Models — Retexture) - Meshy 7 Retexture

Request Code

POST https://gateway.pixazo.ai/meshy-7-retexture/v1/retexture
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "weathered bronze with a green patina"
}
import requests

url = "https://gateway.pixazo.ai/meshy-7-retexture/v1/retexture"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "weathered bronze with a green patina"
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-7-retexture/v1/retexture", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "weathered bronze with a green patina"
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-7-retexture/v1/retexture' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb", "text_style_prompt": "weathered bronze with a green patina"}'

Output

{
  "request_id": "meshy-7-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default, one callback on COMPLETED/ERROR) or sync (per-poll callbacks).

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/meshy-7-retexture/v1/retexture' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb", "text_style_prompt": "weathered bronze with a green patina"}'

Callback Payload (success)

{
  "request_id": "meshy-7-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7-retexture",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-10-09T10:04:54.387Z",
  "completed_at": "2026-10-09 10:06:21"
}

Failure callback shape

{
  "request_id": "meshy-7-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-7-retexture",
  "error": "Description of the failure"
}

Delivery semantics

  • terminal mode: one Webhook callback when the request is COMPLETED or ERROR.
  • sync mode: a Webhook callback on every poll while the request is processing (status PROCESSING), plus the final COMPLETED/ERROR callback.
  • Callbacks are idempotent on request_id — de-duplicate on it.
  • Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
model_urlYesrequiredstring—A publicly reachable https URL (recommended) or a base64 data URI of a .glb, .gltf, .obj, .fbx or .stl model
The 3D model to retexture.
text_style_promptNostring—Text, up to 600 characters
The texture you want, for example weathered bronze with a green patina. Required unless you send image_style_url.
image_style_urlNostring—A publicly reachable https URL (recommended) or a data URI of a JPEG or PNG image
A picture of the style to apply. When you send both, image_style_url is used and text_style_prompt is ignored.
texture_resolutionNostring"2k"2k, 4k
The size of the base color texture: 2k (2048) or 4k (4096). It does not change the amount billed.
enable_original_uvNobooleantruetrue, false
Keep the model's own UV layout instead of generating a new one. If the model has no UV layout of its own, the result may be lower in quality.
enable_pbrNobooleanfalsetrue, false
Also generate PBR maps (metallic, roughness and normal) in addition to the base color. It does not change the amount billed.
enable_safety_checkerNobooleantruetrue, false
Check the inputs for unsafe content before processing.

Good to know

  • Each request returns one 3D model. batch_size, num_images, number_of_images, n and count are rejected — send one request per 3D model.
  • This API works on a single 3D model and has no length setting. duration, seconds, num_frames, frames_per_second and music_length_ms are rejected.
  • Send every field at the top level of the JSON body; parameters, content and text are rejected.
  • Send the 3D model as model_url: a publicly reachable https URL (recommended) or a base64 data URI, in GLB, glTF, OBJ, FBX or STL format. One model per request.
  • Describe the texture in text_style_prompt (up to 600 characters) or send a style picture as image_style_url: one of the two is required. When you send both, the picture is used.
  • input_task_id is not accepted: send the 3D model itself as model_url.
  • image_url and multiview_image_urls are rejected: send one style picture as image_style_url.
  • texture_resolution takes 2k (the default) or 4k; any other value is rejected.
  • Use the JSON types shown: model_url, text_style_prompt, image_style_url and texture_resolution are strings; the options are true or false (not "true").
  • Omit a field instead of sending null.
  • Results are always returned as a URL in output.media_url; sync_mode is accepted only as false.
  • Webhooks are set with the X-Webhook-URL / X-Webhook-Mode headers; webhook_url, webhook_mode and callback_url in the JSON body are rejected.
  • stream is not supported: the result is delivered when the job completes.
  • Options this API does not offer are rejected: prompt, model, ai_model, remove_lighting, target_formats, alpha_thumbnail and hd_texture.

Texture Style: Text or Picture

  • Describe the texture in text_style_prompt, up to 600 characters: the material, the colours and any wear.
  • Or send a picture of the style in image_style_url (JPEG or PNG). When you send both, the picture is used.
  • texture_resolution sets the size of the base color texture: 2k (2048, the default) or 4k (4096). With enable_pbr, metallic, roughness and normal maps are generated as well.
  • The result is one GLB file with the new textures embedded.

Example: use a picture as the style

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "image_style_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/images/input.jpg"
}

Example: a 4k base texture with PBR maps

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "glossy red ceramic with gold accents",
  "texture_resolution": "4k",
  "enable_pbr": true
}

Example Request

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "weathered bronze with a green patina"
}

Example Response

{
  "request_id": "meshy-7-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-7-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks (see Webhook section).
X-Webhook-ModeNoterminal (default) or sync (see Webhook section).

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Invalid request — a required field is missing, a value has the wrong type, is too long, out of range or not one of the allowed values, or a field this operation does not accept was sent. The message says what to fix.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance for the hold this request needs.
429Too many requests.
500Internal server error.

Parameter problems are caught when you submit and returned as a 400, before any hold is placed on your balance. Problems that need the model to run are reported through the status endpoint as status: "ERROR", with a message in error saying what went wrong. Failed requests are not billed — the hold is released in full.

ConditionHow it surfaces
Missing or invalid subscription keysynchronous 401
Balance too low for the holdsynchronous 402
Missing or empty model_url, model_url not a stringsynchronous 400
text_style_prompt not a string, or longer than 600 characterssynchronous 400
texture_resolution must be '2k' or '4k' (or left out for '2k'): the 8k texture is not available on this APIsynchronous 400
texture_resolution not one of the allowed values (written exactly as listed)synchronous 400
enable_original_uv or enable_pbr or enable_safety_checker not true or false — for example the string "true"synchronous 400
image_style_url not a stringsynchronous 400
sync_mode set to anything other than false (results are always returned as a URL in output.media_url)synchronous 400
image_url, multiview_image_urls (send one style picture as image_style_url)synchronous 400
input_task_id (send the 3D model itself as model_url)synchronous 400
batch_size, num_images, number_of_images, n, count (one 3D model per request)synchronous 400
duration, seconds, num_frames, frames_per_second, music_length_ms (this API works on a single 3D model)synchronous 400
parameters, content, text (send the fields at the top level of the JSON body)synchronous 400
webhook_url, webhook_mode, callback_url in the JSON body (use the X-Webhook-URL / X-Webhook-Mode headers)synchronous 400
stream (the result is delivered when the job completes)synchronous 400
prompt, model, ai_model, remove_lighting, target_formats, alpha_thumbnail, hd_texture (not accepted by this operation)synchronous 400
A model file that cannot be read, or one that is not a GLB, glTF, OBJ, FBX or STL modelstatus: "ERROR"
A style picture that cannot be read, or one larger than 20 MBstatus: "ERROR"
A request the model refuses, for example under its content policystatus: "ERROR"

Example error responses

A refused request returns error, a message that joins every problem found, and the same problems one by one in violations.

Missing model_url (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'model_url' is required",
  "violations": [
    "'model_url' is required"
  ]
}

Neither text_style_prompt nor image_style_url (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'text_style_prompt' is required unless 'image_style_url' is provided",
  "violations": [
    "'text_style_prompt' is required unless 'image_style_url' is provided"
  ]
}

A texture size that is not offered (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'texture_resolution' must be one of: \"2k\", \"4k\" (got \"8k\"); 'texture_resolution' must be '2k' or '4k' (or left out for '2k'): the 8k texture is not available on this API.",
  "violations": [
    "'texture_resolution' must be one of: \"2k\", \"4k\" (got \"8k\")",
    "'texture_resolution' must be '2k' or '4k' (or left out for '2k'): the 8k texture is not available on this API."
  ]
}

An earlier task referenced instead of a model (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'model_url' is required; 'input_task_id' must be one of:  (got \"0193a1b2-0000-7000-8000-000000000000\"); 'input_task_id' is not accepted. Send the 3D model itself as 'model_url' (a public URL or a base64 data URI).",
  "violations": [
    "'model_url' is required",
    "'input_task_id' must be one of:  (got \"0193a1b2-0000-7000-8000-000000000000\")",
    "'input_task_id' is not accepted. Send the 3D model itself as 'model_url' (a public URL or a base64 data URI)."
  ]
}

More than one model per request (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'num_images' must be one of:  (got 2); 'num_images' is not supported: each request retextures one 3D model. Send one request per model.",
  "violations": [
    "'num_images' must be one of:  (got 2)",
    "'num_images' is not supported: each request retextures one 3D model. Send one request per model."
  ]
}

Retrieving Results

Poll the status endpoint with the request_id from the submit response until status is COMPLETED or ERROR, then download the 3D model from output.media_url. Treat any status other than QUEUED, PROCESSING or COMPLETED as a failure.

Endpoint

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

cURL example

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-7-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "meshy-7-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-7-retexture",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-10-09T10:04:54.387Z",
  "completed_at": "2026-10-09 10:06:21"
}

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED or ERROR.
model_idstringThe model that handled the request — meshy-7-retexture for this endpoint.
output.media_urlarray of stringsURL of the 3D model (one GLB file per request).
output.media_typestringmodel/gltf-binary.
created_atstringRequest creation timestamp.
completed_atstringCompletion timestamp.
errorstringError message when status is ERROR.
polling_urlstringStatus URL for this request (submit response only).

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure).

Typical workflow

  1. Send the request to POST https://gateway.pixazo.ai/meshy-7-retexture/v1/retexture.
  2. Save the request_id from the 202 response.
  3. Poll GET /v2/requests/status/{request_id} every 10 seconds or so, or use a Webhook instead.
  4. When status is COMPLETED, download the 3D model from output.media_url.

How Billing Is Measured

Billing is measured per retextured model: each request is billed once, for one model. The texture size (2k or 4k), PBR maps, the prompt and the options do not change the amount. The amount is placed as a hold when the request is submitted and released in full if the request fails. The current rate is shown in the pricing panel on this page.

Meshy 7 API Pricing

Retexture an existing 3D model from a text prompt or a reference image, with a 2K or 4K base texture. PBR maps (metallic, roughness, normal) are included at no extra cost, embedded in the returned GLB.

Your request will cost $0.30 per retextured model.
4. Meshy 6

Meshy 6 API Documentation

https://gateway.pixazo.ai/meshy-6-text-to-3d/v1/meshy-6-text-to-3d-request

Authentication

All requests require an API key passed via header.

Header Type Required Description
Ocp-Apim-Subscription-Key string Yes Your API subscription key

Meshy 6 (Text to 3D) generate request - Meshy 6 (Text to 3D)

Request Code

POST https://gateway.pixazo.ai/meshy-6-text-to-3d/v1/meshy-6-text-to-3d-request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "prompt": "A rustic antique wooden treasure chest with iron bands and ornate metalwork",
  "mode": "full",
  "topology": "triangle",
  "target_polycount": 30000,
  "should_remesh": true,
  "symmetry_mode": "auto",
  "rigging_height_meters": 1.7,
  "animation_action_id": 92,
  "enable_safety_checker": true
}
import requests

url = "https://gateway.pixazo.ai/meshy-6-text-to-3d/v1/meshy-6-text-to-3d-request"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "prompt": "A rustic antique wooden treasure chest with iron bands and ornate metalwork",
    "mode": "full",
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": true,
    "symmetry_mode": "auto",
    "rigging_height_meters": 1.7,
    "animation_action_id": 92,
    "enable_safety_checker": true
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
const url = "https://gateway.pixazo.ai/meshy-6-text-to-3d/v1/meshy-6-text-to-3d-request";

const headers = {
  "Content-Type": "application/json",
  "Cache-Control": "no-cache",
  "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
};

const data = {
  prompt: "A rustic antique wooden treasure chest with iron bands and ornate metalwork",
  mode: "full",
  topology: "triangle",
  target_polycount: 30000,
  should_remesh: true,
  symmetry_mode: "auto",
  rigging_height_meters: 1.7,
  animation_action_id: 92,
  enable_safety_checker: true
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/meshy-6-text-to-3d/v1/meshy-6-text-to-3d-request" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "prompt": "A rustic antique wooden treasure chest with iron bands and ornate metalwork",
    "mode": "full",
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": true,
    "symmetry_mode": "auto",
    "rigging_height_meters": 1.7,
    "animation_action_id": 92,
    "enable_safety_checker": true
  }'

Output

{
  "request_id": "meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Parameters - Meshy 6 (Text to 3D) generate request

ParameterRequiredTypeDefaultAllowed values / range
promptYesrequiredstring—Max 600 characters
Description of the 3D object. Maximum 600 characters.
modeNoenum"full"preview, full
Generation mode. "preview" returns untextured geometry only; "full" runs preview + refine and returns a fully textured model (required for the texture, PBR and rigging options).
seedNointeger——
Random seed that controls the generation's randomness. Reuse the same seed with identical settings to reproduce the same result; leave it empty for a different output each time.
model_typeNoenum"standard"standard
Type of 3D mesh generation. Only "standard" is accepted: Meshy now offers Smart Topology as separate models (Meshy T2 and T2.5), which this API does not include.
topologyNoenum"triangle"quad, triangle
Mesh topology type. Quad for smooth surfaces, triangle for detailed geometry.
target_polycountNointeger30000100–300000
The desired number of polygons in the generated 3D model. Higher values give a more detailed, heavier mesh; lower values give a simpler, lighter one.
should_remeshNobooleantruetrue, false
Rebuilds the model's surface grid for cleaner geometry. When off, returns the raw, unoptimized triangular mesh.
symmetry_modeNoenum"auto"off, auto, on
Symmetry enforcement mode. "off" disables symmetry, "auto" decides automatically, "on" enforces symmetry.
enable_pbrNobooleanfalsetrue, false
Generates realistic surface materials (PBR: metallic, roughness, normal maps) so the model reacts properly to light. Only available in full mode.
pose_modeNoenum""a-pose, t-pose, "" (empty)
Character pose for rigging. "a-pose" generates an A-pose, "t-pose" a T-pose; empty string for no specific pose.
enable_prompt_expansionNobooleanfalsetrue, false
Automatically rewrites and enriches your prompt with extra detail before generation to improve results.
texture_promptNostring—Max 600 characters
Additional prompt to guide texturing. Only used in full mode.
texture_image_urlNostring——
URL to a 2D image used to guide texturing. Only used in full mode.
enable_riggingNobooleanfalsetrue, false
Auto-rig the generated model as a humanoid character, including basic walking and running animations.
rigging_height_metersNofloat1.7—
Approximate height of the rigged character in meters. Only used when enable_rigging is true.
enable_animationNobooleanfalsetrue, false
Apply a predefined animation preset. Requires enable_rigging to be true.
animation_action_idNointeger920–696
Animation preset ID from Meshy's library. Only used when enable_animation is true. See https://docs.meshy.ai/en/api/animation-library.
enable_safety_checkerNobooleantruetrue, false
Turns on automatic filtering of unsafe or explicit (NSFW) content. Leave enabled unless you have a specific reason to disable it.

Content Item Types & Limits

TypeMaxFormat / SizeDescription
image1JPG, PNG, WEBPOptional texture-guidance image (1024px+).

Minimum Request

{
  "prompt": "A rustic antique wooden treasure chest with iron bands and ornate metalwork"
}

Full Request (all options)

{
  "prompt": "A rustic antique wooden treasure chest with iron bands and ornate metalwork",
  "mode": "full",
  "seed": 12345,
  "topology": "triangle",
  "target_polycount": 30000,
  "should_remesh": true,
  "symmetry_mode": "auto",
  "enable_pbr": true,
  "pose_mode": "t-pose",
  "enable_prompt_expansion": false,
  "texture_prompt": "Ancient wood with weathered patina and brass fittings",
  "texture_image_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/images/input.jpg",
  "enable_rigging": true,
  "rigging_height_meters": 1.7,
  "enable_animation": true,
  "animation_action_id": 92,
  "enable_safety_checker": true
}

Response

{
  "request_id": "meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Response Fields - Meshy 6 (Text to 3D) generate request

Field Type Description
request_idstringUnique identifier to track the job status
statusstringCurrent status of the job (QUEUED, PROCESSING, COMPLETED, FAILED, ERROR)
polling_urlstringURL to use for checking the status of the generated model

Request Headers

Header Value
Content-Typeapplication/json
Cache-Controlno-cache
Ocp-Apim-Subscription-KeyYour API subscription key

Response Handling

Common status codes for Meshy 6 (Text to 3D) generate request.

Code Meaning
200 Success
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Common Error Responses

400 Validation Error

{
  "error": "Invalid parameter: mode must be one of 'preview', 'full'"
}

404 Not Found

{
  "error": "Invalid request_id: meshy-6-text-to-3d_invalid_id"
}

Status Workflow

Status values and lifecycle for Meshy 6 (Text to 3D) requests.

Status Description
QUEUEDRequest accepted, waiting to be processed
PROCESSINGBeing processed by the model
COMPLETEDDone — output contains the result
FAILEDFailed — check error field
ERRORSystem error — not charged

Status Flow

Submitted → QUEUED → PROCESSING → COMPLETED/FAILED/ERROR

Typical Workflow

  1. Submit request to /meshy-6-text-to-3d-request
  2. Receive request_id in response
  3. Poll /v2/requests/status/{request_id} every 2-3 seconds
  4. When status=COMPLETED, use model_glb and other URLs from response
  5. Handle FAILED or ERROR states with appropriate retry or error handling

Meshy 6 (Text to 3D) check status - Meshy 6 (Text to 3D)

Request Code

POST https://gateway.pixazo.ai/meshy-6-text-to-3d/v1/meshy-6-text-to-3d-request-result
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "request_id": "meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
import requests

url = "https://gateway.pixazo.ai/meshy-6-text-to-3d/v1/meshy-6-text-to-3d-request-result"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "request_id": "meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())
const url = "https://gateway.pixazo.ai/meshy-6-text-to-3d/v1/meshy-6-text-to-3d-request-result";

const headers = {
  "Content-Type": "application/json",
  "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
};

const data = {
  request_id: "meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
curl -X POST "https://gateway.pixazo.ai/meshy-6-text-to-3d/v1/meshy-6-text-to-3d-request-result" \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "request_id": "meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }'

Output

{
  "model_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.glb",
  "thumbnail": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/thumbnail.jpg",
  "model_urls": {
    "glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.glb",
    "fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.fbx",
    "obj": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.obj",
    "usdz": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.usdz",
    "blend": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.blend",
    "stl": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.stl"
  },
  "texture_urls": {
    "base_color": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/base_color.jpg",
    "metallic": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/metallic.jpg",
    "roughness": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/roughness.jpg",
    "normal": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/normal.jpg"
  },
  "seed": 12345,
  "prompt": "A rustic antique wooden treasure chest with iron bands and ornate metalwork",
  "actual_prompt": "A rustic antique wooden treasure chest with iron bands and ornate metalwork, weathered with age, displaying intricate carvings and tarnished brass fittings"
}

Request Parameters - Meshy 6 (Text to 3D) check status

ParameterRequiredTypeDefaultAllowed values / range
request_idYesrequiredstring——
Unique identifier returned from the initial request submission

Minimum Request

{
  "request_id": "meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Full Request (all options)

{
  "request_id": "meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Response

{
  "request_id": "meshy-6-text-to-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-6-text-to-3d",
  "error": null,
  "output": {
    "model_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.glb",
    "thumbnail": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/thumbnail.jpg",
    "model_urls": {
      "glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.glb",
      "fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.fbx",
      "obj": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.obj",
      "usdz": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.usdz",
      "blend": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.blend",
      "stl": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/output.stl"
    },
    "texture_urls": {
      "base_color": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/base_color.jpg",
      "metallic": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/metallic.jpg",
      "roughness": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/roughness.jpg",
      "normal": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/normal.jpg"
    },
    "seed": 12345,
    "prompt": "A rustic antique wooden treasure chest with iron bands and ornate metalwork",
    "actual_prompt": "A rustic antique wooden treasure chest with iron bands and ornate metalwork, weathered with age, displaying intricate carvings and tarnished brass fittings"
  },
  "rigged_character_glb": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/rigged_character.glb",
  "rigged_character_fbx": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/rigged_character.fbx",
  "basic_animations": [
    {
      "name": "idle",
      "url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-text-to-3d_019dxxxx/animation_idle.glb"
    }
  ],
  "rig_task_id": "rig_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}

Response Fields - Meshy 6 (Text to 3D) check status

Field Type Description
request_idstringUnique identifier of the request
statusstringCurrent status of the job (QUEUED, PROCESSING, COMPLETED, FAILED, ERROR)
model_idstringID of the model used for generation
errornull|stringError description if status is FAILED, otherwise null
output.model_glbstringURL to the GLB model file
output.thumbnailstringURL to the model thumbnail image
output.model_urlsobjectDictionary of model file formats and their URLs (glb, fbx, obj, usdz, blend, stl)
output.texture_urlsobjectDictionary of texture map URLs (base_color, metallic, roughness, normal)
output.seedintegerSeed used for the generation
output.promptstringOriginal text prompt
output.actual_promptstringPrompt after LLM expansion (if enable_prompt_expansion was used)
rigged_character_glbstringURL to the rigged character GLB file (if enable_rigging was true)
rigged_character_fbxstringURL to the rigged character FBX file (if enable_rigging was true)
basic_animationsarrayList of animation files with name and URL
rig_task_idstringInternal identifier for the rigging task (if enable_rigging was true)
created_atstringISO timestamp when the request was created
updated_atstringISO timestamp when the request was last updated
completed_atstringISO timestamp when the request was completed

Request Headers

Header Value
Content-Typeapplication/json
Ocp-Apim-Subscription-KeyYour API subscription key

Response Handling

Common status codes for Meshy 6 (Text to 3D) check status.

Code Meaning
200 Success
Bad Request (invalid request_id)
401 Unauthorized
403 Forbidden
404 Not Found (request_id not found)
Too Many Requests
500 Internal Server Error

Notes & Tips

  1. Poll the status endpoint every 2–3 seconds until status is COMPLETED, FAILED, or ERROR.
  2. Use enable_prompt_expansion to enhance vague prompts with semantic detail.
  3. For character models, combine enable_rigging, pose_mode, and enable_animation for ready-to-animate assets.
  4. Use texture_image_url for precise texture control when text prompts are insufficient.
  5. Set target_polycount appropriately: lower values (5k–15k) for web/mobile, higher (30k–100k) for high-end rendering.
  6. Always validate actual_prompt in COMPLETED responses to confirm prompt expansion behavior.
  7. Implement retry logic for transient ERROR or FAILED states.
  8. Predictive generation time: 15–60 seconds for preview mode, 30–120 seconds for full mode.
  9. Texture guidance works best with high-resolution source images (1024x1024+).
  10. Enable safety_checker is recommended for public applications to prevent inappropriate generation.

Meshy 6 API Pricing

Your request will cost $0.80 per generated 3D model.
Image to Image (3D Models — Image to 3D)

Meshy 6 API Documentation

https://gateway.pixazo.ai/meshy-6-i2-3d/v1/meshy-6-i2-3d-request

Authentication

All requests require an API key passed via header.

Header Type Required Description
Ocp-Apim-Subscription-Key string Yes Your API subscription key

Meshy 6 i2-3d generate request - Meshy 6 i2-3d

Request Code

POST https://gateway.pixazo.ai/meshy-6-i2-3d/v1/meshy-6-i2-3d-request
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "image_url": "https://imagesai.appypie.com/7686410/ZU2sxXLmgRF6dgSktn9o_017731475651251.png"
}
import requests

url = "https://gateway.pixazo.ai/meshy-6-i2-3d/v1/meshy-6-i2-3d-request"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "image_url": "https://imagesai.appypie.com/7686410/ZU2sxXLmgRF6dgSktn9o_017731475651251.png"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())
const url = "https://gateway.pixazo.ai/meshy-6-i2-3d/v1/meshy-6-i2-3d-request";
const headers = {
  "Content-Type": "application/json",
  "Cache-Control": "no-cache",
  "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
};
const data = {
  "image_url": "https://imagesai.appypie.com/7686410/ZU2sxXLmgRF6dgSktn9o_017731475651251.png"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
curl -X POST "https://gateway.pixazo.ai/meshy-6-i2-3d/v1/meshy-6-i2-3d-request" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "image_url": "https://imagesai.appypie.com/7686410/ZU2sxXLmgRF6dgSktn9o_017731475651251.png"
  }'

Output

{
  "request_id": "meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Add the X-Webhook-URL header to your submit request to receive a POST callback when the job completes — no polling required.

Using curl? These are HTTP request headers — pass each with -H, e.g. -H "X-Webhook-URL: https://your-server.com/webhook/callback". Do not paste them as bare lines, and end every line of a multi-line command with \.

Webhook Headers

HeaderRequiredDefaultDescription
X-Webhook-URLYes (to enable)—HTTPS endpoint on your server that will receive the POST callback. Must respond 2xx within a few seconds (process async if needed).
X-Webhook-ModeNoterminalterminal — fires once at the final status (COMPLETED/FAILED/ERROR). sync — fires on every poll cycle plus the terminal event, and caps the queue’s polling delay at 15s for tighter progress updates.

Example: enable webhook

X-Webhook-URL: https://your-server.com/webhook/callback
X-Webhook-Mode: terminal

Callback Payload

Your endpoint receives a POST application/json with the same shape as the GET /v2/requests/status/{request_id} response. Example terminal callback (mode terminal):

{
  "request_id": "meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-6-i2-3d",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.glb"
    ],
    "media_type": "model/glb"
  },
  "created_at": "2026-05-22T13:17:32.110Z",
  "updated_at": "2026-05-22 13:19:23",
  "completed_at": "2026-05-22 13:19:23"
}

Failure callback shape

{
  "request_id": "meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-6-i2-3d",
  "error": "Description of the error",
  "output": null,
  "created_at": "...",
  "updated_at": "...",
  "completed_at": "..."
}

Delivery semantics

  • terminal mode (default) — exactly one POST when the request reaches a terminal status. No callback during PROCESSING.
  • sync mode — POST on every status poll (with delay capped at ~15s) plus a final POST at terminal status. Use when you want progress updates.
  • Idempotency — use request_id as your idempotency key. Network retries can deliver the same callback more than once; your handler must tolerate duplicates.
  • Response — respond 200 OK within a few seconds. The queue does not block on slow handlers, but persistent failures may stop further deliveries.
  • HTTPS required — plain http:// URLs are rejected.

Request Parameters - Meshy 6 i2-3d generate request

ParameterRequiredTypeDefaultAllowed values / range
image_urlYesrequiredstring——
URL of the input 2D image to convert into a 3D model. Supports .jpg, .jpeg and .png (also AVIF/HEIF); a base64 data URI is also accepted.
model_typeNoenum"standard"standard
Type of 3D mesh generation. Only "standard" is accepted: Meshy now offers Smart Topology as separate models (Meshy T2 and T2.5), which this API does not include.
topologyNoenum"triangle"quad, triangle
Mesh topology type. Quad for smooth surfaces, triangle for detailed geometry.
target_polycountNointeger30000100–300000
The desired number of polygons in the generated 3D model. Higher values give a more detailed, heavier mesh; lower values give a simpler, lighter one.
symmetry_modeNoenum"auto"off, auto, on
Symmetry enforcement mode. "off" disables symmetry, "auto" decides automatically, "on" enforces symmetry.
should_remeshNobooleantruetrue, false
Rebuilds the model's surface grid for cleaner geometry. When off, returns the raw, unoptimized triangular mesh.
should_textureNobooleantruetrue, false
Generates a texture map for the 3D model. When off, returns untextured geometry only.
enable_pbrNobooleanfalsetrue, false
Generates realistic surface materials (PBR: metallic, roughness, normal maps) in addition to the base colour, so the model reacts properly to light.
pose_modeNoenum""a-pose, t-pose, "" (empty)
Character pose for rigging. "a-pose" generates an A-pose, "t-pose" a T-pose; empty string for no specific pose.
texture_promptNostring—Max 600 characters
Additional text prompt used to guide the texturing process.
texture_image_urlNostring——
URL to a 2D image used to guide the texturing process.
enable_riggingNobooleanfalsetrue, false
Auto-rig the generated model as a humanoid character, including basic walking and running animations.
rigging_height_metersNofloat1.7—
Approximate height of the rigged character in meters. Only used when enable_rigging is true.
enable_animationNobooleanfalsetrue, false
Apply a predefined animation preset. Requires enable_rigging to be true.
animation_action_idNointeger920–696
Animation preset ID from Meshy's library. Only used when enable_animation is true. See https://docs.meshy.ai/en/api/animation-library.
enable_safety_checkerNobooleantruetrue, false
Turns on automatic filtering of unsafe or explicit (NSFW) content. Leave enabled unless you have a specific reason to disable it.

Minimum Request

{
  "image_url": "https://imagesai.appypie.com/7686410/ZU2sxXLmgRF6dgSktn9o_017731475651251.png"
}

Full Request (all options)

{
  "image_url": "https://imagesai.appypie.com/7686410/ZU2sxXLmgRF6dgSktn9o_017731475651251.png",
  "topology": "triangle",
  "target_polycount": 30000,
  "symmetry_mode": "auto",
  "should_remesh": true,
  "should_texture": true,
  "enable_safety_checker": true
}

Response

{
  "request_id": "meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

Header Value
Content-Type application/json
Cache-Control no-cache
Ocp-Apim-Subscription-Key Your API subscription key

Response Handling

Common status codes for Meshy 6 i2-3d generate request.

Code Meaning
202 Accepted — Request queued
Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
Too Many Requests
500 Internal Server Error

Error Responses

Queue system errors and model validation errors.

Queue System Errors

// 402 — Insufficient balance
{
  "error": "Insufficient Balance",
  "message": "Your wallet does not have enough balance."
}
// 400 — Model not found
{
  "error": "Model not found",
  "message": "Model 'meshy-6-i2-3d' not found or is disabled"
}

Error via Status/Webhook

{
  "request_id": "meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-6-i2-3d",
  "error": "Description of the error",
  "output": null
}

Retrieving Results

Poll the universal status endpoint to check progress and retrieve results.

Endpoint

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY

cURL Example

curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Response (Completed)

{
  "request_id": "meshy-6-i2-3d_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-6-i2-3d",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/meshy-6-i2-3d_019dxxxx-xxxx/output.ext"
    ],
    "media_type": "application/octet-stream"
  },
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}

Response Fields

FieldTypeDescription
request_idstringUnique request identifier
statusstringQUEUED, PROCESSING, COMPLETED, FAILED, or ERROR
model_idstringModel that processed the request
errorstring|nullError message if failed
output.media_urlarrayURLs to generated media (R2 CDN)
output.media_typestringMIME type of the output
created_atstringWhen request was created
completed_atstring|nullWhen request completed
polling_urlstringStatus URL (initial response only)

Status Values

StatusDescription
QUEUEDRequest accepted, waiting to be processed
PROCESSINGBeing processed by the model
COMPLETEDDone — output contains the result
FAILEDFailed — check error field
ERRORSystem error — not charged

Status Flow

QUEUED → PROCESSING → COMPLETED
                    → FAILED
                    → ERROR

Typical Workflow

  1. Send a generate request to the API endpoint
  2. Save the request_id from the response
  3. Poll every 5-10 seconds: GET /v2/requests/status/{request_id}
  4. When status is "COMPLETED", download from output.media_url

Tip: Use X-Webhook-URL header to get a callback instead of polling.

Meshy 6 API Pricing

Your request will cost $0.80 per generated 3D model.
Image to Image (3D Models — Retexture)

Meshy 6 API Documentation

Give an existing 3D model new textures with Meshy 6 Retexture: send the model in model_url (GLB, glTF, OBJ, FBX or STL) and describe the look in text_style_prompt, or send a picture of the style in image_style_url. Optionally choose a 4k base texture and PBR maps. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED, then download the 3D model from output.media_url.

POST https://gateway.pixazo.ai/meshy-6-retexture/v1/retexture

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Image to Image (3D Models — Retexture) - Meshy 6 Retexture

Request Code

POST https://gateway.pixazo.ai/meshy-6-retexture/v1/retexture
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "weathered bronze with a green patina"
}
import requests

url = "https://gateway.pixazo.ai/meshy-6-retexture/v1/retexture"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "weathered bronze with a green patina"
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-6-retexture/v1/retexture", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "weathered bronze with a green patina"
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-6-retexture/v1/retexture' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb", "text_style_prompt": "weathered bronze with a green patina"}'

Output

{
  "request_id": "meshy-6-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-6-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default, one callback on COMPLETED/ERROR) or sync (per-poll callbacks).

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/meshy-6-retexture/v1/retexture' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb", "text_style_prompt": "weathered bronze with a green patina"}'

Callback Payload (success)

{
  "request_id": "meshy-6-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-6-retexture",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-10-09T10:04:54.387Z",
  "completed_at": "2026-10-09 10:06:21"
}

Failure callback shape

{
  "request_id": "meshy-6-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-6-retexture",
  "error": "Description of the failure"
}

Delivery semantics

  • terminal mode: one Webhook callback when the request is COMPLETED or ERROR.
  • sync mode: a Webhook callback on every poll while the request is processing (status PROCESSING), plus the final COMPLETED/ERROR callback.
  • Callbacks are idempotent on request_id — de-duplicate on it.
  • Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
model_urlYesrequiredstring—A publicly reachable https URL (recommended) or a base64 data URI of a .glb, .gltf, .obj, .fbx or .stl model
The 3D model to retexture.
text_style_promptNostring—Text, up to 600 characters
The texture you want, for example weathered bronze with a green patina. Required unless you send image_style_url.
image_style_urlNostring—A publicly reachable https URL (recommended) or a data URI of a JPEG or PNG image
A picture of the style to apply. When you send both, image_style_url is used and text_style_prompt is ignored.
texture_resolutionNostring"2k"2k, 4k
The size of the base color texture: 2k (2048) or 4k (4096). It does not change the amount billed.
enable_original_uvNobooleantruetrue, false
Keep the model's own UV layout instead of generating a new one. If the model has no UV layout of its own, the result may be lower in quality.
enable_pbrNobooleanfalsetrue, false
Also generate PBR maps (metallic, roughness and normal) in addition to the base color. It does not change the amount billed.
enable_safety_checkerNobooleantruetrue, false
Check the inputs for unsafe content before processing.

Good to know

  • Each request returns one 3D model. batch_size, num_images, number_of_images, n and count are rejected — send one request per 3D model.
  • This API works on a single 3D model and has no length setting. duration, seconds, num_frames, frames_per_second and music_length_ms are rejected.
  • Send every field at the top level of the JSON body; parameters, content and text are rejected.
  • Send the 3D model as model_url: a publicly reachable https URL (recommended) or a base64 data URI, in GLB, glTF, OBJ, FBX or STL format. One model per request.
  • Describe the texture in text_style_prompt (up to 600 characters) or send a style picture as image_style_url: one of the two is required. When you send both, the picture is used.
  • input_task_id is not accepted: send the 3D model itself as model_url.
  • image_url and multiview_image_urls are rejected: send one style picture as image_style_url.
  • texture_resolution takes 2k (the default) or 4k; any other value is rejected.
  • Use the JSON types shown: model_url, text_style_prompt, image_style_url and texture_resolution are strings; the options are true or false (not "true").
  • Omit a field instead of sending null.
  • Results are always returned as a URL in output.media_url; sync_mode is accepted only as false.
  • Webhooks are set with the X-Webhook-URL / X-Webhook-Mode headers; webhook_url, webhook_mode and callback_url in the JSON body are rejected.
  • stream is not supported: the result is delivered when the job completes.
  • Options this API does not offer are rejected: prompt, model, ai_model, remove_lighting, target_formats, alpha_thumbnail and hd_texture.

Texture Style: Text or Picture

  • Describe the texture in text_style_prompt, up to 600 characters: the material, the colours and any wear.
  • Or send a picture of the style in image_style_url (JPEG or PNG). When you send both, the picture is used.
  • texture_resolution sets the size of the base color texture: 2k (2048, the default) or 4k (4096). With enable_pbr, metallic, roughness and normal maps are generated as well.
  • The result is one GLB file with the new textures embedded.

Example: use a picture as the style

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "image_style_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/images/input.jpg"
}

Example: a 4k base texture with PBR maps

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "glossy red ceramic with gold accents",
  "texture_resolution": "4k",
  "enable_pbr": true
}

Example Request

{
  "model_url": "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/doc-assets/models/meshy-retexture-input.glb",
  "text_style_prompt": "weathered bronze with a green patina"
}

Example Response

{
  "request_id": "meshy-6-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-6-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks (see Webhook section).
X-Webhook-ModeNoterminal (default) or sync (see Webhook section).

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Invalid request — a required field is missing, a value has the wrong type, is too long, out of range or not one of the allowed values, or a field this operation does not accept was sent. The message says what to fix.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance for the hold this request needs.
429Too many requests.
500Internal server error.

Parameter problems are caught when you submit and returned as a 400, before any hold is placed on your balance. Problems that need the model to run are reported through the status endpoint as status: "ERROR", with a message in error saying what went wrong. Failed requests are not billed — the hold is released in full.

ConditionHow it surfaces
Missing or invalid subscription keysynchronous 401
Balance too low for the holdsynchronous 402
Missing or empty model_url, model_url not a stringsynchronous 400
text_style_prompt not a string, or longer than 600 characterssynchronous 400
texture_resolution must be '2k' or '4k' (or left out for '2k'): the 8k texture is not available on this APIsynchronous 400
texture_resolution not one of the allowed values (written exactly as listed)synchronous 400
enable_original_uv or enable_pbr or enable_safety_checker not true or false — for example the string "true"synchronous 400
image_style_url not a stringsynchronous 400
sync_mode set to anything other than false (results are always returned as a URL in output.media_url)synchronous 400
image_url, multiview_image_urls (send one style picture as image_style_url)synchronous 400
input_task_id (send the 3D model itself as model_url)synchronous 400
batch_size, num_images, number_of_images, n, count (one 3D model per request)synchronous 400
duration, seconds, num_frames, frames_per_second, music_length_ms (this API works on a single 3D model)synchronous 400
parameters, content, text (send the fields at the top level of the JSON body)synchronous 400
webhook_url, webhook_mode, callback_url in the JSON body (use the X-Webhook-URL / X-Webhook-Mode headers)synchronous 400
stream (the result is delivered when the job completes)synchronous 400
prompt, model, ai_model, remove_lighting, target_formats, alpha_thumbnail, hd_texture (not accepted by this operation)synchronous 400
A model file that cannot be read, or one that is not a GLB, glTF, OBJ, FBX or STL modelstatus: "ERROR"
A style picture that cannot be read, or one larger than 20 MBstatus: "ERROR"
A request the model refuses, for example under its content policystatus: "ERROR"

Example error responses

A refused request returns error, a message that joins every problem found, and the same problems one by one in violations.

Missing model_url (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'model_url' is required",
  "violations": [
    "'model_url' is required"
  ]
}

Neither text_style_prompt nor image_style_url (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'text_style_prompt' is required unless 'image_style_url' is provided",
  "violations": [
    "'text_style_prompt' is required unless 'image_style_url' is provided"
  ]
}

A texture size that is not offered (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'texture_resolution' must be one of: \"2k\", \"4k\" (got \"8k\"); 'texture_resolution' must be '2k' or '4k' (or left out for '2k'): the 8k texture is not available on this API.",
  "violations": [
    "'texture_resolution' must be one of: \"2k\", \"4k\" (got \"8k\")",
    "'texture_resolution' must be '2k' or '4k' (or left out for '2k'): the 8k texture is not available on this API."
  ]
}

An earlier task referenced instead of a model (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'model_url' is required; 'input_task_id' must be one of:  (got \"0193a1b2-0000-7000-8000-000000000000\"); 'input_task_id' is not accepted. Send the 3D model itself as 'model_url' (a public URL or a base64 data URI).",
  "violations": [
    "'model_url' is required",
    "'input_task_id' must be one of:  (got \"0193a1b2-0000-7000-8000-000000000000\")",
    "'input_task_id' is not accepted. Send the 3D model itself as 'model_url' (a public URL or a base64 data URI)."
  ]
}

More than one model per request (synchronous 400)

{
  "error": "Invalid request parameters",
  "message": "'num_images' must be one of:  (got 2); 'num_images' is not supported: each request retextures one 3D model. Send one request per model.",
  "violations": [
    "'num_images' must be one of:  (got 2)",
    "'num_images' is not supported: each request retextures one 3D model. Send one request per model."
  ]
}

Retrieving Results

Poll the status endpoint with the request_id from the submit response until status is COMPLETED or ERROR, then download the 3D model from output.media_url. Treat any status other than QUEUED, PROCESSING or COMPLETED as a failure.

Endpoint

GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

cURL example

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-6-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "meshy-6-retexture_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-6-retexture",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-10-09T10:04:54.387Z",
  "completed_at": "2026-10-09 10:06:21"
}

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED or ERROR.
model_idstringThe model that handled the request — meshy-6-retexture for this endpoint.
output.media_urlarray of stringsURL of the 3D model (one GLB file per request).
output.media_typestringmodel/gltf-binary.
created_atstringRequest creation timestamp.
completed_atstringCompletion timestamp.
errorstringError message when status is ERROR.
polling_urlstringStatus URL for this request (submit response only).

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure).

Typical workflow

  1. Send the request to POST https://gateway.pixazo.ai/meshy-6-retexture/v1/retexture.
  2. Save the request_id from the 202 response.
  3. Poll GET /v2/requests/status/{request_id} every 10 seconds or so, or use a Webhook instead.
  4. When status is COMPLETED, download the 3D model from output.media_url.

How Billing Is Measured

Billing is measured per retextured model: each request is billed once, for one model. The texture size (2k or 4k), PBR maps, the prompt and the options do not change the amount. The amount is placed as a hold when the request is submitted and released in full if the request fails. The current rate is shown in the pricing panel on this page.

Meshy 6 API Pricing

Retexture an existing 3D model from a text prompt or a reference image, with a 2K or 4K base texture. PBR maps (metallic, roughness, normal) are included at no extra cost, embedded in the returned GLB.

Your request will cost $0.30 per retextured model.
5. Meshy 6 Lite

Meshy 6 Lite API Documentation

Apply new textures to an existing 3D model with Meshy 6 Lite, guided by a text prompt or a reference image. Returns a GLB. Asynchronous: submit returns a request_id; poll the status endpoint until the request is COMPLETED, then download the model from output.media_url. 3D generation typically takes a few minutes.

POST https://gateway.pixazo.ai/meshy-6-lite/v1/retexture

Authentication

All requests require an API key passed via header.

HeaderTypeRequiredDescription
Ocp-Apim-Subscription-KeystringYesYour API subscription key

Retexture - Meshy 6 Lite

Request Code

POST https://gateway.pixazo.ai/meshy-6-lite/v1/retexture
Content-Type: application/json
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "model_url": "https://v3b.fal.media/files/b/penguin/DId89qXLu6BXu09RFAwAV_model.glb",
  "text_style_prompt": "glossy blue ceramic with gold accents",
  "enable_pbr": true
}
import requests

url = "https://gateway.pixazo.ai/meshy-6-lite/v1/retexture"
headers = {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
  "model_url": "https://v3b.fal.media/files/b/penguin/DId89qXLu6BXu09RFAwAV_model.glb",
  "text_style_prompt": "glossy blue ceramic with gold accents",
  "enable_pbr": true
}

resp = requests.post(url, json=data, headers=headers)
print(resp.json())
const res = await fetch("https://gateway.pixazo.ai/meshy-6-lite/v1/retexture", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
  },
  body: JSON.stringify({
  "model_url": "https://v3b.fal.media/files/b/penguin/DId89qXLu6BXu09RFAwAV_model.glb",
  "text_style_prompt": "glossy blue ceramic with gold accents",
  "enable_pbr": true
})
});
console.log(await res.json());
curl -X POST 'https://gateway.pixazo.ai/meshy-6-lite/v1/retexture' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --data-raw '{"model_url": "https://v3b.fal.media/files/b/penguin/DId89qXLu6BXu09RFAwAV_model.glb", "text_style_prompt": "glossy blue ceramic with gold accents", "enable_pbr": true}'

Output

{
  "request_id": "meshy-6-lite_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-6-lite_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Webhook (Optional)

Instead of polling, you can receive a Webhook callback when the request reaches a terminal state. Provide a Webhook URL via header on the submit request.

HeaderRequiredDescription
X-Webhook-URLTo enableHTTPS URL to receive the Webhook callback.
X-Webhook-ModeNoterminal (default, one callback on COMPLETED/ERROR) or sync (per-poll callbacks).

Example: enable Webhook

curl -X POST 'https://gateway.pixazo.ai/meshy-6-lite/v1/retexture' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  -H 'X-Webhook-URL: https://your-server.com/webhook' \
  --data-raw '{"model_url": "https://v3b.fal.media/files/b/penguin/DId89qXLu6BXu09RFAwAV_model.glb", "text_style_prompt": "glossy blue ceramic with gold accents", "enable_pbr": true}'

Callback Payload (success)

{
  "request_id": "meshy-6-lite_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-6-lite",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-09-22T11:56:21.804Z",
  "completed_at": "2026-09-22T12:01:44.210Z"
}

Failure callback shape

{
  "request_id": "meshy-6-lite_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "meshy-6-lite",
  "error": "Description of the failure"
}

Delivery semantics

  • terminal mode: one Webhook callback when the request is COMPLETED or ERROR.
  • sync mode: a Webhook callback on each status change.
  • Callbacks are idempotent on request_id — de-duplicate on it.
  • Respond 200 within a few seconds; the Webhook endpoint must be HTTPS.

Request Parameters

ParameterRequiredTypeDefaultAllowed values / range
model_urlYesrequiredstring—https URL or base64 data URI · .glb, .gltf, .obj, .fbx, .stl
The 3D model to retexture. Must be publicly reachable (or a base64 data URI with MIME type application/octet-stream); the gateway fetches it before the job runs.
text_style_promptYes, unless image_style_url is setstring—up to 600 characters
Describe the texture style you want. Required when image_style_url is not provided.
image_style_urlNostring—https URL · .jpg, .jpeg, .png, up to 20 MB
A 2D image that guides the texturing. If both are sent, image_style_url takes precedence over text_style_prompt.
enable_original_uvNobooleantruetrue, false
Keep the model's original UV mapping instead of generating new UVs. If the model has no UVs, quality may be lower.
enable_pbrNobooleanfalsetrue, false
Also generate PBR maps (metallic, roughness, normal) in addition to base color. They are embedded in the returned GLB, at no extra cost.
enable_safety_checkerNobooleantruetrue, false
Check the input for safety before processing.

Good to know

  • Exactly one retextured model is returned per request. There is no batch option: num_images, n, count, batch_size and number_of_images are rejected.
  • Send text_style_prompt, image_style_url, or both — when both are sent, the image wins.
  • Accepted model formats: .glb, .gltf, .obj, .fbx, .stl. A .gltf that points to separate .bin or texture files cannot be fetched from one URL — send a .glb, or a .gltf with its data embedded.
  • The result is one GLB file. With enable_pbr: true, the metallic, roughness and normal maps are embedded in that GLB; no separate texture files are returned.
  • The cost is the same with or without PBR maps; the current rate is in the pricing panel on this page.

Example Request

{
  "model_url": "https://v3b.fal.media/files/b/penguin/DId89qXLu6BXu09RFAwAV_model.glb",
  "text_style_prompt": "glossy blue ceramic with gold accents",
  "enable_pbr": true
}

Example Response

{
  "request_id": "meshy-6-lite_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/meshy-6-lite_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
Ocp-Apim-Subscription-KeyYesYour API subscription key.
X-Webhook-URLNoEnable Webhook callbacks (see Webhook section).

Response Handling

Status CodeMeaning
202Accepted — request queued; returns request_id and polling_url.
400Bad request — model_url missing, neither text_style_prompt nor image_style_url sent, a prompt over 600 characters, or a batch option such as num_images. Anything checkable from the request body alone.
401Unauthorized — missing or invalid subscription key.
402Insufficient balance.
429Too many requests.
500Internal server error.

Only what can be judged from the request body itself is rejected synchronously. Everything that needs an input to be fetched or the model to run is reported through the status endpoint instead, as status: "ERROR". Failed requests are not billed — the hold is released in full.

ConditionHow it surfaces
model_url missing, or not a stringsynchronous 400
neither text_style_prompt nor image_style_url sentsynchronous 400
text_style_prompt longer than 600 characterssynchronous 400
num_images, n, count, batch_size or number_of_images sentsynchronous 400
model_url unreachable, or not a supported model formatstatus: "ERROR" on the status endpoint (not billed)

Retrieving Results

Poll the status endpoint with the request_id from the submit response until status is COMPLETED (or FAILED/ERROR), then download the model from output.media_url. 3D generation typically takes a few minutes, so poll every 10–15 seconds rather than continuously.

curl 'https://gateway.pixazo.ai/v2/requests/status/meshy-6-lite_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY'

Completed response

{
  "request_id": "meshy-6-lite_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "meshy-6-lite",
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/{request_id}/output.glb"
    ],
    "media_type": "model/gltf-binary"
  },
  "created_at": "2026-09-22T11:56:21.804Z",
  "completed_at": "2026-09-22T12:01:44.210Z"
}

Meshy also produces OBJ, FBX and USDZ variants, a preview thumbnail and separate texture files. This API returns the GLB only — it is the single self-contained file that carries mesh, materials and textures together, and it is what the console preview renders.

Response Fields

FieldTypeDescription
request_idstringUnique request identifier.
statusstringQUEUED, PROCESSING, COMPLETED, FAILED, or ERROR.
model_idstringThe model that handled the request.
output.media_urlarrayURL of the retextured 3D model (GLB).
output.media_typestringmodel/gltf-binary.
created_atstringRequest creation timestamp.
completed_atstringCompletion timestamp.
errorstringError message when status is FAILED/ERROR.

Status Values & Flow

QUEUED → PROCESSING → COMPLETED (success) or FAILED/ERROR (failure).

How billing is measured

Billing is per retextured model, and every request returns exactly one, so the amount held when the request is submitted is the amount charged on completion. The price is the same with or without PBR maps, and does not depend on the model's size or file format. If the request fails, the hold is released in full.

Meshy 6 Lite API Pricing

Retexture an existing 3D model from a text prompt or a reference image. PBR maps (metallic, roughness, normal) are included at no extra cost, embedded in the returned GLB.

Your request will cost $0.30 per retextured model.

⚡ Performance

Live usage measured on Pixazo's gateway, split by model version. Generation time is how long a generation takes end-to-end (lower is better). Success rate is the percent of generations that complete (higher is better).

Show data for the last
Generations
3,400last 30d
~113 per day
Success rate
85.3%
of completed generations
Generation time
3.8minavg
p95 6.4min
Requests
Oct 21max 1,800Nov 19
Meshy 7.1Avg 80/day
Meshy RiggingAvg 27/day
Meshy 7Avg 3/day
Meshy 6Avg 3/day
Generation Time
Oct 21max 17.2minNov 19
Meshy 7.1Avg 4.2min
Meshy RiggingAvg 98.7s
Meshy 7Avg —
Meshy 6Avg —
Error Rate
Oct 21max 100.0%Nov 19
Meshy 7.1Avg 8.3%
Meshy RiggingAvg 37.5%
Meshy 7Avg —
Meshy 6Avg —

〰 Uptime

Percent of generations that succeeded over the selected period, per model version.

Avg. Success Rate (30d)
85.29%
across all generations of this model family
Uptime
Oct 21max 100%Nov 19
Meshy 7.1Avg 91.67%
Meshy RiggingAvg 62.50%
Meshy 7Avg —
Meshy 6Avg —