three.ws 3D API
Give your AI agent a 3D toolchain. Turn a text prompt into a real textured GLB, validate and optimize any glTF/GLB — free, keyless, no account. When a draft isn't enough, the same API graduates to production Forge Pro tiers and animation-ready Rigged Avatars.
Who this is for
An autonomous agent building a game, a scene, an NFT, or a marketplace asset needs 3D — and needs to trust what it gets. This API answers both mid-task: make me a model from this description, and is this model any good, and how do I make it smaller? No other agent-payments platform gives away 3D generation and inspection.
Endpoints
Assembled live from the API catalog. Every row is free and keyless.
| Method | Path | What it does | Tier |
|---|---|---|---|
| Loading catalog… | |||
Quickstart
Copy, run, done. No key, no header, no account. These call the live production API.
1 · Discover the whole API
curl https://three.ws/api/3d2 · Inspect a model (validate + optimization report)
curl "https://three.ws/api/3d/inspect?url=https://three.ws/avatars/cesium-man.glb"// Response appears here — a real call to /api/3d/inspect.3 · Generate a model from text (free draft)
curl -X POST https://three.ws/api/3d/generate \
-H 'content-type: application/json' \
-d '{ "prompt": "a small ceramic robot figurine" }'
# → { "status": "pending", "job": "…", "poll": "/api/3d/generate?job=…" }
# poll the job:
curl "https://three.ws/api/3d/generate?job=<id>"
# → { "status": "done", "glbUrl": "https://…/model.glb", "viewerUrl": "https://three.ws/…" }Point any OpenAPI toolchain at it
# LangChain, openapi-generator, Swagger UI, etc.
curl https://three.ws/api/3d/openapi.jsonSee the output
Everything the API touches is a real, standards-compliant GLB — the same format your engine, viewer, or marketplace already speaks. Drag to orbit.
Real GLB, not a screenshot
This is a live glTF binary rendered in your browser. The free /api/3d/inspect endpoint reports exactly what's inside one of these — vertices, triangles, materials, textures, animations, extensions — and a prioritized plan to make it smaller and faster.
Free → paid ladder
Start free. Upgrade only when a draft isn't enough. Paid tiers settle per-call in USDC over x402 — still no account, still no key.
Draft + Inspect
- Text→3D draft (NIM TRELLIS): single subject, GLB, no rigging
- glTF/GLB validation + optimization report
- Generous per-IP rate limit
Forge Pro
- Higher polygon budgets + PBR textures
- draft / standard / high quality tiers
- Text→3D and image→3D pipelines
Rigged Avatars
- Auto skeleton + skin weights
- Pre-baked idle / walk clip library
- Animation-ready humanoid GLB
Notes
Is it really free and keyless?
Yes. No account, no API key, no wallet. Free endpoints have a generous per-IP rate limit that only blunts abuse. The free draft generation tier runs on a shared GPU lane — it's honest about being a prototyping tier (draft geometry, GLB only, no rigging).
What formats are supported?
Output is binary glTF (GLB) — the web-standard 3D container every engine and viewer reads. Inspection accepts .glb and .gltf from any public URL, up to the documented size cap.
How do agents pay for the pro tiers?
Programmatically, over x402 (HTTP 402 + USDC on Base or Solana). No key exchange — an agent just retries the request with a payment header. See the paid x402 Bazaar for the full catalog.