## 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.