3dstable3dimagereferenceasync
Convert to 3D
studio_convert_to_3dLift a 2D image into a textured 3D GLB mesh via Meshy v6.
Overview
Generates a textured 3D asset (GLB / FBX / OBJ / USDZ) from a single reference image. Meshy v6 is the only 3D model wmstudio currently has a dedicated handler for — other unsupported 3D endpoints will fail field-validation downstream. `image_url` is required and HEAD-preflight-checked.
Auth
oauth-jwt
Returns
{ is3D: true, modelGlbUrl, thumbnailUrl, modelUrls, textureUrls, creditsCharged, creditsRemaining, lowCreditsWarning? }
Web client
MCP handler
https://github.com/PrincipeRosso/wmstudio-director-mcp/blob/main/src/mcp/tools/director-tools.ts
Quick start
Invoke the tool over Streamable HTTP at {MCP_BASE_URL}/mcp/. The request below assumes you already minted an MCP JWT via the OAuth flow.
{
"name": "studio_convert_to_3d",
"arguments": {
"image_url": "<image_url>"
}
}Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| image_urlrequired | string | — | Public URL of the source image. Fabricated URLs rejected by HEAD preflight. |
| model | string | "fal-ai/meshy/v6/image-to-3d" | Widemile model id. Stick with the default — alternates are unsupported by the Widemile handler. |
Examples
Image → GLB
json
{
"name": "studio_convert_to_3d",
"arguments": {
"image_url": "https://cdn.wm.studio/uploads/portrait.jpg"
}
}Performance
Notes
- Meshy v6 is currently the only supported 3D model. Passing a Hunyuan or Trellis model id will result in `Field required: input_image_url` from fal.