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
// Account-level inference billing routes.
//
// GET /api/me/usage credits, burn rate, days remaining at the
// current rate, this month's model calls and
// tokens, and the last top-ups with their
// signatures. ?agent_id=<uuid> narrows it to one
// agent and adds that agent's budget.
// POST /api/me/inference/provision/preview { agent_id, amount_usdc } → the confirmation
// table for funding a new inference key from
// that agent's wallet. Nothing moves.
// POST /api/me/inference/provision { preview_id, confirm_deposit: true, name? }
// → settles the top-up, then mints an API key
// scoped to `inference` alone, bound to the
// agent, and returns it ONCE
// (api/_lib/inference-provision.js).
//
// vercel.json maps the /api/me/* paths here (?action=usage | provision-preview |
// provision). Reads accept a session or any Bearer key carrying `inference`,
// `wallet:read` or `profile`; provisioning moves funds, so a Bearer caller
// needs `wallet:write`.
import { getSessionUser, authenticateBearer, extractBearer, hasScope } from '../_lib/auth.js';
import { sql } from '../_lib/db.js';
import { cors, error, json, method, readJson, wrap, rateLimited } from '../_lib/http.js';
import { requireCsrf } from '../_lib/csrf.js';
import { requireRealFundsAgreement } from '../_lib/real-funds-agreement.js';
import { limits, clientIp } from '../_lib/rate-limit.js';
import { inferenceUsage } from '../_lib/inference-billing.js';
import { reconcilePendingTopups } from '../_lib/inference-topup.js';
import { previewProvision, executeProvision, INFERENCE_BASE_URL } from '../_lib/inference-provision.js';
import { isUuid } from '../_lib/validate.js';
async function resolveCaller(req) {
const session = await getSessionUser(req);
if (session) return { userId: session.id, scope: null };
const bearer = await authenticateBearer(extractBearer(req));
if (bearer) return { userId: bearer.userId, scope: bearer.scope || '', apiKeyId: bearer.apiKeyId || null };
return null;
}
function scopeOk(caller, ...scopes) {
if (caller.scope === null) return true;
return scopes.some((s) => hasScope(caller.scope, s));
}
function sendTyped(res, err) {
if (err?.expose && err.status) return error(res, err.status, err.code, err.message, err.detail || {});
throw err;
}
export default wrap(async (req, res) => {
if (cors(req, res, { methods: 'GET,POST,OPTIONS', credentials: true })) return;
const action = String(req.query?.action || '');
const caller = await resolveCaller(req);
if (!caller) return error(res, 401, 'unauthorized', 'sign in, or send a three.ws API key as a Bearer token (npx three-ws login)');
if (action === 'usage') return handleUsage(req, res, caller);
if (action === 'provision-preview' || action === 'provision') return handleProvision(req, res, caller, action);
return error(res, 404, 'not_found', `unknown inference route: ${action || '(none)'}`);
});
async function handleUsage(req, res, caller) {
if (!method(req, res, ['GET'])) return;
if (!scopeOk(caller, 'inference', 'wallet:read', 'wallet:write', 'profile')) {
return error(res, 403, 'insufficient_scope', 'reading usage needs the inference, wallet:read or profile scope');
}
const rl = await limits.authedReadIp(clientIp(req));
if (!rl.success) return rateLimited(res, rl);
const agentId = req.query?.agent_id ? String(req.query.agent_id) : null;
let agent = null;
if (agentId) {
if (!isUuid(agentId)) return error(res, 400, 'bad_request', 'agent_id must be an agent id');
const [row] = await sql`
SELECT id, user_id, name, meta FROM agent_identities WHERE id = ${agentId} AND deleted_at IS NULL
`;
if (!row || String(row.user_id) !== String(caller.userId)) return error(res, 404, 'not_found', 'agent not found');
agent = row;
}
await reconcilePendingTopups(caller.userId);
const usage = await inferenceUsage({ userId: caller.userId, agent });
return json(res, 200, { ...usage, base_url: INFERENCE_BASE_URL });
}
async function handleProvision(req, res, caller, action) {
if (!method(req, res, ['POST'])) return;
if (!scopeOk(caller, 'wallet:write')) {
return error(res, 403, 'insufficient_scope', 'funding an inference key from an agent wallet needs the wallet:write scope');
}
// Provisioning sends real USDC out of the agent wallet, so it needs the signed
// real-funds agreements; the preview moves nothing. Checked before CSRF so a
// refusal does not burn the owner's single-use token.
if (action === 'provision' && !(await requireRealFundsAgreement(req, res, { userId: caller.userId, context: 'inference-provision' }))) return;
if (!(await requireCsrf(req, res, caller.userId))) return;
const rl = await limits.authIp(clientIp(req));
if (!rl.success) return rateLimited(res, rl);
const body = (await readJson(req).catch(() => null)) || {};
try {
if (action === 'provision-preview') {
const preview = await previewProvision({
userId: caller.userId,
agentId: body.agent_id,
amountUsdc: body.amount_usdc ?? body.amount,
});
return json(res, 200, preview);
}
const out = await executeProvision({
userId: caller.userId,
previewId: body.preview_id,
confirmDeposit: body.confirm_deposit,
name: body.name,
req,
});
return json(res, out.status, out.body);
} catch (err) {
return sendTyped(res, err);
}
}