latestSwagger 2.02026-08-19218237253.7 KB

3af866d68651

3D Models

Convert a single source image into a textured 3D model (image-to-3D). Synchronous: the call blocks while the mesh is generated, decompressed, and re-uploaded, then returns a downloadable GLB model_url plus an array of snapshot image URLs rendered from different angles (handy for previews). Accepts optional mesh controls: target_num_faces (max triangle count, 1000-200000, default 50000), texture_size (1024 or 2048, default 2048), and texture_type ("pbr", "simple", or "none", default "pbr"). Credits are charged only on success. Pass an optional request_id to tag the result so you can locate it later via get3DModelResults. Requires an API key (user scope).

post/assets/3d-model

Request body

imagestring required

URL or base64-encoded image to convert to 3D

target_num_facesinteger

Maximum triangle count for the mesh (1000-200000)

texture_size1024 | 2048

Texture resolution in pixels

texture_type'pbr' | 'simple' | 'none'

Texture type

request_idstring

Optional client-provided identifier for this request. Use this to retrieve results later via the results endpoint.

Response

Success

model_urlstring

URL to the generated 3D model file

snapshotsstring[]

URLs to snapshot images from different angles (useful for previews and MCP agents)