# three.ws Game-Ready 3D Mesh Pipeline

> three.ws Game-Ready 3D Mesh Pipeline is a paid API for AI agents from three.ws, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-11).

Retopologizes and rebakes a source GLB mesh into an engine-ready 3D asset with configurable polygon budget, topology type, and PBR texture atlas resolution.

## Facts

- Endpoint: POST https://three.ws/api/x402/pipeline-gameready?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-game-ready-3d-mesh-pipeline-61b5b3e6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z9sXJ-Nba2VKfvoopWeFi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability three-ws-game-ready-3d-mesh-pipeline-61b5b3e6 -d '<json body>'
```

Example prompt: Take this high-poly GLB at https://three.ws/avatars/mannequin.glb and retopologize it using quad topology down to 15,000 triangles with a 1024 texture atlas so it's ready to drop into a game engine.

## When to prefer this

Choose this endpoint when you need to automatically convert a high-polygon GLB mesh into a game- or web-engine-ready asset with controlled polygon budget, field-aligned quad or silhouette-preserving tri topology, and rebaked PBR textures — especially when building pipelines for 3D avatar systems, web-based 3D agents, or real-time game assets. Prefer this over manual DCC tools when programmatic, per-call automation with micropayment pricing is acceptable.

## Known failure modes

- Invalid or inaccessible GLB URL returns an error — source mesh must be a public HTTPS URI
- Poly budget outside 1,000–500,000 range rejected
- Unsupported texture_size value (not 1024 or 2048) rejected
- Payment failure via x402 protocol prevents processing
- Source GLB with corrupt geometry may fail retopology stage
- Very large meshes may time out during processing

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object containing the URL of the processed game-ready GLB file on the CDN, the actual face count achieved, quad ratio, polygon budget used, topology type, whether textures were baked, file size in bytes, and a persisted flag indicating the file is stored and accessible.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "glb_url": {
   "type": "string",
   "format": "uri",
   "description": "Public HTTPS URL of the source binary glTF (.glb) mesh."
  },
  "topology": {
   "enum": [
    "quad",
    "tri"
   ],
   "type": "string",
   "default": "quad",
   "description": "quad = QuadriFlow field-aligned retopo; tri = silhouette-preserving low-poly."
  },
  "poly_budget": {
   "type": "integer",
   "default": 15000,
   "maximum": 500000,
   "minimum": 1000,
   "description": "Target triangle budget for the engine-ready output."
  },
  "texture_size": {
   "enum": [
    1024,
    2048
   ],
   "type": "integer",
   "default": 1024,
   "description": "Resolution of the re-baked PBR texture atlas."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bytes": 640220,
  "stage": "gameready",
  "textured": true,
  "topology": "quad",
  "input_url": "https://three.ws/avatars/mannequin.glb",
  "persisted": true,
  "face_count": 12000,
  "output_url": "https://three.ws/cdn/x402-pipeline/gameready/abc123.glb",
  "quad_ratio": 0.97,
  "poly_budget": 12000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-game-ready-3d-mesh-pipeline-61b5b3e6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)