{"uid":"cap_0u2zfAJo6cmsOCzCotVQv","slug":"three-ws-avatar-optimize-batch-357f5e0c","name":"three.ws Avatar Optimize Batch","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/avatar-optimize-batch?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":50,"minimum":1,"description":"Number of top avatars to analyze (1–50)."}}},"responseSchema":{"type":"json","example":{"avatars":[{"id":"uuid","name":"My Avatar","info_count":5,"size_bytes":2100000,"warn_count":3,"critical_count":1,"top_suggestion":"Apply Draco compression to reduce geometry size by ~60%"}],"analyzed":50,"info_count":91,"warn_count":38,"critical_count":12,"total_size_bytes":82000000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zDNlcNPQ4fPJMDywWREvW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes up to 50 3D avatars in batch and returns optimization suggestions including compression recommendations, file size metrics, and severity-ranked warnings.","exampleAgentPrompt":"Can you run a batch optimization audit on my top 30 three.ws avatars and tell me which ones have critical issues and what the best fix suggestions are?","exampleUseCases":[{"title":"Pre-launch avatar quality audit","prompt":"Before we go live, analyze my top 50 avatars on three.ws and flag anything with critical issues or bloated file sizes so we can fix them first."},{"title":"Identifying avatars needing Draco compression","prompt":"Which of my three.ws avatars have the biggest geometry files and would benefit most from Draco compression? Check my top 20."},{"title":"Monitoring avatar health for a large platform","prompt":"Run a batch check on my 50 most-used three.ws avatars and give me a breakdown of how many have warnings or critical problems, and what the most common issue is."}],"resultDescription":"Returns a list of analyzed avatars each with their UUID, name, file size in bytes, info/warn/critical issue counts, and a top optimization suggestion (e.g. 'Apply Draco compression to reduce geometry size by ~60%'). Also returns aggregate totals: number analyzed, total file size, and rolled-up info/warn/critical counts across all avatars.","failureModes":["limit out of range (must be 1–50) returns validation error","no avatars found in account returns empty list","authentication/payment failure via x402 returns 402 Payment Required","server-side analysis timeout for very large avatar assets"],"whenToPreferThis":"Use this endpoint when you need to audit a batch of 3D avatars for performance and optimization issues on the three.ws platform. It is the right choice when you want prioritized, actionable recommendations across many avatars at once rather than analyzing a single avatar. Prefer this over manual inspection when managing a large library of 3D AI agents and need to triage critical vs minor issues efficiently.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:37:36.112Z","isFirstParty":false,"canonicalSlug":"three-ws-avatar-optimize-batch-357f5e0c"}