—
Meshy — v6 Image to 3D
Meshy-6 is the latest model from Meshy. It generates realistic and production ready 3D models.
Input
Add your inputs and customize the generation settings.
Result & Pricing
3d output — your generated 3d will appear here.
Your 3d will appear here
Choose your inputs and customize your settings.
Model pricing (tax excluded) per generation
| Specification | Webot INR |
|---|---|
| Rate | ₹95.85 |
Calculate credits in the input panel for your selected settings.
Prices, estimates and credit deductions exclude tax. Any applicable tax is charged only when you buy plans or credits.
Mesh-only generation is supported. Explicitly disable remesh, texturing, PBR, rigging and animation; use preview mode for text requests and standard model_type where available. Texture prompts/images and other option changes await billing verification. FAL defaults remain documented; the example input supplies the supported overrides. Multiple file formats and thumbnails belong to one generated object, not separate billed generations. Remove texture guidance for the supported mesh-only configuration. Remove texture guidance for the supported mesh-only configuration. Prices are converted to INR. Credits use your current plan rate.
- Prices shown are estimates, not final charges. Final billing details will be available in Reports after generation is complete.
API
WEBOT API · v6 Image to 3D
Generate from your server with your WEBOT account credits.
Use your 120-character WEBOT customer key (a–z, A–Z, 0–9). Send
Authorization: Bearer YOUR_KEY. Keys are secrets: call from a server, never from public frontend code. Results come from verified webhooks and remain saved if your stream disconnects.1. Configure your server
WEBOT_BASE_URL=https://webot.online
WEBOT_API_KEY=<your-server-side-WEBOT-key>This base URL is resolved from verified domain mappings and your direct creator reseller. Forwarded Host headers are not trusted. New custom reseller domains need DNS, TLS and platform verification before activation.
2. Quote, then generate
| Method | Endpoint | Purpose |
|---|---|---|
| POST | https://webot.online/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote | Validate input and calculate credits (no deduction). |
| POST | https://webot.online/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests | Reserve quoted credits and queue an asynchronous job. |
| GET | https://webot.online/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests/{request_id}/result | Read your saved result: 202 pending, 200 terminal. |
| GET | https://webot.online/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests/{request_id}/events | Authenticated SSE: generation / terminal events. |
Send JSON {"input":{…}} to quote. Send the same input plus integer quoted_credits to generate, with Authorization: Bearer … and Idempotency-Key. Use a unique 16–128 character key per new job; persist it and reuse the same key and input on any uncertain response. Never retry with a new key: that creates a second chargeable job.
Credits are reserved only after validation and a durable request is saved. A changed quote or insufficient balance returns 409. Credits exclude purchase taxes. The quoted amount is an initial reservation. After generation, the final charge replaces it using confirmed usage. Any verified unused allocation becomes available automatically; additional usage may require more credits. Missing billing stays pending, including for failed jobs.
3. Input example
Save this as input.json. Replace sample prompts, files and media URLs with your own. Schemas do not guarantee provider acceptance of the content.
Supported generation options
- Mesh-only generation is supported. Explicitly disable remesh, texturing, PBR, rigging and animation; use preview mode for text requests and standard model_type where available. Texture prompts/images and other option changes await billing verification. FAL defaults remain documented; the example input supplies the supported overrides. Multiple file formats and thumbnails belong to one generated object, not separate billed generations.
- Remove texture guidance for the supported mesh-only configuration.
{
"image_url": "https://webot.online/creative/media/asset/webot-output.png/?token=L7kOhLjHfFFAGeLuaTS1f6BgGdIZqBW1sF3ZsiwZrsGps7Ot_4bQ9FYYXhhWWxurC70_hmdsTP_9qSFP6fgMutjnHaSx2H4Uc0aR_2N-nHLUg032Rt78kDNYRsMOrag",
"target_polycount": 30000,
"topology": "triangle",
"should_remesh": false,
"should_texture": false,
"model_type": "standard",
"rigging_height_meters": 1.7,
"enable_pbr": false,
"enable_safety_checker": true,
"pose_mode": "",
"is_a_t_pose": false,
"symmetry_mode": "auto",
"enable_animation": false,
"enable_rigging": false,
"animation_action_id": 92
}4. Language examples
# Save the model's example input as input.json, then replace prompts/media URLs.
# Requires curl and jq. Store NONCE once for this job; reuse it on any retry.
export NONCE="$(openssl rand -hex 16)"
BASE="${WEBOT_BASE_URL%/}"
jq -n --slurpfile input input.json '{input:$input[0]}' > quote-body.json
curl --fail-with-body -sS "$BASE/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote" \
-H "Authorization: Bearer $WEBOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @quote-body.json > quote.json
CREDITS=$(jq -er '.quote.credits_consumed' quote.json)
jq --argjson credits "$CREDITS" '. + {quoted_credits:$credits}' quote-body.json > request-body.json
curl --fail-with-body -sS "$BASE/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests" \
-H "Authorization: Bearer $WEBOT_API_KEY" -H "Idempotency-Key: $NONCE" \
-H 'Content-Type: application/json' --data-binary @request-body.json > job.json
# Subscribe; after a nonterminal disconnect, reconnect this SAME URL.
curl --fail-with-body -N "$(jq -er '.events_url' job.json)" -H "Authorization: Bearer $WEBOT_API_KEY"
# Read saved output after terminal notification (never call provider status/results).
curl --fail-with-body -sS "$(jq -er '.result_url' job.json)" -H "Authorization: Bearer $WEBOT_API_KEY"// Node.js 18+. Save your customized input in input.json.
import { readFileSync } from 'node:fs';
import { randomUUID } from 'node:crypto';
const base = process.env.WEBOT_BASE_URL.replace(/\/$/, '');
const key = process.env.WEBOT_API_KEY;
const input = JSON.parse(readFileSync('input.json', 'utf8'));
const nonce = process.env.WEBOT_JOB_NONCE || randomUUID(); // Persist before submission.
async function post(path, body, nonce) {
const response = await fetch(base + path, {method:'POST', headers:{
Authorization:`Bearer ${key}`, 'Content-Type':'application/json',
...(nonce ? {'Idempotency-Key':nonce} : {})}, body:JSON.stringify(body)});
const json = await response.json();
if (!response.ok) throw new Error(JSON.stringify(json));
return json;
}
const {quote} = await post('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote', {input});
const job = await post('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests', {input, quoted_credits:quote.credits_consumed}, nonce);
console.log(job); // Stable WEBOT request_id, events_url, result_url.
// Stream saved webhook state. Reconnect ONLY the event stream, not the generation.
while (!job.terminal || job.financial_pending) {
const stream = await fetch(job.events_url, {headers:{Authorization:`Bearer ${key}`}});
if (!stream.ok) throw new Error(`Event stream HTTP ${stream.status}`);
let buffer = '';
for await (const chunk of stream.body.pipeThrough(new TextDecoderStream())) {
buffer += chunk;
let end;
while ((end = buffer.indexOf('\n\n')) !== -1) {
const event = buffer.slice(0, end); buffer = buffer.slice(end + 2);
const data = event.split('\n').find(line => line.startsWith('data: '));
if (!data) continue;
const state = JSON.parse(data.slice(6));
if (state.error && !state.status) throw new Error(JSON.stringify(state.error));
if (state.terminal && !state.financial_pending) { console.log(state.output ?? state.error); process.exit(0); }
}
}
await new Promise(resolve => setTimeout(resolve, 1500));
}
console.log(job.output ?? job.error);// Node.js 18+. Save your customized input in input.json.
import { readFileSync } from 'node:fs';
import { randomUUID } from 'node:crypto';
const base = process.env.WEBOT_BASE_URL!.replace(/\/$/, '');
const key = process.env.WEBOT_API_KEY!;
const input = JSON.parse(readFileSync('input.json', 'utf8'));
const nonce = process.env.WEBOT_JOB_NONCE || randomUUID(); // Persist before submission.
async function post(path: string, body: unknown, nonce?: string) {
const response = await fetch(base + path, {method:'POST', headers:{
Authorization:`Bearer ${key}`, 'Content-Type':'application/json',
...(nonce ? {'Idempotency-Key':nonce} : {})}, body:JSON.stringify(body)});
const json = await response.json();
if (!response.ok) throw new Error(JSON.stringify(json));
return json;
}
const {quote} = await post('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote', {input});
const job = await post('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests', {input, quoted_credits:quote.credits_consumed}, nonce);
console.log(job); // Stable WEBOT request_id, events_url, result_url.
// Stream saved webhook state. Reconnect ONLY the event stream, not the generation.
while (!job.terminal || job.financial_pending) {
const stream = await fetch(job.events_url, {headers:{Authorization:`Bearer ${key}`}});
if (!stream.ok) throw new Error(`Event stream HTTP ${stream.status}`);
let buffer = '';
for await (const chunk of stream.body.pipeThrough(new TextDecoderStream())) {
buffer += chunk;
let end;
while ((end = buffer.indexOf('\n\n')) !== -1) {
const event = buffer.slice(0, end); buffer = buffer.slice(end + 2);
const data = event.split('\n').find(line => line.startsWith('data: '));
if (!data) continue;
const state = JSON.parse(data.slice(6));
if (state.error && !state.status) throw new Error(JSON.stringify(state.error));
if (state.terminal && !state.financial_pending) { console.log(state.output ?? state.error); process.exit(0); }
}
}
await new Promise(resolve => setTimeout(resolve, 1500));
}
console.log(job.output ?? job.error);# Python 3.9+, pip install requests
import json, os, time, uuid, requests
base = os.environ['WEBOT_BASE_URL'].rstrip('/')
headers = {'Authorization': 'Bearer ' + os.environ['WEBOT_API_KEY']}
with open('input.json', encoding='utf-8') as file:
input_data = json.load(file)
nonce = os.environ.get('WEBOT_JOB_NONCE') or str(uuid.uuid4()) # Persist before submitting.
def post(path, body, extra=None):
response = requests.post(base + path, headers={**headers, **(extra or {})}, json=body, timeout=180)
response.raise_for_status()
return response.json()
quote = post('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote', {'input': input_data})['quote']
job = post('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests', {'input': input_data, 'quoted_credits': quote['credits_consumed']}, {'Idempotency-Key': nonce})
state = job
while not state['terminal'] or state.get('financial_pending', False):
# Reconnect while nonterminal; this reads WEBOT's database, never a provider status API.
with requests.get(job['events_url'], headers=headers, stream=True, timeout=(10, 40)) as stream:
stream.raise_for_status()
for line in stream.iter_lines(decode_unicode=True):
if line and line.startswith('data: '):
state = json.loads(line[6:])
if 'status' not in state: raise RuntimeError(state)
if state['terminal'] and not state.get('financial_pending', False): break
if not state['terminal'] or state.get('financial_pending', False): time.sleep(1.5)
print(state['output'] if state['status'] == 'completed' else state['error'])<?php // PHP 8.1+ with cURL
$base = rtrim(getenv('WEBOT_BASE_URL'), '/');
$input = json_decode(file_get_contents('input.json'), false, 64, JSON_THROW_ON_ERROR);
$nonce = getenv('WEBOT_JOB_NONCE') ?: bin2hex(random_bytes(16)); // Persist this before submission.
function post(string $path, array $body, ?string $nonce = null): array {
global $base;
$headers = ['Authorization: Bearer '.getenv('WEBOT_API_KEY'), 'Content-Type: application/json'];
if ($nonce) $headers[] = 'Idempotency-Key: '.$nonce;
$ch = curl_init($base.$path);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER=>true, CURLOPT_POST=>true,
CURLOPT_TIMEOUT=>180, CURLOPT_HTTPHEADER=>$headers,
CURLOPT_POSTFIELDS=>json_encode($body, JSON_THROW_ON_ERROR)]);
$raw = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch);
if ($raw === false || $status < 200 || $status >= 300) throw new RuntimeException('WEBOT HTTP '.$status);
return json_decode($raw, true, 64, JSON_THROW_ON_ERROR);
}
$quote = post('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote', ['input'=>$input])['quote'];
$job = post('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests', ['input'=>$input, 'quoted_credits'=>$quote['credits_consumed']], $nonce);
echo json_encode($job, JSON_PRETTY_PRINT); // Connect to events_url with the same Bearer header.// Go 1.20+; save as main.go.
package main
import ("bytes"; "encoding/json"; "fmt"; "io"; "net/http"; "os"; "strings"; "time"; "crypto/rand"; "encoding/hex")
func main() {
base := strings.TrimRight(os.Getenv("WEBOT_BASE_URL"), "/")
raw, err := os.ReadFile("input.json"); if err != nil { panic(err) }
nonce := os.Getenv("WEBOT_JOB_NONCE")
if nonce == "" { b := make([]byte,16); if _,err:=rand.Read(b);err!=nil {panic(err)}; nonce=hex.EncodeToString(b) }
// Persist nonce before the submission; reuse on ambiguous responses.
client := &http.Client{Timeout:180*time.Second}
post := func(path string, body any, id string) map[string]any {
data, err := json.Marshal(body); if err != nil {panic(err)}
req, err := http.NewRequest("POST",base+path,bytes.NewReader(data)); if err!=nil {panic(err)}
req.Header.Set("Authorization","Bearer "+os.Getenv("WEBOT_API_KEY")); req.Header.Set("Content-Type","application/json")
if id!="" {req.Header.Set("Idempotency-Key",id)}
res,err:=client.Do(req); if err!=nil {panic(err)}; defer res.Body.Close()
data,err=io.ReadAll(res.Body); if err!=nil {panic(err)}
if res.StatusCode<200||res.StatusCode>=300 {panic(string(data))}
var result map[string]any; if err=json.Unmarshal(data,&result);err!=nil {panic(err)}; return result
}
input:=json.RawMessage(raw)
quote:=post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote",map[string]any{"input":input},"")["quote"].(map[string]any)
job:=post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests",map[string]any{"input":input,"quoted_credits":quote["credits_consumed"]},nonce)
fmt.Println(job) // Stream events_url with the same Authorization header.
}// Java 11+, Jackson databind dependency; class Main in Main.java.
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import java.time.Duration;
import java.util.UUID;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.node.ObjectNode;
public class Main {
static final ObjectMapper json = new ObjectMapper();
static final HttpClient client = HttpClient.newHttpClient();
static final String base = System.getenv("WEBOT_BASE_URL").replaceAll("/$", "");
static JsonNode post(String path, JsonNode body, String nonce) throws Exception {
var b = HttpRequest.newBuilder(URI.create(base+path)).timeout(Duration.ofSeconds(180))
.header("Authorization","Bearer "+System.getenv("WEBOT_API_KEY")).header("Content-Type","application/json")
.POST(HttpRequest.BodyPublishers.ofString(json.writeValueAsString(body)));
if(nonce!=null)b.header("Idempotency-Key",nonce);
var r=client.send(b.build(),HttpResponse.BodyHandlers.ofString());
if(r.statusCode()<200||r.statusCode()>=300)throw new IllegalStateException(r.body());
return json.readTree(r.body());
}
public static void main(String[] args) throws Exception {
var input=json.readTree(Files.readString(Path.of("input.json")));
ObjectNode body=json.createObjectNode();body.set("input",input);
var quote=post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote",body,null).get("quote");
body.put("quoted_credits",quote.get("credits_consumed").asInt());
String nonce=System.getenv("WEBOT_JOB_NONCE");if(nonce==null)nonce=UUID.randomUUID().toString(); // Persist before POST.
var job=post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests",body,nonce);System.out.println(job);
// Subscribe to job.events_url with Authorization; use BodyHandlers.ofLines().
}
}// .NET 8 console app, top-level statements.
using System.Net.Http;
using System.Text;
using System.Text.Json.Nodes;
var client = new HttpClient { Timeout = TimeSpan.FromSeconds(180) };
var root = Environment.GetEnvironmentVariable("WEBOT_BASE_URL")!.TrimEnd('/');
var key = Environment.GetEnvironmentVariable("WEBOT_API_KEY");
async Task<JsonNode> Post(string path, JsonNode body, string? nonce = null) {
using var req = new HttpRequestMessage(HttpMethod.Post, root + path);
req.Headers.Add("Authorization", "Bearer " + key);
if (nonce != null) req.Headers.Add("Idempotency-Key", nonce);
req.Content = new StringContent(body.ToJsonString(), Encoding.UTF8, "application/json");
using var res = await client.SendAsync(req);
var raw = await res.Content.ReadAsStringAsync();res.EnsureSuccessStatusCode();
return JsonNode.Parse(raw)!;
}
var input = JsonNode.Parse(await File.ReadAllTextAsync("input.json"));
var body = new JsonObject { ["input"] = input };
var quote = await Post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote", body);
body["quoted_credits"] = quote["quote"]!["credits_consumed"]!.GetValue<int>();
var nonce = Environment.GetEnvironmentVariable("WEBOT_JOB_NONCE") ?? Guid.NewGuid().ToString(); // Persist before submitting.
var job = await Post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests", body, nonce);
Console.WriteLine(job); // Subscribe to events_url with the same Bearer header and ResponseHeadersRead.# Ruby 3+, standard library only.
require 'net/http'
require 'json'
require 'securerandom'
base = ENV.fetch('WEBOT_BASE_URL').sub(%r{/$}, '')
post = lambda do |path, body, nonce = nil|
uri = URI(base + path)
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer ' + ENV.fetch('WEBOT_API_KEY')
req['Content-Type'] = 'application/json'
req['Idempotency-Key'] = nonce if nonce
req.body = JSON.generate(body)
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true, read_timeout: 180) { |http| http.request(req) }
raise res.body unless res.is_a?(Net::HTTPSuccess)
JSON.parse(res.body)
end
input = JSON.parse(File.read('input.json'))
quote = post.call('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote', {'input' => input})['quote']
nonce = ENV['WEBOT_JOB_NONCE'] || SecureRandom.uuid # Persist this before submission.
job = post.call('/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests', {'input' => input, 'quoted_credits' => quote['credits_consumed']}, nonce)
puts JSON.pretty_generate(job) # Subscribe to events_url with the same Authorization header.// Swift 5.9 server-side/CLI only. Do not embed customer keys in shipped apps.
import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking
#endif
@main struct Main {
static func main() async throws {
let env=ProcessInfo.processInfo.environment
let base=env["WEBOT_BASE_URL"]!.trimmingCharacters(in: CharacterSet(charactersIn:"/"))
let input=try JSONSerialization.jsonObject(with: Data(contentsOf:URL(fileURLWithPath:"input.json")))
func post(_ path:String,_ body:[String:Any],_ nonce:String?=nil) async throws -> [String:Any] {
var req=URLRequest(url:URL(string:base+path)!);req.httpMethod="POST";req.timeoutInterval=180
req.setValue("Bearer "+env["WEBOT_API_KEY"]!,forHTTPHeaderField:"Authorization")
req.setValue("application/json",forHTTPHeaderField:"Content-Type")
if let nonce {req.setValue(nonce,forHTTPHeaderField:"Idempotency-Key")}
req.httpBody=try JSONSerialization.data(withJSONObject:body)
let (data,res)=try await URLSession.shared.data(for:req)
guard let http=res as? HTTPURLResponse,(200..<300).contains(http.statusCode) else {throw NSError(domain:"WEBOT",code:1)}
return try JSONSerialization.jsonObject(with:data) as! [String:Any]
}
let quote=try await post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote",["input":input])["quote"] as! [String:Any]
let nonce=env["WEBOT_JOB_NONCE"] ?? UUID().uuidString // Persist before submission.
let job=try await post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests",["input":input,"quoted_credits":quote["credits_consumed"]!],nonce)
print(job) // Subscribe to events_url with the same Authorization header.
}
}// Server-side Kotlin/JVM 17+, Gradle dependencies: OkHttp 4.12, org.json 20240303.
import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody
import org.json.JSONObject
import java.io.File
import java.util.UUID
import java.util.concurrent.TimeUnit
fun main() {
val base=System.getenv("WEBOT_BASE_URL").trimEnd('/')
val client=OkHttpClient.Builder().readTimeout(180,TimeUnit.SECONDS).build()
fun post(path:String,body:JSONObject,nonce:String?=null):JSONObject {
val b=Request.Builder().url(base+path).header("Authorization","Bearer "+System.getenv("WEBOT_API_KEY"))
.post(body.toString().toRequestBody("application/json".toMediaType()))
if(nonce!=null)b.header("Idempotency-Key",nonce)
return client.newCall(b.build()).execute().use {res ->
val raw=res.body!!.string();check(res.isSuccessful){raw};JSONObject(raw)
}
}
val body=JSONObject().put("input",JSONObject(File("input.json").readText()))
val quote=post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/quote",body).getJSONObject("quote")
body.put("quoted_credits",quote.getInt("credits_consumed"))
val nonce=System.getenv("WEBOT_JOB_NONCE") ?: UUID.randomUUID().toString() // Persist before submission.
val job=post("/api/v1/models/creative_7f0ae1c5c183a20e94bf9ab3/requests",body,nonce)
println(job) // Subscribe to events_url with the same Authorization header.
}5. Receive all results
The response includes a stable WEBOT request_id, events_url and result_url. Subscribe with a Bearer-authenticated HTTP stream. Nonterminal streams end after 25 seconds; reconnect to the same URL after at least 1.5 seconds. Current saved state is replayed immediately, including completion that happened while disconnected. A terminal event contains the result envelope. The JSON terminal flag describes generation completion. Keep reconnecting while financial_pending is true; stop after the terminal event confirms financial settlement. Never poll provider status/results. Native browser EventSource cannot send a Bearer header; keep the key on your server.
Completed output contains the full model result, including every generated media/document item, not just the first URL. Failed output is null with error and refund_state. Results are strictly limited to the key owner, including on reseller domains. Model-independent aliases: /api/v1/requests/{request_id}/result and /events. Revoking a key blocks subsequent reads and streams; saved results remain accessible with another valid key of the same account.
6. Schemas and parameter defaults
Required fields are marked with *. Required text must contain non-whitespace content. Defaults apply when an optional parameter is omitted; null, false, 0 and an empty array are distinct values. “No documented default” means WEBOT does not invent one. Examples are sample inputs, not defaults. WEBOT generation constraints can require an explicit value even when the provider publishes an automatic default.
Input schema · fields, constraints and defaults
| Parameter | Type | Required | Default when omitted | Description / constraints |
|---|---|---|---|---|
target_polycount | integer | No | 30000 | Target number of polygons in the generated model. When model_type is 'smart-topology' and this is left unset, Meshy's lower smart-topology default (4,000) is used instead; smart topology accepts at most 15,000. const: 30000 · minimum: 100 · maximum: 300000 |
topology | string | No | "triangle" | Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry. enum: ["quad","triangle"] · const: "triangle" |
should_remesh | boolean | No | false | Whether to enable the remesh phase const: false |
should_texture | boolean | No | false | Whether to generate textures const: false |
model_type | string | No | "standard" | Type of 3D mesh generation. 'standard' produces a regular high-detail mesh; 'lowpoly' produces a low-poly mesh optimized for cleaner polygons; 'smart-topology' uses Meshy-T2 for clean, natively separated parts. When set to 'lowpoly', the remesh controls (topology, target_polycount, should_remesh) are ignored by Meshy. enum: ["standard","lowpoly","smart-topology"] · const: "standard" |
rigging_height_meters | number | No | 1.7 | Approximate height of the character in meters. Only used when enable_rigging is true. const: 1.7 · exclusiveMinimum: 0 |
enable_pbr | boolean | No | false | Generate PBR Maps (metallic, roughness, normal) in addition to base color const: false |
enable_safety_checker | boolean | No | true | If set to true, input data will be checked for safety before processing. const: true |
texture_prompt | string | null | No | No documented default | Text prompt to guide the texturing process |
texture_image_url | string | null | No | No documented default | 2D image to guide the texturing process |
pose_mode | string | No | "" | Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose. enum: ["a-pose","t-pose",""] · const: "" |
image_url | string | Yes * | No documented default | Image URL or base64 data URI for 3D model creation. Supports .jpg, .jpeg, and .png formats. Also supports AVIF and HEIF formats which will be automatically converted. |
is_a_t_pose | boolean | No | false | Deprecated: use pose_mode instead. When true, generates a T-pose model. const: false |
symmetry_mode | string | No | "auto" | Controls symmetry behavior during model generation. Off disables symmetry, Auto determines it automatically, On enforces symmetry. enum: ["off","auto","on"] · const: "auto" |
enable_animation | boolean | No | false | Apply an animation preset to the rigged model. Requires enable_rigging to be true. const: false |
enable_rigging | boolean | No | false | Automatically rig the generated model as a humanoid character. Includes basic walking and running animations. Best results with humanoid characters that have clearly defined limbs. const: false |
animation_action_id | integer | No | 92 | Animation preset ID from Meshy's library. Only used when enable_animation is true; in that case it must be in [0, 696] (``0`` is the "Idle" preset) and is otherwise rejected with a 422. See https://docs.meshy.ai/en/api/animation-library for available action IDs. const: 92 |
{
"x-webot-order-properties": [
"image_url",
"model_type",
"topology",
"target_polycount",
"symmetry_mode",
"should_remesh",
"should_texture",
"enable_pbr",
"is_a_t_pose",
"pose_mode",
"texture_prompt",
"texture_image_url",
"enable_rigging",
"rigging_height_meters",
"enable_animation",
"animation_action_id",
"enable_safety_checker"
],
"required": [
"image_url"
],
"title": "ImageTo3DInput",
"description": "Input for Image to 3D conversion",
"properties": {
"target_polycount": {
"default": 30000,
"description": "Target number of polygons in the generated model. When model_type is 'smart-topology' and this is left unset, Meshy's lower smart-topology default (4,000) is used instead; smart topology accepts at most 15,000.",
"title": "Target Polycount",
"minimum": 100,
"type": "integer",
"maximum": 300000,
"const": 30000
},
"topology": {
"default": "triangle",
"description": "Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry.",
"enum": [
"quad",
"triangle"
],
"title": "Topology",
"type": "string",
"const": "triangle"
},
"should_remesh": {
"default": false,
"description": "Whether to enable the remesh phase",
"title": "Should Remesh",
"type": "boolean",
"const": false
},
"should_texture": {
"default": false,
"description": "Whether to generate textures",
"title": "Should Texture",
"type": "boolean",
"const": false
},
"model_type": {
"default": "standard",
"description": "Type of 3D mesh generation. 'standard' produces a regular high-detail mesh; 'lowpoly' produces a low-poly mesh optimized for cleaner polygons; 'smart-topology' uses Meshy-T2 for clean, natively separated parts. When set to 'lowpoly', the remesh controls (topology, target_polycount, should_remesh) are ignored by Meshy.",
"enum": [
"standard",
"lowpoly",
"smart-topology"
],
"title": "Model Type",
"type": "string",
"const": "standard"
},
"rigging_height_meters": {
"default": 1.7,
"description": "Approximate height of the character in meters. Only used when enable_rigging is true.",
"exclusiveMinimum": 0,
"title": "Rigging Height Meters",
"type": "number",
"const": 1.7
},
"enable_pbr": {
"default": false,
"description": "Generate PBR Maps (metallic, roughness, normal) in addition to base color",
"title": "Enable Pbr",
"type": "boolean",
"const": false
},
"enable_safety_checker": {
"default": true,
"description": "If set to true, input data will be checked for safety before processing.",
"title": "Enable Safety Checker",
"type": "boolean",
"const": true
},
"texture_prompt": {
"anyOf": [
{
"maxLength": 600,
"type": "string"
},
{
"type": "null"
}
],
"description": "Text prompt to guide the texturing process",
"title": "Texture Prompt"
},
"texture_image_url": {
"anyOf": [
{
"ui": {
"field": "image"
},
"type": "string"
},
{
"type": "null"
}
],
"description": "2D image to guide the texturing process",
"max_pixels": 178956970,
"title": "Texture Image Url",
"max_file_size": 20971520
},
"pose_mode": {
"default": "",
"description": "Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose.",
"enum": [
"a-pose",
"t-pose",
""
],
"title": "Pose Mode",
"type": "string",
"const": ""
},
"image_url": {
"max_pixels": 178956970,
"max_file_size": 20971520,
"title": "Image Url",
"description": "Image URL or base64 data URI for 3D model creation. Supports .jpg, .jpeg, and .png formats. Also supports AVIF and HEIF formats which will be automatically converted.",
"type": "string"
},
"is_a_t_pose": {
"default": false,
"description": "Deprecated: use pose_mode instead. When true, generates a T-pose model.",
"title": "Is A T Pose",
"type": "boolean",
"deprecated": true,
"const": false
},
"symmetry_mode": {
"default": "auto",
"description": "Controls symmetry behavior during model generation. Off disables symmetry, Auto determines it automatically, On enforces symmetry.",
"enum": [
"off",
"auto",
"on"
],
"title": "Symmetry Mode",
"type": "string",
"const": "auto"
},
"enable_animation": {
"default": false,
"description": "Apply an animation preset to the rigged model. Requires enable_rigging to be true.",
"title": "Enable Animation",
"type": "boolean",
"const": false
},
"enable_rigging": {
"default": false,
"description": "Automatically rig the generated model as a humanoid character. Includes basic walking and running animations. Best results with humanoid characters that have clearly defined limbs.",
"title": "Enable Rigging",
"type": "boolean",
"const": false
},
"animation_action_id": {
"default": 92,
"description": "Animation preset ID from Meshy's library. Only used when enable_animation is true; in that case it must be in [0, 696] (``0`` is the \"Idle\" preset) and is otherwise rejected with a 422. See https://docs.meshy.ai/en/api/animation-library for available action IDs.",
"examples": [
92
],
"title": "Animation Action Id",
"type": "integer",
"const": 92
}
},
"type": "object",
"allOf": [
{
"not": {
"not": {
"anyOf": [
{
"not": {
"required": [
"texture_prompt"
]
}
},
{
"properties": {
"texture_prompt": {
"enum": [
null,
"",
[]
]
}
}
}
]
}
},
"x-webot-message": "Remove texture guidance for the supported mesh-only configuration."
},
{
"not": {
"not": {
"anyOf": [
{
"not": {
"required": [
"texture_image_url"
]
}
},
{
"properties": {
"texture_image_url": {
"enum": [
null,
"",
[]
]
}
}
}
]
}
},
"x-webot-message": "Remove texture guidance for the supported mesh-only configuration."
},
{
"if": {
"required": [
"enable_animation"
],
"properties": {
"enable_animation": {
"type": "boolean",
"const": true
}
}
},
"then": {
"required": [
"enable_rigging"
],
"properties": {
"enable_rigging": {
"const": true
}
}
},
"x-webot-message": "Enable Animation requires Enable Rigging enabled."
},
{
"if": {
"required": [
"enable_animation"
],
"properties": {
"enable_animation": {
"const": true
}
}
},
"then": {
"properties": {
"animation_action_id": {
"minimum": 0,
"maximum": 696
}
}
},
"x-webot-message": "Choose an animation action from 0 to 696."
}
]
}Output (inside result.output) schema · fields, constraints and defaults
| Parameter | Type | Required | Default when omitted | Description / constraints |
|---|---|---|---|---|
animation_glb | object | null | No | No documented default | Animated 3D model in GLB format. Only present when enable_animation is true. |
animation_glb.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
animation_glb.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
animation_glb.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
animation_glb.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
basic_animations | object | null | No | No documented default | Basic walking and running animations. Only present when enable_rigging is true. |
basic_animations.variant0.walking_glb | object | null | No | No documented default | Walking animation in GLB format |
basic_animations.variant0.walking_glb.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
basic_animations.variant0.walking_glb.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
basic_animations.variant0.walking_glb.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
basic_animations.variant0.walking_glb.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
basic_animations.variant0.running_armature_glb | object | null | No | No documented default | Running armature only in GLB format |
basic_animations.variant0.running_armature_glb.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
basic_animations.variant0.running_armature_glb.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
basic_animations.variant0.running_armature_glb.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
basic_animations.variant0.running_armature_glb.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
basic_animations.variant0.walking_fbx | object | null | No | No documented default | Walking animation in FBX format |
basic_animations.variant0.walking_fbx.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
basic_animations.variant0.walking_fbx.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
basic_animations.variant0.walking_fbx.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
basic_animations.variant0.walking_fbx.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
basic_animations.variant0.running_glb | object | null | No | No documented default | Running animation in GLB format |
basic_animations.variant0.running_glb.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
basic_animations.variant0.running_glb.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
basic_animations.variant0.running_glb.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
basic_animations.variant0.running_glb.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
basic_animations.variant0.walking_armature_glb | object | null | No | No documented default | Walking armature only in GLB format |
basic_animations.variant0.walking_armature_glb.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
basic_animations.variant0.walking_armature_glb.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
basic_animations.variant0.walking_armature_glb.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
basic_animations.variant0.walking_armature_glb.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
basic_animations.variant0.running_fbx | object | null | No | No documented default | Running animation in FBX format |
basic_animations.variant0.running_fbx.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
basic_animations.variant0.running_fbx.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
basic_animations.variant0.running_fbx.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
basic_animations.variant0.running_fbx.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
seed | integer | null | No | No documented default | The seed used for generation (if available) |
animation_fbx | object | null | No | No documented default | Animated 3D model in FBX format. Only present when enable_animation is true. |
animation_fbx.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
animation_fbx.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
animation_fbx.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
animation_fbx.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
rigged_character_glb | object | null | No | No documented default | Rigged character in GLB format. Only present when enable_rigging is true. |
rigged_character_glb.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
rigged_character_glb.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
rigged_character_glb.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
rigged_character_glb.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
texture_urls | array | No | No documented default | Array of texture file objects, matching Meshy API structure |
texture_urls[].metallic | object | null | No | No documented default | Metallic texture (PBR) |
texture_urls[].metallic.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
texture_urls[].metallic.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
texture_urls[].metallic.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
texture_urls[].metallic.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
texture_urls[].normal | object | null | No | No documented default | Normal texture (PBR) |
texture_urls[].normal.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
texture_urls[].normal.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
texture_urls[].normal.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
texture_urls[].normal.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
texture_urls[].roughness | object | null | No | No documented default | Roughness texture (PBR) |
texture_urls[].roughness.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
texture_urls[].roughness.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
texture_urls[].roughness.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
texture_urls[].roughness.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
texture_urls[].base_color | object | Yes * | No documented default | Base color texture |
texture_urls[].base_color.content_type | string | null | No | No documented default | The mime type of the file. |
texture_urls[].base_color.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
texture_urls[].base_color.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
texture_urls[].base_color.file_size | integer | null | No | No documented default | The size of the file in bytes. |
rigged_character_fbx | object | null | No | No documented default | Rigged character in FBX format. Only present when enable_rigging is true. |
rigged_character_fbx.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
rigged_character_fbx.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
rigged_character_fbx.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
rigged_character_fbx.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
model_urls | object | Yes * | No documented default | URLs for different 3D model formats |
model_urls.blend | object | null | No | No documented default | Blender format 3D model |
model_urls.blend.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
model_urls.blend.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
model_urls.blend.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
model_urls.blend.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
model_urls.glb | object | null | No | No documented default | GLB format 3D model |
model_urls.glb.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
model_urls.glb.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
model_urls.glb.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
model_urls.glb.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
model_urls.fbx | object | null | No | No documented default | FBX format 3D model |
model_urls.fbx.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
model_urls.fbx.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
model_urls.fbx.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
model_urls.fbx.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
model_urls.stl | object | null | No | No documented default | STL format 3D model |
model_urls.stl.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
model_urls.stl.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
model_urls.stl.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
model_urls.stl.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
model_urls.obj | object | null | No | No documented default | OBJ format 3D model |
model_urls.obj.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
model_urls.obj.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
model_urls.obj.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
model_urls.obj.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
model_urls.usdz | object | null | No | No documented default | USDZ format 3D model |
model_urls.usdz.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
model_urls.usdz.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
model_urls.usdz.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
model_urls.usdz.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
model_glb | object | Yes * | No documented default | Generated 3D object in GLB format. |
model_glb.content_type | string | null | No | No documented default | The mime type of the file. |
model_glb.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
model_glb.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
model_glb.file_size | integer | null | No | No documented default | The size of the file in bytes. |
thumbnail | object | null | No | No documented default | Preview thumbnail of the generated model |
thumbnail.variant0.content_type | string | null | No | No documented default | The mime type of the file. |
thumbnail.variant0.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
thumbnail.variant0.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
thumbnail.variant0.file_size | integer | null | No | No documented default | The size of the file in bytes. |
rig_task_id | string | null | No | No documented default | Rigging task ID. Only present when enable_rigging is true. |
{
"x-webot-order-properties": [
"animation_glb",
"animation_fbx",
"model_glb",
"thumbnail",
"model_urls",
"texture_urls",
"seed",
"rigged_character_glb",
"rigged_character_fbx",
"basic_animations",
"rig_task_id"
],
"required": [
"model_glb",
"model_urls"
],
"title": "ImageTo3DOutput",
"description": "Output for Image to 3D conversion",
"properties": {
"animation_glb": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Animated 3D model in GLB format. Only present when enable_animation is true."
},
"basic_animations": {
"anyOf": [
{
"x-webot-order-properties": [
"walking_glb",
"walking_fbx",
"walking_armature_glb",
"running_glb",
"running_fbx",
"running_armature_glb"
],
"description": "Basic animation files included with the rigging result",
"title": "BasicAnimations",
"properties": {
"walking_glb": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Walking animation in GLB format"
},
"running_armature_glb": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Running armature only in GLB format"
},
"walking_fbx": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Walking animation in FBX format"
},
"running_glb": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Running animation in GLB format"
},
"walking_armature_glb": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Walking armature only in GLB format"
},
"running_fbx": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Running animation in FBX format"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Basic walking and running animations. Only present when enable_rigging is true."
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The seed used for generation (if available)",
"examples": [
2009275957
],
"title": "Seed"
},
"animation_fbx": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Animated 3D model in FBX format. Only present when enable_animation is true."
},
"rigged_character_glb": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Rigged character in GLB format. Only present when enable_rigging is true."
},
"texture_urls": {
"description": "Array of texture file objects, matching Meshy API structure",
"title": "Texture Urls",
"items": {
"x-webot-order-properties": [
"base_color",
"metallic",
"normal",
"roughness"
],
"required": [
"base_color"
],
"title": "TextureFiles",
"description": "Texture files downloaded and uploaded to CDN",
"properties": {
"metallic": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Metallic texture (PBR)"
},
"normal": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Normal texture (PBR)"
},
"roughness": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Roughness texture (PBR)"
},
"base_color": {
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object",
"description": "Base color texture"
}
},
"type": "object"
},
"type": "array"
},
"rigged_character_fbx": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Rigged character in FBX format. Only present when enable_rigging is true."
},
"model_urls": {
"x-webot-order-properties": [
"glb",
"fbx",
"obj",
"usdz",
"blend",
"stl"
],
"description": "URLs for different 3D model formats",
"title": "ModelUrls",
"properties": {
"blend": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Blender format 3D model"
},
"glb": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "GLB format 3D model"
},
"fbx": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "FBX format 3D model"
},
"stl": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "STL format 3D model"
},
"obj": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "OBJ format 3D model"
},
"usdz": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "USDZ format 3D model"
}
},
"type": "object"
},
"model_glb": {
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object",
"description": "Generated 3D object in GLB format."
},
"thumbnail": {
"anyOf": [
{
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"title": "File",
"properties": {
"content_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The mime type of the file.",
"examples": [
"image/png"
],
"title": "Content Type"
},
"file_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The name of the file. It will be auto-generated if not provided.",
"examples": [
"z9RV14K95DvU.png"
],
"title": "File Name"
},
"url": {
"description": "The URL where the file can be downloaded from.",
"title": "Url",
"type": "string"
},
"file_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "The size of the file in bytes.",
"examples": [
4404019
],
"title": "File Size"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "Preview thumbnail of the generated model"
},
"rig_task_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Rigging task ID. Only present when enable_rigging is true.",
"title": "Rig Task Id"
}
},
"type": "object"
}Errors and limits
401 invalid/expired/revoked key · 403 key scope or domain mismatch · 404 unavailable model or unowned request · 409 quote changed, balance, concurrency or idempotency conflict · 413 JSON exceeds 2 MB · 415 wrong content type · 422 invalid fields/media · 429 rate limit · 503 temporary/ambiguous submission. Respect Retry-After. Current limits per account: 12 quotes/submissions, 120 result reads and 8 stream connections per minute. One submission preparation at a time per account. Do not automatically regenerate failed jobs.
Your requests
Meshy - v6 Image to 3D · Your account only
Select Requests to load your history.
| Request ID | Created at (IST) | Status | Credits used | Refunded | Processing time | Report |
|---|
Your model analytics
Meshy - v6 Image to 3D · Request dates in IST
Select Analytics to load your metrics.
Request counts
Daily requests by their current status
Request outcomes
Completed, failed and pending requests
Credits used
Daily recorded charges before refunds
Processing time
Daily average for completed requests with recorded timing
Processing percentiles
Completed requests only · Time from submission to recorded completion
How to use Meshy — v6 Image to 3D
Upload the required picture or views of an object. This model estimates a 3D shape that can be viewed from different angles.
Required inputs
- Image Url: The input picture. Use a clear image in one of the accepted formats. If the form offers upload, select a file there; if it asks for a URL, use an accessible HTTPS file link.
Workflow
- Prepare your source material and fill the required inputs above. Review the supported settings for this model.
- Sign in to calculate the credit estimate. Review the estimate before choosing Generate.
- Keep this model page open while the request runs. Completed results arrive in the result area; use the available player or download controls to review the output.
When to use this workflow
- Explore a 3D version of a pictured object.
- Prepare a starting asset for further 3D editing.
Key settings
- Image Url
- The input picture. Use a clear image in one of the accepted formats. If the form offers upload, select a file there; if it asks for a URL, use an accessible HTTPS file link.
- Model Type
- The model variant or processing mode. Names such as fast or pro indicate different variants, not a universal quality scale. Use the options listed here and compare a small sample. Supported choices: "standard", "lowpoly", "smart-topology". Fixed value: "standard"
- Topology
- How a 3D surface’s faces connect. Different layouts suit different editing, animation or game workflows. This changes structure, not just the visible colour. Supported choices: "quad", "triangle". Fixed value: "triangle"
- Target Polycount
- The requested number of small surface faces in a 3D mesh. More faces can describe finer shapes but create heavier assets. Fewer faces are lighter but can lose shape detail. It is a target when the model does not promise an exact count. Minimum: 100. Maximum: 300000. Fixed value: 30000
- Symmetry Mode
- Whether and how the model treats opposite sides as matching. Symmetry can help regular objects, but may remove intentional differences between the sides. Supported choices: "off", "auto", "on". Fixed value: "auto"
- Should Remesh
- Rebuild the connected faces of a 3D surface. This may make the asset easier to use, but can change small shape details. Fixed value: false