{"uid":"cap_6ptRn6AXooj0Bs4Rx_LsY","slug":"three-ws-embody-3d-ai-agent-creator-2214da3c","name":"three.ws Embody — 3D AI Agent Creator","description":"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.","url":"https://three.ws/api/x402/embody?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","maxLength":64,"minLength":1,"description":"Display name for the agent body."},"voice":{"enum":["nova","alloy","ash","ballad","coral","echo","fable","onyx","sage","shimmer","verse"],"type":"string","description":"TTS voice id. Default nova."},"prompt":{"type":"string","maxLength":600,"minLength":1,"description":"Text description of the avatar to generate."},"image_url":{"type":"string","format":"uri","description":"Reference image URL to reconstruct into 3D."},"personality":{"type":"string","maxLength":600,"description":"Optional flavor text stored on the persona."}}},"responseSchema":{"type":"json","example":{"name":"Nova Scout","voice":"nova","rigged":true,"glb_url":"https://pub-xxxx.r2.dev/personas/persona_8f2a1c9d4be6f70a1b2c.glb","agent_id":"persona_8f2a1c9d4be6f70a1b2c","embed_html":"","reload_url":"https://three.ws/api/mcp3d/persona?id=persona_8f2a1c9d4be6f70a1b2c","viewer_url":"https://three.ws/viewer?src=https%3A%2F%2Fpub-xxxx.r2.dev%2Fpersonas%2Fpersona_8f2a1c9d4be6f70a1b2c.glb","profile_url":"https://three.ws/embodiment/embed?persona=persona_8f2a1c9d4be6f70a1b2c"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WljBh3tsdp4QKHC82DHOx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a rigged 3D avatar from a text prompt or reference image and returns an embeddable AI agent with a chosen TTS voice, powered by IBM watsonx.ai","exampleAgentPrompt":"Create a 3D AI agent named 'Aria' using this image — https://example.com/photo.jpg — give her a coral voice, and set her personality to 'friendly fintech advisor who explains crypto in plain English'.","exampleUseCases":[{"title":"Branded website AI concierge","prompt":"Make a 3D AI agent named 'Max' for my e-commerce site using this product photo — https://mystore.com/max.jpg — use the sage voice and set the personality to 'enthusiastic sneaker expert who helps shoppers find the perfect fit'."},{"title":"Virtual conference speaker avatar","prompt":"I need a rigged 3D avatar named 'Dr. Chen' built from this headshot — https://conference.io/drchen.jpg — with the onyx voice and a personality of 'calm academic who explains AI ethics in approachable language', so I can embed it on our event page."},{"title":"Personalized AI tutor avatar","prompt":"Generate a 3D AI tutor named 'Luna' from this illustration — https://edu.app/luna.png — using the nova voice and a personality description of 'patient, encouraging math teacher for middle schoolers', and give me the embed code for our learning platform."}],"resultDescription":"Returns a JSON object containing: a unique agent_id, a URL to the rigged GLB 3D model file, a ready-to-paste embed_html iframe snippet, a viewer_url for standalone viewing, a profile_url for the embodiment page, and a reload_url for fetching the persona again — plus the name and voice used.","failureModes":["Invalid or inaccessible image_url returns an error preventing 3D reconstruction","Prompt or personality text exceeding 600 characters is rejected with a validation error","Missing required name or prompt fields causes a 400-level error","Payment of $1 USDC not fulfilled results in a 402 Payment Required response","Unsupported voice enum value causes a schema validation failure","Slow or unavailable reference image host may cause timeout during avatar generation"],"whenToPreferThis":"Choose this endpoint when you need to create a persistent, embeddable 3D AI agent tied to a visual identity (photo or described appearance) with a specific TTS voice and personality. It is uniquely suited for use cases where a lifelike 3D avatar — not a flat chatbot — needs to be dropped onto a web page via a single iframe tag, and where built-in IBM watsonx.ai reasoning and optional per-chat micropayments are desired. Prefer alternatives if you only need a 2D chatbot widget, audio-only TTS, or a static 3D model without conversational AI.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:47:23.546Z","isFirstParty":false,"canonicalSlug":"three-ws-embody-3d-ai-agent-creator-2214da3c"}