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.

Models Version
Get 10% Cashback on Your First Payment (up to $500)
Add funds and get 10% cashback on your first payment (up to $500).
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/rigAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
model_url | Yesrequired | string | — | 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_meters | No | number | 1.7 | Greater than 0 |
| The character's approximate height in meters; it scales the skeleton. | ||||
skeleton_template | No | string | meshyrig | mixamo, 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_fingers | No | boolean | false | true, false |
| Also rig the fingers. | ||||
enable_animation | No | boolean | false | true, false |
Also apply one preset (animation_action_id) and return it as animation_glb and animation_fbx. | ||||
animation_action_id | No | integer | 92 | 0 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_checker | No | boolean | true | true |
| 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.
| Parameter | Why | Use instead |
|---|---|---|
model_url missing | The character is required. | A public URL of its GLB file |
image_url, image_urls, images, image | Rigging works on a 3D model, not a picture. | model_url |
prompt | Rigging works from the 3D model alone; there is no text prompt. | — |
animation_action_ids | This 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 696 | Not a preset id. | An id from the animation library |
skeleton_template not in the list | Only the nine layouts above. | One of the listed values |
height_meters of 0 or less | A height must be positive. | — |
enable_rigging | This endpoint always rigs. | — |
rigging_height_meters | That is Meshy 7's name for it. | height_meters |
output_format | Every file is returned as both GLB and FBX. | — |
num_images, number_of_images, batch_size, n, count | One character per request. | One request per character |
model | This endpoint always runs Meshy Rigging. | — |
input, parameters | Not accepted by this endpoint. | Send the parameters at the top level of the JSON body |
webhook_url, callback_url | Webhooks are set by header. | X-Webhook-URL header |
enable_safety_checker set to false | The safety check cannot be turned off. | — |
model_url that cannot be downloaded | The 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.
| Parameter | When the request fails |
|---|---|
model_url | The file downloads but is not a 3D model, for example a web page or a text file. |
model_url | The model is not a humanoid character, for example an animal or an object, so it cannot be rigged. |
skeleton_template, include_fingers | Some characters can only be rigged with meshyrig and without fingers; other settings then fail. |
model_url | The 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 output | File | Size (measured at launch) |
|---|---|---|
rigged_character_glb | The rigged character, GLB (also media_url[0]) | 4.9 MB |
rigged_character_fbx | The rigged character, FBX | 4.3 MB |
animation_glb | The preset clip, GLB (only with enable_animation) | 5.0 MB |
animation_fbx | The preset clip, FBX (only with enable_animation) | 4.4 MB |
basic_animations.walking_glb | Walking clip, GLB | 4.9 MB |
basic_animations.walking_fbx | Walking clip, FBX | 4.3 MB |
basic_animations.running_glb | Running clip, GLB | 4.9 MB |
basic_animations.running_fbx | Running clip, FBX | 4.3 MB |
basic_animations.walking_armature_glb | Walking clip, skeleton only (no character mesh or textures), GLB | 90 KB |
basic_animations.running_armature_glb | Running clip, skeleton only (no character mesh or textures), GLB | 79 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
| Item | Guidance |
|---|---|
| Character | One humanoid character: a head, two arms and two legs, clearly separated. Animals, objects and scenes cannot be rigged. |
| Pose | An A-pose or a T-pose, facing forward, gives the cleanest rig. |
| File | GLB (binary glTF) up to 50 MB. Convert other formats (OBJ, FBX, glTF with separate files) to GLB first. |
| Source | Any 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. |
| Skeleton | Pick 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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks (see Webhook section). |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Bad request — the body failed the submit check (see Request Parameters) and was not queued. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance. |
| 403 | Forbidden. |
| 429 | Too many requests. |
| 500 | Internal 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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED or ERROR. |
| model_id | string | The model that handled the request. |
| error | string or null | Error message when status is ERROR; otherwise null. |
| output.media_url | array of strings | The rigged character as GLB (one URL). |
| output.media_type | string | model/gltf-binary. |
| output.rigged_character_glb | string | The rigged character, GLB (the same file as media_url[0]). |
| output.rigged_character_fbx | string | The rigged character, FBX. |
| output.animation_glb | string | The preset clip, GLB. Only with enable_animation. |
| output.animation_fbx | string | The preset clip, FBX. Only with enable_animation. |
| output.basic_animations | object | Walking and running clips: walking_glb, walking_fbx, running_glb, running_fbx, walking_armature_glb, running_armature_glb. |
| created_at | string | Request creation timestamp. |
| updated_at | string | Last status change timestamp. |
| completed_at | string | Completion timestamp. |
| polling_url | string | Status 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.
| Option | Price (USD) |
|---|---|
| Rig (default) | $0.21 |
| Rig + one preset animation | $0.336 |
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/rigAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
model_url | Yesrequired | string | — | 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_meters | No | number | 1.7 | Greater than 0 |
| The character's approximate height in meters; it scales the skeleton. | ||||
skeleton_template | No | string | meshyrig | mixamo, 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_fingers | No | boolean | false | true, false |
| Also rig the fingers. | ||||
animation_action_ids | Yesrequired | array 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_checker | No | boolean | true | true |
| 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.
| Parameter | Why | Use instead |
|---|---|---|
model_url missing | The character is required. | A public URL of its GLB file |
image_url, image_urls, images, image | Rigging works on a 3D model, not a picture. | model_url |
prompt | Rigging works from the 3D model alone; there is no text prompt. | — |
animation_action_id | This endpoint takes a list. | animation_action_ids |
enable_animation | Every id in the list becomes a clip. | — |
animation_action_ids empty, missing or with more than 10 ids | 1 to 10 ids per request. | Split longer lists over several requests |
skeleton_template not in the list | Only the nine layouts above. | One of the listed values |
height_meters of 0 or less | A height must be positive. | — |
enable_rigging | This endpoint always rigs. | — |
rigging_height_meters | That is Meshy 7's name for it. | height_meters |
output_format | Every file is returned as both GLB and FBX. | — |
num_images, number_of_images, batch_size, n, count | One character per request. | One request per character |
model | This endpoint always runs Meshy Rigging Multi-Animation. | — |
input, parameters | Not accepted by this endpoint. | Send the parameters at the top level of the JSON body |
webhook_url, callback_url | Webhooks are set by header. | X-Webhook-URL header |
enable_safety_checker set to false | The safety check cannot be turned off. | — |
model_url that cannot be downloaded | The 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.
| Parameter | When the request fails |
|---|---|
model_url | The file downloads but is not a 3D model, for example a web page or a text file. |
model_url | The model is not a humanoid character, for example an animal or an object, so it cannot be rigged. |
skeleton_template, include_fingers | Some characters can only be rigged with meshyrig and without fingers; other settings then fail. |
animation_action_ids | An id is outside 0 to 696. |
model_url | The 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 output | File | Size (measured at launch) |
|---|---|---|
rigged_character_glb | The rigged character, GLB (also media_url[0]) | 4.9 MB |
rigged_character_fbx | The rigged character, FBX | 4.3 MB |
animations[0].animation_glb | Clip 1, 30 (Casual Walk), GLB | 5.0 MB |
animations[0].animation_fbx | Clip 1, 30 (Casual Walk), FBX | 4.4 MB |
animations[1].animation_glb | Clip 2, 92 (Double Combo Attack), GLB | 5.0 MB |
animations[1].animation_fbx | Clip 2, 92 (Double Combo Attack), FBX | 4.4 MB |
basic_animations.walking_glb | Walking clip, GLB | 4.9 MB |
basic_animations.walking_fbx | Walking clip, FBX | 4.3 MB |
basic_animations.running_glb | Running clip, GLB | 4.9 MB |
basic_animations.running_fbx | Running clip, FBX | 4.3 MB |
basic_animations.walking_armature_glb | Walking clip, skeleton only (no character mesh or textures), GLB | 89 KB |
basic_animations.running_armature_glb | Running clip, skeleton only (no character mesh or textures), GLB | 79 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
| Item | Guidance |
|---|---|
| Character | One humanoid character: a head, two arms and two legs, clearly separated. Animals, objects and scenes cannot be rigged. |
| Pose | An A-pose or a T-pose, facing forward, gives the cleanest rig. |
| File | GLB (binary glTF) up to 50 MB. Convert other formats (OBJ, FBX, glTF with separate files) to GLB first. |
| Source | Any 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. |
| Skeleton | Pick 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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks (see Webhook section). |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Bad request — the body failed the submit check (see Request Parameters) and was not queued. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance. |
| 403 | Forbidden. |
| 429 | Too many requests. |
| 500 | Internal 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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED or ERROR. |
| model_id | string | The model that handled the request. |
| error | string or null | Error message when status is ERROR; otherwise null. |
| output.media_url | array of strings | The rigged character as GLB (one URL). |
| output.media_type | string | model/gltf-binary. |
| output.rigged_character_glb | string | The rigged character, GLB (the same file as media_url[0]). |
| output.rigged_character_fbx | string | The rigged character, FBX. |
| output.animations | array of objects | One entry per clip, in the order of animation_action_ids: action_id, animation_glb and animation_fbx. |
| output.basic_animations | object | Walking and running clips: walking_glb, walking_fbx, running_glb, running_fbx, walking_armature_glb, running_armature_glb. |
| created_at | string | Request creation timestamp. |
| updated_at | string | Last status change timestamp. |
| completed_at | string | Completion timestamp. |
| polling_url | string | Status 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 clips | Price (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 |
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-3dAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
200within a few seconds; the Webhook endpoint must be HTTPS.
Request Parameters
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
prompt | Yesrequired | string | — | 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. | ||||
mode | No | string | full | preview, 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_type | No | string | standard | standard |
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_expansion | No | boolean | false | true, false |
| Let Meshy expand a short prompt into a fuller description before generating. | ||||
seed | No | integer | — | any integer |
| Same inputs and seed usually reproduce the same model. | ||||
topology | No | string | triangle | quad, triangle |
| Quad for smooth surfaces, triangle for detailed geometry. | ||||
target_polycount | No | integer | 30000 | 100–300000 |
| Target polygon count of the remeshed model. | ||||
should_remesh | No | boolean | true | true, false |
When false, returns the raw triangular mesh without the remeshing pass. | ||||
symmetry_mode | No | string | auto | off, auto, on |
| Force symmetry on or off, or let Meshy decide. | ||||
pose_mode | No | string | — (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_prompt | No | string | — | up to 600 characters |
| Text guidance for the texturing pass. Only used on a textured request. | ||||
texture_image_url | No | string | — | https URL, up to 20 MB |
| A 2D image that guides the texturing pass. Only used on a textured request. | ||||
enable_safety_checker | No | boolean | true | true, 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_sizeandnumber_of_imagesare rejected. should_texture,image_urlandimage_urlsbelong to the other operations and are rejected here.- Auto-rigging and animation (
enable_rigging,enable_animation) are not available on this API, andgeometry_resolutionis fixed atstandard. - 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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks (see Webhook section). |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Bad 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. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance. |
| 429 | Too many requests. |
| 500 | Internal 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.
| Condition | How it surfaces |
|---|---|
prompt missing, or longer than 600 characters | synchronous 400 |
should_texture, image_url or image_urls sent to this operation | synchronous 400 |
enable_rigging, enable_animation, or a geometry_resolution or model_type other than standard | synchronous 400 |
| A prompt the safety checker rejects | status: "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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR. |
| model_id | string | The model that handled the request. |
| output.media_url | array | URL of the generated 3D model (GLB). |
| output.media_type | string | model/gltf-binary. |
| created_at | string | Request creation timestamp. |
| completed_at | string | Completion timestamp. |
| error | string | Error 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.
| Option | Price (USD) |
|---|---|
| Textured (default) | $1.26 |
| No texture | $0.84 |
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-3dAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
200within a few seconds; the Webhook endpoint must be HTTPS.
Request Parameters
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
image_url | Yesrequired | string | — | 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_texture | No | boolean | true | true, 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_type | No | string | standard | standard |
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. | ||||
seed | No | integer | — | any integer |
| Same inputs and seed usually reproduce the same model. | ||||
topology | No | string | triangle | quad, triangle |
| Quad for smooth surfaces, triangle for detailed geometry. | ||||
target_polycount | No | integer | 30000 | 100–300000 |
| Target polygon count of the remeshed model. | ||||
should_remesh | No | boolean | true | true, false |
When false, returns the raw triangular mesh without the remeshing pass. | ||||
symmetry_mode | No | string | auto | off, auto, on |
| Force symmetry on or off, or let Meshy decide. | ||||
pose_mode | No | string | — (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_prompt | No | string | — | up to 600 characters |
| Text guidance for the texturing pass. Only used on a textured request. | ||||
texture_image_url | No | string | — | https URL, up to 20 MB |
| A 2D image that guides the texturing pass. Only used on a textured request. | ||||
enable_safety_checker | No | boolean | true | true, 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_sizeandnumber_of_imagesare rejected. mode,promptandimage_urlsbelong to the other operations and are rejected here.- Auto-rigging and animation (
enable_rigging,enable_animation) are not available on this API, andgeometry_resolutionis fixed atstandard. - 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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks (see Webhook section). |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Bad 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. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance. |
| 429 | Too many requests. |
| 500 | Internal 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.
| Condition | How it surfaces |
|---|---|
image_url missing, or not a string | synchronous 400 |
mode, prompt or image_urls sent to this operation | synchronous 400 |
enable_rigging, enable_animation, or a geometry_resolution or model_type other than standard | synchronous 400 |
| An image URL that is not https, not reachable, or not an image | status: "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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR. |
| model_id | string | The model that handled the request. |
| output.media_url | array | URL of the generated 3D model (GLB). |
| output.media_type | string | model/gltf-binary. |
| created_at | string | Request creation timestamp. |
| completed_at | string | Completion timestamp. |
| error | string | Error 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.
| Option | Price (USD) |
|---|---|
| Textured (default) | $1.26 |
| No texture | $0.84 |
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-3dAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
200within a few seconds; the Webhook endpoint must be HTTPS.
Request Parameters
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
image_urls | Yesrequired | array 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_texture | No | boolean | true | true, 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. | ||||
topology | No | string | triangle | quad, triangle |
| Quad for smooth surfaces, triangle for detailed geometry. | ||||
target_polycount | No | integer | 30000 | 100–300000 |
| Target polygon count of the remeshed model. | ||||
should_remesh | No | boolean | true | true, false |
When false, returns the raw triangular mesh without the remeshing pass. | ||||
symmetry_mode | No | string | auto | off, auto, on |
| Force symmetry on or off, or let Meshy decide. | ||||
pose_mode | No | string | — (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_prompt | No | string | — | up to 600 characters |
| Text guidance for the texturing pass. Only used on a textured request. | ||||
texture_image_url | No | string | — | https URL, up to 20 MB |
| A 2D image that guides the texturing pass. Only used on a textured request. | ||||
enable_safety_checker | No | boolean | true | true, 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_sizeandnumber_of_imagesare rejected. mode,prompt,image_url,model_typeandseedare not available on this operation and are rejected.- Auto-rigging and animation (
enable_rigging,enable_animation) are not available on this API, andgeometry_resolutionis fixed atstandard. - 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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks (see Webhook section). |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Bad 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. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance. |
| 429 | Too many requests. |
| 500 | Internal 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.
| Condition | How it surfaces |
|---|---|
image_urls missing, empty, or more than 4 entries | synchronous 400 |
mode, prompt, image_url, model_type or seed sent to this operation | synchronous 400 |
enable_rigging, enable_animation, or geometry_resolution other than standard | synchronous 400 |
| An image URL that is not https, not reachable, or not an image | status: "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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR. |
| model_id | string | The model that handled the request. |
| output.media_url | array | URL of the generated 3D model (GLB). |
| output.media_type | string | model/gltf-binary. |
| created_at | string | Request creation timestamp. |
| completed_at | string | Completion timestamp. |
| error | string | Error 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.
| Option | Price (USD) |
|---|---|
| Textured (default) | $1.26 |
| No texture | $0.84 |
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-3dAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
image_url | Yesrequired | string | — | Image URL or base64 data URI |
Source image for the 3D model. Accepts .jpg, .jpeg and .png; AVIF and HEIF are converted automatically. | ||||
model_type | No | string | standard | standard |
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. | ||||
topology | No | string | triangle | quad, triangle |
Mesh topology. quad suits smooth surfaces, triangle detailed geometry. Ignored when should_remesh is false. | ||||
target_polycount | No | integer | 30000 | 100–300000 |
Target polygon count of the generated mesh. Ignored when should_remesh is false. | ||||
symmetry_mode | No | string | auto | off, auto, on |
Symmetry behaviour. off disables it, auto decides per object, on enforces it. | ||||
should_remesh | No | boolean | true | true, false |
Run the remesh phase. When false the raw triangular mesh is returned and both topology and target_polycount are ignored. | ||||
should_texture | No | boolean | true | true, false |
Generate textures. Affects the price — see Pricing. Setting false returns an untextured mesh and costs less. | ||||
enable_pbr | No | boolean | false | true, false |
Also generate PBR maps (metallic, roughness, normal) alongside base colour. Requires should_texture. Does not affect the price. | ||||
pose_mode | No | string | "" | a-pose, t-pose, "" |
| Force the generated character into an A-pose or T-pose. Empty string applies no specific pose. | ||||
is_a_t_pose | No | boolean | false | true, false |
Deprecated — use pose_mode instead. Treats the input as already in T-pose. | ||||
texture_prompt | No | string | — | Up to 600 characters |
Text prompt steering the texturing pass. Requires should_texture. Longer values are rejected with 400. | ||||
texture_image_url | No | string | — | Image URL |
2D image steering the texturing pass. Requires should_texture. | ||||
enable_rigging | No | boolean | false | true, 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_meters | No | number | 1.7 | 0.1–10 metres |
Approximate character height. Only read when enable_rigging is true. | ||||
enable_animation | No | boolean | false | true, 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_id | No | integer | 92 | 0–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_checker | No | boolean | true | true, false |
| Safety-check the input images before processing. | ||||
ultra_mode | No | boolean | false | true, 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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks. |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Bad request — a missing or out-of-range parameter. The message names the field. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance. |
| 422 | Unprocessable entity — the provider rejected a value, e.g. an animation_action_id outside 0–696. |
| 429 | Too many requests. |
| 500 | Internal 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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED or ERROR. |
| model_id | string | The model that handled the request. |
| output.media_url | array | One URL, pointing at the generated .glb model. |
| output.media_type | string | model/gltf-binary. |
| created_at | string | Request creation timestamp. |
| completed_at | string | Completion timestamp. |
| error | string | Error 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.
| Options | Result | Price |
|---|---|---|
should_texture: false | Untextured mesh | $0.80 |
| default | Textured model | $1.20 |
ultra_mode: true | Ultra-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.
| Option | Price (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 |
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-3dAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
image_urls | Yesrequired | array 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. | ||||
topology | No | string | triangle | quad, triangle |
Mesh topology. quad suits smooth surfaces, triangle detailed geometry. Ignored when should_remesh is false. | ||||
target_polycount | No | integer | 30000 | 100–300000 |
Target polygon count of the generated mesh. Ignored when should_remesh is false. | ||||
symmetry_mode | No | string | auto | off, auto, on |
Symmetry behaviour. off disables it, auto decides per object, on enforces it. | ||||
should_remesh | No | boolean | true | true, false |
Run the remesh phase. When false the raw triangular mesh is returned and both topology and target_polycount are ignored. | ||||
should_texture | No | boolean | true | true, 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_pbr | No | boolean | false | true, false |
Also generate PBR maps (metallic, roughness, normal) alongside base colour. Requires should_texture. Does not affect the price. | ||||
pose_mode | No | string | "" | a-pose, t-pose, "" |
| Force the generated character into an A-pose or T-pose. Empty string applies no specific pose. | ||||
is_a_t_pose | No | boolean | false | true, false |
Deprecated — use pose_mode instead. Treats the input as already in T-pose. | ||||
texture_prompt | No | string | — | Up to 600 characters |
Text prompt steering the texturing pass. Requires should_texture. Longer values are rejected with 400. | ||||
texture_image_url | No | string | — | Image URL |
2D image steering the texturing pass. Requires should_texture. | ||||
enable_rigging | No | boolean | false | true, 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_meters | No | number | 1.7 | 0.1–10 metres |
Approximate character height. Only read when enable_rigging is true. | ||||
enable_animation | No | boolean | false | true, 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_id | No | integer | 92 | 0–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_checker | No | boolean | true | true, false |
| Safety-check the input images before processing. | ||||
ultra_mode | No | boolean | false | true, 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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks. |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Bad request — a missing or out-of-range parameter. The message names the field. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance. |
| 422 | Unprocessable entity — the provider rejected a value, e.g. an animation_action_id outside 0–696. |
| 429 | Too many requests. |
| 500 | Internal 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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED or ERROR. |
| model_id | string | The model that handled the request. |
| output.media_url | array | One URL, pointing at the generated .glb model. |
| output.media_type | string | model/gltf-binary. |
| created_at | string | Request creation timestamp. |
| completed_at | string | Completion timestamp. |
| error | string | Error 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.
| Options | Result | Price |
|---|---|---|
| default | Textured model | $1.20 |
should_texture: false | Untextured mesh — billed at the textured rate | $1.20 |
ultra_mode: true | Ultra-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.
| Option | Price (USD) |
|---|---|
| Textured (default) | $1.20 |
| Ultra mode | $1.40 |
| Auto-rigging add-on (additional) | $0.20 |
| Animation add-on (additional) | $0.12 |
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/retextureAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
200within a few seconds; the Webhook endpoint must be HTTPS.
Request Parameters
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
model_url | Yesrequired | string | — | 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_prompt | No | string | — | 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_url | No | string | — | 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_resolution | No | string | "2k" | 2k, 4k |
The size of the base color texture: 2k (2048) or 4k (4096). It does not change the amount billed. | ||||
enable_original_uv | No | boolean | true | true, 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_pbr | No | boolean | false | true, false |
| Also generate PBR maps (metallic, roughness and normal) in addition to the base color. It does not change the amount billed. | ||||
enable_safety_checker | No | boolean | true | true, 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,nandcountare 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_secondandmusic_length_msare rejected. - Send every field at the top level of the JSON body;
parameters,contentandtextare rejected. - Send the 3D model as
model_url: a publicly reachablehttpsURL (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 asimage_style_url: one of the two is required. When you send both, the picture is used. input_task_idis not accepted: send the 3D model itself asmodel_url.image_urlandmultiview_image_urlsare rejected: send one style picture asimage_style_url.texture_resolutiontakes2k(the default) or4k; any other value is rejected.- Use the JSON types shown:
model_url,text_style_prompt,image_style_urlandtexture_resolutionare strings; the options aretrueorfalse(not"true"). - Omit a field instead of sending
null. - Results are always returned as a URL in
output.media_url;sync_modeis accepted only asfalse. - Webhooks are set with the
X-Webhook-URL/X-Webhook-Modeheaders;webhook_url,webhook_modeandcallback_urlin the JSON body are rejected. streamis 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_thumbnailandhd_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_resolutionsets the size of the base color texture:2k(2048, the default) or4k(4096). Withenable_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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks (see Webhook section). |
| X-Webhook-Mode | No | terminal (default) or sync (see Webhook section). |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Invalid 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. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance for the hold this request needs. |
| 429 | Too many requests. |
| 500 | Internal 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.
| Condition | How it surfaces |
|---|---|
| Missing or invalid subscription key | synchronous 401 |
| Balance too low for the hold | synchronous 402 |
Missing or empty model_url, model_url not a string | synchronous 400 |
text_style_prompt not a string, or longer than 600 characters | synchronous 400 |
texture_resolution must be '2k' or '4k' (or left out for '2k'): the 8k texture is not available on this API | synchronous 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 string | synchronous 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 model | status: "ERROR" |
| A style picture that cannot be read, or one larger than 20 MB | status: "ERROR" |
| A request the model refuses, for example under its content policy | status: "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_KEYcURL 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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED or ERROR. |
| model_id | string | The model that handled the request — meshy-7-retexture for this endpoint. |
| output.media_url | array of strings | URL of the 3D model (one GLB file per request). |
| output.media_type | string | model/gltf-binary. |
| created_at | string | Request creation timestamp. |
| completed_at | string | Completion timestamp. |
| error | string | Error message when status is ERROR. |
| polling_url | string | Status URL for this request (submit response only). |
Status Values & Flow
QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure).
Typical workflow
- Send the request to
POST https://gateway.pixazo.ai/meshy-7-retexture/v1/retexture. - Save the
request_idfrom the202response. - Poll
GET /v2/requests/status/{request_id}every 10 seconds or so, or use a Webhook instead. - When
statusisCOMPLETED, download the 3D model fromoutput.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.
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
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
prompt | Yesrequired | string | — | Max 600 characters |
| Description of the 3D object. Maximum 600 characters. | ||||
mode | No | enum | "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). | ||||
seed | No | integer | — | — |
| 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_type | No | enum | "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. | ||||
topology | No | enum | "triangle" | quad, triangle |
| Mesh topology type. Quad for smooth surfaces, triangle for detailed geometry. | ||||
target_polycount | No | integer | 30000 | 100–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_remesh | No | boolean | true | true, false |
| Rebuilds the model's surface grid for cleaner geometry. When off, returns the raw, unoptimized triangular mesh. | ||||
symmetry_mode | No | enum | "auto" | off, auto, on |
| Symmetry enforcement mode. "off" disables symmetry, "auto" decides automatically, "on" enforces symmetry. | ||||
enable_pbr | No | boolean | false | true, false |
| Generates realistic surface materials (PBR: metallic, roughness, normal maps) so the model reacts properly to light. Only available in full mode. | ||||
pose_mode | No | enum | "" | 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_expansion | No | boolean | false | true, false |
| Automatically rewrites and enriches your prompt with extra detail before generation to improve results. | ||||
texture_prompt | No | string | — | Max 600 characters |
| Additional prompt to guide texturing. Only used in full mode. | ||||
texture_image_url | No | string | — | — |
| URL to a 2D image used to guide texturing. Only used in full mode. | ||||
enable_rigging | No | boolean | false | true, false |
| Auto-rig the generated model as a humanoid character, including basic walking and running animations. | ||||
rigging_height_meters | No | float | 1.7 | — |
| Approximate height of the rigged character in meters. Only used when enable_rigging is true. | ||||
enable_animation | No | boolean | false | true, false |
| Apply a predefined animation preset. Requires enable_rigging to be true. | ||||
animation_action_id | No | integer | 92 | 0–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_checker | No | boolean | true | true, 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
| Type | Max | Format / Size | Description |
|---|---|---|---|
| image | 1 | JPG, PNG, WEBP | Optional 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_id | string | Unique identifier to track the job status |
| status | string | Current status of the job (QUEUED, PROCESSING, COMPLETED, FAILED, ERROR) |
| polling_url | string | URL to use for checking the status of the generated model |
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 (Text to 3D) generate request.
| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 429 | 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 |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
Submitted → QUEUED → PROCESSING → COMPLETED/FAILED/ERROR
Typical Workflow
- Submit request to /meshy-6-text-to-3d-request
- Receive request_id in response
- Poll /v2/requests/status/{request_id} every 2-3 seconds
- When status=COMPLETED, use model_glb and other URLs from response
- 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
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
request_id | Yesrequired | string | — | — |
| 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_id | string | Unique identifier of the request |
| status | string | Current status of the job (QUEUED, PROCESSING, COMPLETED, FAILED, ERROR) |
| model_id | string | ID of the model used for generation |
| error | null|string | Error description if status is FAILED, otherwise null |
| output.model_glb | string | URL to the GLB model file |
| output.thumbnail | string | URL to the model thumbnail image |
| output.model_urls | object | Dictionary of model file formats and their URLs (glb, fbx, obj, usdz, blend, stl) |
| output.texture_urls | object | Dictionary of texture map URLs (base_color, metallic, roughness, normal) |
| output.seed | integer | Seed used for the generation |
| output.prompt | string | Original text prompt |
| output.actual_prompt | string | Prompt after LLM expansion (if enable_prompt_expansion was used) |
| rigged_character_glb | string | URL to the rigged character GLB file (if enable_rigging was true) |
| rigged_character_fbx | string | URL to the rigged character FBX file (if enable_rigging was true) |
| basic_animations | array | List of animation files with name and URL |
| rig_task_id | string | Internal identifier for the rigging task (if enable_rigging was true) |
| created_at | string | ISO timestamp when the request was created |
| updated_at | string | ISO timestamp when the request was last updated |
| completed_at | string | ISO timestamp when the request was completed |
Request Headers
| Header | Value |
|---|---|
| Content-Type | application/json |
| Ocp-Apim-Subscription-Key | Your API subscription key |
Response Handling
Common status codes for Meshy 6 (Text to 3D) check status.
| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad Request (invalid request_id) |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found (request_id not found) |
| 429 | Too Many Requests |
| 500 | Internal Server Error |
Notes & Tips
- Poll the status endpoint every 2–3 seconds until status is COMPLETED, FAILED, or ERROR.
- Use enable_prompt_expansion to enhance vague prompts with semantic detail.
- For character models, combine enable_rigging, pose_mode, and enable_animation for ready-to-animate assets.
- Use texture_image_url for precise texture control when text prompts are insufficient.
- Set target_polycount appropriately: lower values (5k–15k) for web/mobile, higher (30k–100k) for high-end rendering.
- Always validate actual_prompt in COMPLETED responses to confirm prompt expansion behavior.
- Implement retry logic for transient ERROR or FAILED states.
- Predictive generation time: 15–60 seconds for preview mode, 30–120 seconds for full mode.
- Texture guidance works best with high-resolution source images (1024x1024+).
- Enable safety_checker is recommended for public applications to prevent inappropriate generation.
Meshy 6 API Pricing
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
| Header | Required | Default | Description |
|---|---|---|---|
X-Webhook-URL | Yes (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-Mode | No | terminal | terminal — 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
POSTwhen the request reaches a terminal status. No callback duringPROCESSING. - sync mode —
POSTon every status poll (with delay capped at ~15s) plus a finalPOSTat terminal status. Use when you want progress updates. - Idempotency — use
request_idas your idempotency key. Network retries can deliver the same callback more than once; your handler must tolerate duplicates. - Response — respond
200 OKwithin 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
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
image_url | Yesrequired | string | — | — |
| 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_type | No | enum | "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. | ||||
topology | No | enum | "triangle" | quad, triangle |
| Mesh topology type. Quad for smooth surfaces, triangle for detailed geometry. | ||||
target_polycount | No | integer | 30000 | 100–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_mode | No | enum | "auto" | off, auto, on |
| Symmetry enforcement mode. "off" disables symmetry, "auto" decides automatically, "on" enforces symmetry. | ||||
should_remesh | No | boolean | true | true, false |
| Rebuilds the model's surface grid for cleaner geometry. When off, returns the raw, unoptimized triangular mesh. | ||||
should_texture | No | boolean | true | true, false |
| Generates a texture map for the 3D model. When off, returns untextured geometry only. | ||||
enable_pbr | No | boolean | false | true, false |
| Generates realistic surface materials (PBR: metallic, roughness, normal maps) in addition to the base colour, so the model reacts properly to light. | ||||
pose_mode | No | enum | "" | 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_prompt | No | string | — | Max 600 characters |
| Additional text prompt used to guide the texturing process. | ||||
texture_image_url | No | string | — | — |
| URL to a 2D image used to guide the texturing process. | ||||
enable_rigging | No | boolean | false | true, false |
| Auto-rig the generated model as a humanoid character, including basic walking and running animations. | ||||
rigging_height_meters | No | float | 1.7 | — |
| Approximate height of the rigged character in meters. Only used when enable_rigging is true. | ||||
enable_animation | No | boolean | false | true, false |
| Apply a predefined animation preset. Requires enable_rigging to be true. | ||||
animation_action_id | No | integer | 92 | 0–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_checker | No | boolean | true | true, 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 |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 429 | 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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR |
| model_id | string | Model that processed the request |
| error | string|null | Error message if failed |
| output.media_url | array | URLs to generated media (R2 CDN) |
| output.media_type | string | MIME type of the output |
| created_at | string | When request was created |
| completed_at | string|null | When request completed |
| polling_url | string | Status URL (initial response only) |
Status Values
| Status | Description |
|---|---|
| QUEUED | Request accepted, waiting to be processed |
| PROCESSING | Being processed by the model |
| COMPLETED | Done — output contains the result |
| FAILED | Failed — check error field |
| ERROR | System error — not charged |
Status Flow
QUEUED → PROCESSING → COMPLETED
→ FAILED
→ ERROR
Typical Workflow
- Send a generate request to the API endpoint
- Save the
request_idfrom the response - Poll every 5-10 seconds:
GET /v2/requests/status/{request_id} - When
statusis"COMPLETED", download fromoutput.media_url
Tip: Use X-Webhook-URL header to get a callback instead of polling.
Meshy 6 API Pricing
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/retextureAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
200within a few seconds; the Webhook endpoint must be HTTPS.
Request Parameters
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
model_url | Yesrequired | string | — | 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_prompt | No | string | — | 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_url | No | string | — | 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_resolution | No | string | "2k" | 2k, 4k |
The size of the base color texture: 2k (2048) or 4k (4096). It does not change the amount billed. | ||||
enable_original_uv | No | boolean | true | true, 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_pbr | No | boolean | false | true, false |
| Also generate PBR maps (metallic, roughness and normal) in addition to the base color. It does not change the amount billed. | ||||
enable_safety_checker | No | boolean | true | true, 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,nandcountare 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_secondandmusic_length_msare rejected. - Send every field at the top level of the JSON body;
parameters,contentandtextare rejected. - Send the 3D model as
model_url: a publicly reachablehttpsURL (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 asimage_style_url: one of the two is required. When you send both, the picture is used. input_task_idis not accepted: send the 3D model itself asmodel_url.image_urlandmultiview_image_urlsare rejected: send one style picture asimage_style_url.texture_resolutiontakes2k(the default) or4k; any other value is rejected.- Use the JSON types shown:
model_url,text_style_prompt,image_style_urlandtexture_resolutionare strings; the options aretrueorfalse(not"true"). - Omit a field instead of sending
null. - Results are always returned as a URL in
output.media_url;sync_modeis accepted only asfalse. - Webhooks are set with the
X-Webhook-URL/X-Webhook-Modeheaders;webhook_url,webhook_modeandcallback_urlin the JSON body are rejected. streamis 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_thumbnailandhd_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_resolutionsets the size of the base color texture:2k(2048, the default) or4k(4096). Withenable_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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks (see Webhook section). |
| X-Webhook-Mode | No | terminal (default) or sync (see Webhook section). |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Invalid 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. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance for the hold this request needs. |
| 429 | Too many requests. |
| 500 | Internal 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.
| Condition | How it surfaces |
|---|---|
| Missing or invalid subscription key | synchronous 401 |
| Balance too low for the hold | synchronous 402 |
Missing or empty model_url, model_url not a string | synchronous 400 |
text_style_prompt not a string, or longer than 600 characters | synchronous 400 |
texture_resolution must be '2k' or '4k' (or left out for '2k'): the 8k texture is not available on this API | synchronous 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 string | synchronous 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 model | status: "ERROR" |
| A style picture that cannot be read, or one larger than 20 MB | status: "ERROR" |
| A request the model refuses, for example under its content policy | status: "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_KEYcURL 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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED or ERROR. |
| model_id | string | The model that handled the request — meshy-6-retexture for this endpoint. |
| output.media_url | array of strings | URL of the 3D model (one GLB file per request). |
| output.media_type | string | model/gltf-binary. |
| created_at | string | Request creation timestamp. |
| completed_at | string | Completion timestamp. |
| error | string | Error message when status is ERROR. |
| polling_url | string | Status URL for this request (submit response only). |
Status Values & Flow
QUEUED → PROCESSING → COMPLETED (success) or ERROR (failure).
Typical workflow
- Send the request to
POST https://gateway.pixazo.ai/meshy-6-retexture/v1/retexture. - Save the
request_idfrom the202response. - Poll
GET /v2/requests/status/{request_id}every 10 seconds or so, or use a Webhook instead. - When
statusisCOMPLETED, download the 3D model fromoutput.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.
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/retextureAuthentication
All requests require an API key passed via header.
| Header | Type | Required | Description |
|---|---|---|---|
| Ocp-Apim-Subscription-Key | string | Yes | Your 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.
| Header | Required | Description |
|---|---|---|
| X-Webhook-URL | To enable | HTTPS URL to receive the Webhook callback. |
| X-Webhook-Mode | No | terminal (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
200within a few seconds; the Webhook endpoint must be HTTPS.
Request Parameters
| Parameter | Required | Type | Default | Allowed values / range |
|---|---|---|---|---|
model_url | Yesrequired | string | — | 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_prompt | Yes, unless image_style_url is set | string | — | up to 600 characters |
Describe the texture style you want. Required when image_style_url is not provided. | ||||
image_style_url | No | string | — | 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_uv | No | boolean | true | true, false |
| Keep the model's original UV mapping instead of generating new UVs. If the model has no UVs, quality may be lower. | ||||
enable_pbr | No | boolean | false | true, 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_checker | No | boolean | true | true, 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_sizeandnumber_of_imagesare 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.gltfthat points to separate.binor texture files cannot be fetched from one URL — send a.glb, or a.gltfwith 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
| Header | Required | Description |
|---|---|---|
| Content-Type | Yes | application/json |
| Ocp-Apim-Subscription-Key | Yes | Your API subscription key. |
| X-Webhook-URL | No | Enable Webhook callbacks (see Webhook section). |
Response Handling
| Status Code | Meaning |
|---|---|
| 202 | Accepted — request queued; returns request_id and polling_url. |
| 400 | Bad 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. |
| 401 | Unauthorized — missing or invalid subscription key. |
| 402 | Insufficient balance. |
| 429 | Too many requests. |
| 500 | Internal 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.
| Condition | How it surfaces |
|---|---|
model_url missing, or not a string | synchronous 400 |
neither text_style_prompt nor image_style_url sent | synchronous 400 |
text_style_prompt longer than 600 characters | synchronous 400 |
num_images, n, count, batch_size or number_of_images sent | synchronous 400 |
model_url unreachable, or not a supported model format | status: "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
| Field | Type | Description |
|---|---|---|
| request_id | string | Unique request identifier. |
| status | string | QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR. |
| model_id | string | The model that handled the request. |
| output.media_url | array | URL of the retextured 3D model (GLB). |
| output.media_type | string | model/gltf-binary. |
| created_at | string | Request creation timestamp. |
| completed_at | string | Completion timestamp. |
| error | string | Error 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.
⚡ 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).
〰 Uptime
Percent of generations that succeeded over the selected period, per model version.