# three.ws 3D Mesh Remesh Pipeline

> three.ws 3D Mesh Remesh 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).

Remeshes, simplifies, repairs, or converts a 3D GLB mesh with optional texture rebaking, returning a cleaned and optimized GLB file URL.

## Facts

- Endpoint: POST https://three.ws/api/x402/pipeline-remesh?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-3d-mesh-remesh-pipeline-1e60e0cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sOHIUeoCHNwxxrgHjjw1X

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-3d-mesh-remesh-pipeline-1e60e0cf -d '<json body>'
```

Example prompt: Take this GLB file at https://three.ws/avatars/mannequin.glb and do a full quad remesh targeting 20,000 faces with a 1024 texture atlas, then give me the download URL for the cleaned mesh.

## When to prefer this

Use this endpoint when you need to automatically optimize, clean, repair, or retopologize a 3D GLB mesh via API — especially for pipelines preparing avatars or scanned meshes for real-time web embedding, mobile rendering, or 3D agent platforms. It is particularly useful when you need quad retopology (QuadriFlow), integrated texture rebaking, and CDN-hosted output in a single pay-per-call step, rather than running local Blender scripts or offline tools.

## Known failure modes

- Invalid or inaccessible GLB URL returns an error — the source URL must be a publicly reachable HTTPS .glb file
- Target face count outside 1,000–500,000 range returns a validation error
- Unsupported remesh_mode/operation combination may return a 400 bad request
- Non-manifold or severely corrupted input meshes may fail even the repair operation
- Payment failure (x402) results in 402 Payment Required before processing begins
- Large meshes may time out if processing exceeds server limits

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

A JSON object containing the CDN URL of the remeshed GLB file, the output face count, quad ratio (for quad mode), whether the mesh is textured, the byte size, the remesh mode and operation used, and whether the file was persisted to CDN storage.

## 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."
  },
  "operation": {
   "enum": [
    "full",
    "simplify",
    "repair",
    "convert"
   ],
   "type": "string",
   "default": "full",
   "description": "triangle-mode only: full remesh, simplify (decimate), repair (fix holes/non-manifold), or convert."
  },
  "remesh_mode": {
   "enum": [
    "triangle",
    "quad",
    "lowpoly"
   ],
   "type": "string",
   "default": "triangle",
   "description": "triangle = clean triangulation; quad = QuadriFlow quad retopology; lowpoly = aggressive decimation."
  },
  "target_faces": {
   "type": "integer",
   "default": 50000,
   "maximum": 500000,
   "minimum": 1000,
   "description": "Target triangle count for the output mesh."
  },
  "texture_size": {
   "enum": [
    512,
    1024,
    2048
   ],
   "type": "integer",
   "default": 1024,
   "description": "Resolution of the re-baked texture atlas."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bytes": 812044,
  "stage": "remesh",
  "textured": true,
  "input_url": "https://three.ws/avatars/mannequin.glb",
  "operation": "full",
  "persisted": true,
  "face_count": 20000,
  "output_url": "https://three.ws/cdn/x402-pipeline/remesh/abc123.glb",
  "quad_ratio": 0.98,
  "remesh_mode": "quad"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-3d-mesh-remesh-pipeline-1e60e0cf/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)