# three.ws Remix Asset

> three.ws Remix Asset is a paid API for AI agents from three.ws, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-11).

Remixes an existing 3D agent creation by applying a plain-language instruction, returning a new GLB mesh with royalty payment to the original creator.

## Facts

- Endpoint: POST https://three.ws/api/x402/remix-asset?utm_source=zero.xyz
- Price: $0.25/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-remix-asset-5cf0b31c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EB8LTWDHnfbhO-SWiW8Sy

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-remix-asset-5cf0b31c -d '<json body>'
```

Example prompt: Take the 3D creation with ID 'abc123' from the remix feed and remix it to give the character a futuristic silver armor outfit and glowing blue eyes.

## When to prefer this

Use this endpoint when you need to programmatically create a derivative 3D avatar or AI agent character by modifying an existing published creation on three.ws with a plain-language instruction. It is the right choice when you already have a remixable source_creation_id from the three.ws remix feed, want a GLB mesh output, and are willing to pay royalties to the original creator. Prefer this over starting from scratch when the base creation is close to what you need.

## Known failure modes

- Invalid or non-remixable source_creation_id returns an error (creation not found or not marked remixable)
- instruction exceeds 500 characters or is empty — validation error
- Insufficient USDC balance to cover the $0.25 fee — payment failure
- 3D generation failure from the underlying AI model — service error
- Network or CDN issues preventing GLB delivery

## 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 confirming success, the fee paid in USD and atomics, a new GLB mesh URL and creation ID for the remixed 3D asset, the source creation's ID and royalty percentage, and royalty payment details including whether it was paid, if it was capped, the creator transaction hash, and the creator's USD payout.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "instruction": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1,
   "description": "The change to make, in plain language."
  },
  "source_creation_id": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1,
   "description": "The id of a remixable creation (from GET /api/remix-feed)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "fee": {
   "usd": 0.25,
   "atomics": "250000"
  },
  "remix": {
   "glbUrl": "https://three.ws/cdn/creations/def456/mesh.glb",
   "creationId": "def456"
  },
  "source": {
   "id": "00000000-0000-0000-0000-000000000000",
   "royaltyPercent": 10
  },
  "royalty": {
   "paid": true,
   "capped": false,
   "creatorTx": "5eyk…",
   "creatorUsd": 0.025
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-remix-asset-5cf0b31c/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)