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 fal 3D endpoints (e.g. Hunyuan3D) 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

src/app/[locale]/dashboard/creative-studio/tools/convert-to-3d/convert-to-3d-client.tsx

MCP handler

mcp-director/src/tools/studio.py

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.

MCPcurlTypeScript

Copy

{
  "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" fal app id. Stick with the default — alternates are unsupported by the wmstudio handler.

Examples

Image → GLB

json

Copy

{
  "name": "studio_convert_to_3d",
  "arguments": {
    "image_url": "https://v3b.fal.media/files/.../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.