three.ws Blender

Convert a 3D file from any format Blender can import to any format it can export, driven entirely by the file extensions: .glb, .gltf, .fbx, .obj, .stl, .ply, .dae, .abc, .usd/.usda/.usdc/.usdz, .x3d, and .blend on both sides. Modifiers are applied on export by default, and an optional uniform scale is baked in. Returns the output path, its size, the resulting geometry counts, and the world-space bounds. The input file is never modified; omit "output" and the result lands in the server workdir.

Generate a 3D model from a text prompt OR a reference image on the public three.ws Forge pipeline, then bring it into Blender. Pass "prompt" to describe it, "image" for a local PNG/JPEG/WebP, or "image_url" for one already public; an image plus a prompt uses the prompt to steer the reconstruction. The default image lane (FLUX to TRELLIS) is free and needs no key, wallet, or account. The GLB is saved locally, and if the output path asks for another format (.blend, .fbx, .obj, .usd) Blender converts it on the way in. Returns the local path, the hosted GLB URL, and the geometry counts. Generation runs on a shared GPU lane and typically takes tens of seconds to a couple of minutes. Describe ONE subject per call.

Report the local Blender this server drives: executable path, version, bundled Python, available render engines, and the import/export formats this build actually supports. Call it first when a tool fails, or to check that Blender is installed at all. Read-only: it opens no file and writes nothing.

Make a model web-ready in one call: decimate every mesh proportionally to hit a triangle budget, scale oversized textures down, purge datablocks nothing references, and compress the mesh streams with meshopt (or Draco) on the way out. Returns before and after triangle counts, texture bytes and file size, plus what each step did, so the trade is visible rather than guessed. The input file is never modified. Decimation is collapse-based and preserves vertex groups, but a heavily decimated skinned mesh should be checked with blender_render before shipping.

Render a still PNG of any 3D file Blender can open (.blend, .glb, .fbx, .obj, .usd and the rest). If the scene has no camera, one is created and framed to the model; if it has no light, a key light and a lit world are added, so a bare asset file renders as a usable preview with no setup. A scene that already has its own camera and lighting is rendered as authored. The rendered image is returned INLINE alongside the JSON, so you can actually look at the model in this one call without needing filesystem access, while the full-resolution PNG is written to disk. Ask for several views and it orbits the model, rendering every angle in the same Blender launch. Use it to see a model, check a conversion, or produce a thumbnail.

Execute a Python script inside Blender with the full bpy API available. Optionally open a 3D file first (any format Blender imports) and export the edited scene afterwards, chosen by the output extension. Anything printed is returned as stdout, and assigning a JSON-serializable value to a variable named `result` returns it as structured data. Use this for scene edits the other tools do not cover: decimating meshes, joining or renaming objects, editing armatures, baking animation, cleaning materials. The script runs with the permissions of this server and can read and write the local filesystem.

Open a 3D file with Blender and report what is inside it: object list with types, parents, dimensions and modifiers; evaluated triangle and vertex counts; materials; armature bone names; animation actions with their frame ranges; a texture inventory with each image's resolution and byte size plus the total, which is usually what decides whether an asset is deliverable; and world-space bounds. Accepts .blend plus every format this Blender can import (.glb, .gltf, .fbx, .obj, .stl, .ply, .dae, .abc, .usd*, .x3d). Counts describe the file AS LOADED, so a GLB reports more vertices than the .blend it came from (glTF splits vertices at UV and normal seams) while the triangle count is identical. Read-only: the file is never modified.