Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs: correct the API reference and voice lab pages
nirholas2afe32e59766
diff --git a/data/changelog.json b/data/changelog.jsonindex 1882e8279..2965769d5 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,16 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-08-15",+ "title": "Asking for a voice that does not exist now tells you so, instead of quietly speaking in a different one",+ "summary": "The voice API accepts a provider and a voice id from the voice catalog. If the id was not one that provider actually has, nothing said so: the request was answered with audio rendered in that lane's default voice, and on the metered lanes it was billed, so a single typo in a voice id came back as a stranger's voice at full price with a success status. A well-formed id for a voice that had been removed took the opposite route and failed as a server error, which reads as our fault and tells a client to retry something that will never work. Both now return a plain rejection that names the id you sent and the catalog address to pick a real one from, and that check runs before anything is charged. Leaving the voice id out still gets you the lane default on purpose. Asking the catalog for a provider that does not exist used to return an empty list that was indistinguishable from a provider being down; it now says which providers exist. ElevenLabs voices, whose catalog grows every time you clone or add one, are still decided by ElevenLabs, but an id it rejects is reported as your request being wrong rather than ours, with any charge refunded first. Voice cloning also now asks who you are before reporting anything about how this server is configured.",+ "tags": [+ "fix",+ "improvement"+ ],+ "link": "/docs/api-reference"+ },{"date": "2026-08-15","title": "Looking up an on-chain agent by its CAIP reference works again",diff --git a/docs/api-reference.md b/docs/api-reference.mdindex 9c20cbe59..8564c2b25 100644--- a/docs/api-reference.md+++ b/docs/api-reference.md@@ -833,6 +833,8 @@ Text-to-speech via ElevenLabs with R2 caching. Requires auth.Audio binary. `Content-Type: audio/mpeg`.+A `voiceId` the account behind the request does not have returns `400 validation_error` (the charge, if any, is refunded first); a genuine ElevenLabs fault stays `502 upstream_error`.+Responses are cached in R2 by `sha256(voiceId + text + modelId)` for 30 days — identical requests return cached audio without hitting ElevenLabs.---diff --git a/docs/voice-lab.md b/docs/voice-lab.mdindex 6a793e44e..a22b3aa61 100644--- a/docs/voice-lab.md+++ b/docs/voice-lab.md@@ -142,7 +142,8 @@ The agent-voice handler ([`api/agents/_id/voice.js`](../api/agents/_id/voice.js)- **Recorder states.** `idle` -> `recording` (live waveform, timer, level meter) -> `review` (playback, name, Clone / Re-record) -> `cloning` (spinner) -> `done` (green check, `voice_id` shown, actions: Try in playground / Add to an agent / Record another).- **Auth.** The free lanes (Edge, Gemini, NVIDIA) serve anonymous callers on `/api/tts/synthesize` and `/api/tts/catalog`, rate-limited per IP. The metered lanes (OpenAI, ElevenLabs), cloning, and the Voice Library return `401 unauthorized` without a session or bearer token.-- **Server config.** ElevenLabs must be configured (`ELEVENLABS_API_KEY`) or the endpoints return `503 not_configured`; a request carrying its own `x-eleven-key` header still works (see the billing section above).+- **Server config.** ElevenLabs must be configured (`ELEVENLABS_API_KEY`) or the endpoints return `503 not_configured`; a request carrying its own `x-eleven-key` header still works (see the billing section above). `/api/tts/eleven-clone` checks who is asking first, so a signed-out caller gets `401` and never a reading of what this deployment has configured.+- **Voice ids are checked against the lane.** `POST /api/tts/synthesize` rejects a `voiceId` the chosen lane does not publish with `400 validation_error`, naming the id and the catalog URL to pick from, before anything is metered. It is never quietly swapped for the lane default (omit `voiceId` if that is what you want). ElevenLabs, whose catalog grows at runtime, reports an unknown id as a `400` from upstream instead.- **Paid cloning tier.** Instant Voice Cloning is an ElevenLabs paid-tier (Starter and up) feature. On a free upstream tier the API surfaces the upstream `can_not_use_instant_voice_cloning` body verbatim as a `502`.- **Length rules.** Voice Lab recommends 20 to 30 seconds, auto-stops at 60, and rejects under 3. The separate agent-clone endpoint (`POST /api/agents/:id/voice/clone`) enforces a 30-second floor. Platform-key clones on both endpoints are capped at 3 per user per day (an abuse guard on the shared account's limited clone slots) and each is charged per the billing section; BYOK clones on `/api/tts/eleven-clone` skip the cap.- **Synthesis limits.** 1,000 characters per `/api/tts/synthesize` request (500 on the older `/api/tts/eleven`); every platform-key request is metered to credits per the billing section (charged before synthesis, refunded on failure). BYOK requests are unmetered by the platform. Clips are cached in R2 and cache hits are not charged.