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
<!doctype html>
<html lang="en">
<head>
<script>/* three.ws theme boot — no-flash; runtime in /theme-switcher.js */(function(){try{var m=localStorage.getItem('twx_theme');var l=m==='auto'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: light)').matches):m==='light';document.documentElement.setAttribute('data-theme',l?'light':'dark');}catch(e){document.documentElement.setAttribute('data-theme','dark');}})();</script>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title data-i18n="forge_spark.meta_title">Text → 3D · Nemotron → FLUX → TRELLIS · three.ws</title>
<meta
name="description"
content="Describe an object and watch it become a textured 3D mesh. Nemotron sharpens the prompt, FLUX paints a reference image, and TRELLIS reconstructs the model, served on NVIDIA NIM."
data-i18n-attr="content:forge_spark.meta_description"/>
<meta property="og:title" content="Text → 3D · Nemotron → FLUX → TRELLIS · three.ws" data-i18n-attr="content:forge_spark.meta_og_title"/>
<meta
property="og:description"
content="Describe it. Nemotron sharpens the words, FLUX paints a clean reference, TRELLIS reconstructs the mesh. Served on NVIDIA NIM, quiet and always on."
data-i18n-attr="content:forge_spark.meta_og_description"/>
<meta property="og:type" content="website" />
<meta property="og:site_name" content="three.ws" />
<meta property="og:url" content="https://three.ws/forge-spark" />
<meta property="og:image" content="https://three.ws/api/page-og?s=build&t=Text+%E2%86%92+3D%3A+Nemotron+%E2%86%92+FLUX+%E2%86%92+TRELLIS&d=Describe+an+object+and+watch+it+become+a+textured+3D+mesh%3A+Nemotron+sharpens+the+prompt%2C+FLUX+paints+a+clean+reference%2C+and+TRELLIS+reconstructs+the+model&p=%2Fforge-spark" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@trythreews" />
<meta name="twitter:title" content="Text → 3D · Nemotron → FLUX → TRELLIS · three.ws" data-i18n-attr="content:forge_spark.meta_twitter_title"/>
<meta
name="twitter:description"
content="Describe it. Nemotron sharpens the words, FLUX paints a reference, TRELLIS reconstructs the mesh. Served on NVIDIA NIM."
data-i18n-attr="content:forge_spark.meta_twitter_description"/>
<meta name="twitter:image" content="https://three.ws/api/page-og?s=build&t=Text+%E2%86%92+3D%3A+Nemotron+%E2%86%92+FLUX+%E2%86%92+TRELLIS&d=Describe+an+object+and+watch+it+become+a+textured+3D+mesh%3A+Nemotron+sharpens+the+prompt%2C+FLUX+paints+a+clean+reference%2C+and+TRELLIS+reconstructs+the+model&p=%2Fforge-spark" />
<meta name="theme-color" content="#080814" />
<link rel="icon" href="/favicon.ico" sizes="any" />
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
<link rel="manifest" href="/manifest.webmanifest" />
<link rel="canonical" href="https://three.ws/forge-spark" />
<link rel="stylesheet" href="/style.css" />
<script
type="module"
src="https://cdn.jsdelivr.net/npm/@google/[email protected]/dist/model-viewer.min.js"
integrity="sha384-wjsPzEO+lXOf7d9csIDfAQpPt2OKuUU3m0K9qsdKIuzX4N8czSF6hdh23eAbZa3p"
crossorigin="anonymous"
></script>
<style>
.spark-main {
max-width: 1180px;
margin: 0 auto;
padding: var(--space-lg) clamp(var(--space-md), 4vw, var(--space-2xl)) var(--space-2xl);
}
/* Hero ------------------------------------------------------- */
.spark-hero {
text-align: center;
max-width: 660px;
margin: clamp(var(--space-lg), 5vw, var(--space-2xl)) auto var(--space-xl);
}
.spark-eyebrow {
display: inline-flex;
align-items: center;
gap: 0.5em;
font-size: 0.78rem;
letter-spacing: 0.08em;
text-transform: uppercase;
color: var(--text-muted, #8a8aa0);
border: 1px solid var(--border, #23233a);
border-radius: 999px;
padding: 0.35em 0.85em;
margin-bottom: var(--space-md);
}
.spark-eyebrow .dot {
width: 7px;
height: 7px;
border-radius: 50%;
background: #76e0a0;
box-shadow: 0 0 0 0 rgba(118, 224, 160, 0.6);
animation: spark-pulse 2.4s ease-out infinite;
}
@keyframes spark-pulse {
0% { box-shadow: 0 0 0 0 rgba(118, 224, 160, 0.5); }
70% { box-shadow: 0 0 0 8px rgba(118, 224, 160, 0); }
100% { box-shadow: 0 0 0 0 rgba(118, 224, 160, 0); }
}
.spark-hero h1 {
font-size: clamp(1.9rem, 4.5vw, 2.9rem);
line-height: 1.08;
margin: 0 0 var(--space-sm);
letter-spacing: -0.02em;
}
.spark-hero p {
color: var(--text-muted, #9a9ab2);
font-size: 1.04rem;
line-height: 1.6;
margin: 0;
}
/* Workspace -------------------------------------------------- */
.spark-workspace {
display: grid;
grid-template-columns: minmax(0, 1fr);
gap: var(--space-xl);
align-items: start;
}
@media (min-width: 980px) {
.spark-workspace {
grid-template-columns: minmax(320px, 380px) minmax(0, 1fr);
}
}
.composer {
display: flex;
flex-direction: column;
gap: var(--space-md);
background: var(--surface, #11111c);
border: 1px solid var(--border, #23233a);
border-radius: var(--radius-lg, 16px);
padding: var(--space-lg);
}
.composer label {
font-weight: 600;
font-size: 0.95rem;
}
.composer textarea {
width: 100%;
min-height: 116px;
resize: vertical;
background: var(--bg, #08080f);
color: inherit;
border: 1px solid var(--border, #2a2a42);
border-radius: var(--radius, 12px);
padding: var(--space-md);
font: inherit;
line-height: 1.5;
transition: border-color var(--duration-fast) var(--ease-standard);
}
.composer textarea:focus {
outline: none;
border-color: var(--accent, #6c8cff);
}
.example-row {
display: flex;
flex-wrap: wrap;
gap: 0.5rem;
}
.chip {
font-size: 0.82rem;
color: var(--text-muted, #9a9ab2);
background: transparent;
border: 1px solid var(--border, #2a2a42);
border-radius: 999px;
padding: 0.35em 0.8em;
cursor: pointer;
transition: border-color var(--duration-fast) var(--ease-standard), color var(--duration-fast) var(--ease-standard), transform var(--duration-fast) var(--ease-standard);
}
.chip:hover { border-color: var(--accent, #6c8cff); color: var(--text, #eee); }
.chip:active { transform: translateY(1px); }
.chip:focus-visible { outline: 2px solid var(--accent, #6c8cff); outline-offset: 2px; }
.generate-btn {
appearance: none;
border: none;
border-radius: var(--radius, 12px);
padding: 0.85em 1.1em;
font: inherit;
font-weight: 650;
color: #07070f;
background: linear-gradient(135deg, #8ad0ff, #76e0a0);
cursor: pointer;
transition: filter var(--duration-fast) var(--ease-standard), transform var(--duration-fast) var(--ease-standard);
}
.generate-btn:hover { filter: brightness(1.06); }
.generate-btn:active { transform: translateY(1px); }
.generate-btn:disabled { opacity: 0.55; cursor: not-allowed; filter: none; }
.generate-btn:focus-visible { outline: 2px solid var(--focus-ring-color); outline-offset: 2px; }
/* Pipeline stages -------------------------------------------- */
.pipeline {
list-style: none;
margin: 0;
padding: 0;
display: flex;
flex-direction: column;
gap: 0.55rem;
}
.stage {
display: grid;
grid-template-columns: 26px 1fr auto;
align-items: center;
gap: 0.7rem;
padding: 0.6rem 0.75rem;
border: 1px solid var(--border, #23233a);
border-radius: var(--radius, 12px);
color: var(--text-muted, #8a8aa0);
transition: border-color var(--duration-base) var(--ease-standard), color var(--duration-base) var(--ease-standard), background var(--duration-base) var(--ease-standard);
}
.stage .num {
width: 26px; height: 26px;
display: grid; place-items: center;
border-radius: 50%;
border: 1px solid currentColor;
font-size: 0.78rem;
font-variant-numeric: tabular-nums;
}
.stage .who { font-weight: 600; color: var(--text, #e6e6f2); }
.stage .does { font-size: 0.82rem; }
.stage .state { font-size: 0.74rem; letter-spacing: 0.04em; text-transform: uppercase; opacity: 0.7; }
.stage[data-state='active'] {
border-color: var(--accent, #6c8cff);
background: color-mix(in srgb, var(--accent, #6c8cff) 8%, transparent);
color: var(--text, #e6e6f2);
}
.stage[data-state='active'] .num { animation: spark-spin 1s linear infinite; border-style: dashed; }
.stage[data-state='done'] { border-color: #76e0a0; color: var(--text, #e6e6f2); }
.stage[data-state='done'] .num { background: #76e0a0; color: #07070f; border-color: #76e0a0; }
.stage[data-state='failed'] {
border-color: color-mix(in srgb, #ff6b6b 55%, transparent);
background: color-mix(in srgb, #ff6b6b 6%, transparent);
color: var(--text, #e6e6f2);
}
.stage[data-state='failed'] .num { border-color: #ff9a9a; color: #ff9a9a; }
.stage[data-state='failed'] .state { color: #ff9a9a; opacity: 1; }
@keyframes spark-spin { to { transform: rotate(360deg); } }
/* Viewer ----------------------------------------------------- */
.stage-block { display: flex; flex-direction: column; gap: var(--space-md); }
.viewer-shell {
position: relative;
aspect-ratio: 1 / 1;
width: 100%;
border: 1px solid var(--border, #23233a);
border-radius: var(--radius-lg, 16px);
overflow: hidden;
background:
radial-gradient(120% 90% at 50% 0%, color-mix(in srgb, var(--accent, #6c8cff) 10%, transparent), transparent 60%),
var(--surface, #0d0d18);
display: grid;
place-items: center;
}
.viewer-shell model-viewer { width: 100%; height: 100%; --poster-color: transparent; }
.viewer-empty {
text-align: center;
color: var(--text-muted, #8a8aa0);
padding: var(--space-lg);
max-width: 320px;
}
.viewer-empty svg { opacity: 0.5; margin-bottom: var(--space-sm); }
.viewer-status {
position: absolute;
inset: auto 0 0 0;
padding: 0.7rem 1rem;
font-size: 0.85rem;
color: var(--text, #e6e6f2);
background: linear-gradient(0deg, color-mix(in srgb, var(--bg, #08080f) 88%, transparent), transparent);
display: flex;
align-items: center;
gap: 0.55rem;
}
.viewer-status .spinner {
width: 14px; height: 14px; border-radius: 50%;
border: 2px solid color-mix(in srgb, var(--accent, #6c8cff) 35%, transparent);
border-top-color: var(--accent, #6c8cff);
animation: spark-spin 0.8s linear infinite;
}
.viewer-actions { display: flex; gap: 0.6rem; flex-wrap: wrap; }
.viewer-actions a, .viewer-actions button {
font: inherit; font-size: 0.88rem;
text-decoration: none;
color: var(--text, #e6e6f2);
border: 1px solid var(--border, #2a2a42);
border-radius: 999px;
padding: 0.45em 0.95em;
background: transparent;
cursor: pointer;
transition: border-color var(--duration-fast) var(--ease-standard);
}
.viewer-actions a:hover, .viewer-actions button:hover { border-color: var(--accent, #6c8cff); }
.error-note {
color: #ff9a9a;
font-size: 0.88rem;
border: 1px solid color-mix(in srgb, #ff6b6b 40%, transparent);
background: color-mix(in srgb, #ff6b6b 8%, transparent);
border-radius: var(--radius, 12px);
padding: 0.7rem 0.9rem;
display: flex;
flex-wrap: wrap;
align-items: center;
justify-content: space-between;
gap: 0.5rem 0.9rem;
}
.error-retry {
font: inherit;
font-size: 0.84rem;
font-weight: 600;
color: inherit;
background: transparent;
border: 1px solid color-mix(in srgb, #ff6b6b 55%, transparent);
border-radius: 999px;
padding: 0.35em 0.95em;
cursor: pointer;
transition: border-color var(--duration-fast) var(--ease-standard), background var(--duration-fast) var(--ease-standard);
}
.error-retry:hover { border-color: #ff9a9a; background: color-mix(in srgb, #ff6b6b 14%, transparent); }
.error-retry:active { transform: translateY(1px); }
.error-retry:focus-visible { outline: 2px solid #ff9a9a; outline-offset: 2px; }
.refined {
font-size: 0.86rem;
color: var(--text-muted, #9a9ab2);
border-left: 2px solid var(--accent, #6c8cff);
padding: 0.2rem 0 0.2rem 0.75rem;
line-height: 1.5;
}
.refined b { color: var(--text, #e6e6f2); font-weight: 600; }
.refined .by { font-size: 0.74rem; opacity: 0.7; display: block; margin-top: 0.25rem; }
/* A plain <p>, not a <footer>: public/style.css turns any <footer>
* without an h-footer class into the legacy absolutely-positioned
* corner credit badge for the 3D viewer pages, which pulled this note
* out of flow and clipped its links off-screen on a phone. */
.spark-note {
margin: var(--space-2xl) auto 0;
max-width: 62ch;
text-align: center;
color: var(--text-muted, #7a7a92);
font-size: 0.85rem;
line-height: 1.6;
}
.spark-note a { color: inherit; text-decoration: underline; text-underline-offset: 2px; }
.spark-note a:hover { color: var(--text, #e6e6f2); }
.spark-note a:focus-visible { outline: 2px solid var(--accent, #6c8cff); outline-offset: 2px; border-radius: 3px; }
.visually-hidden { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); }
</style>
<meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1">
<meta property="og:locale" content="en_US">
<meta property="og:image:alt" content="Text → 3D: Nemotron → FLUX → TRELLIS - three.ws">
<script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebPage","name":"Text → 3D - Nemotron → FLUX → TRELLIS","description":"Describe an object and watch it become a textured 3D mesh: Nemotron sharpens the prompt, FLUX paints a clean reference, and TRELLIS reconstructs the model - served on NVIDIA NIM, quiet and always on.","url":"https://three.ws/forge-spark","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"},"primaryImageOfPage":"https://three.ws/api/page-og?s=build&t=Text+%E2%86%92+3D+-+Nemotron+%E2%86%92+FLUX+%E2%86%92+TRELLIS&d=Describe+an+object+and+watch+it+become+a+textured+3D+mesh%3A+Nemotron+sharpens+the+prompt%2C+FLUX+paints+a+clean+reference%2C+and+TRELLIS+reconstructs+the+model+-+ser&p=%2Fforge-spark"}]}</script>
</head>
<body class="forge-page">
<div id="nav-container"></div>
<main class="spark-main">
<header class="spark-hero">
<span class="spark-eyebrow" data-i18n-html="forge_spark.text_3d_served_on_nvidia_nim"><span class="dot"></span> Text → 3D · served on NVIDIA NIM</span>
<h1 data-i18n="forge_spark.describe_it_hold_it">Describe it. Hold it.</h1>
<p data-i18n="forge_spark.a_sentence_becomes_a_textured_3d_mesh">
A sentence becomes a textured 3D mesh. Nemotron sharpens your words, FLUX paints a clean
reference, and TRELLIS reconstructs the model, quietly, on NVIDIA NIM.
</p>
</header>
<div class="spark-workspace">
<!-- Composer -->
<form class="composer" id="composer" autocomplete="off">
<label for="prompt" data-i18n="forge_spark.what_should_we_build">What should we build?</label>
<textarea
id="prompt"
placeholder="a worn brass pocket watch, half-open, resting on its side"
maxlength="400"
required
></textarea>
<div class="example-row" id="examples" aria-label="Example prompts">
<button type="button" class="chip" data-fill="a worn brass pocket watch, half-open" data-i18n="forge_spark.brass_pocket_watch">brass pocket watch</button>
<button type="button" class="chip" data-fill="a glazed ceramic teapot with a bamboo handle" data-i18n="forge_spark.ceramic_teapot">ceramic teapot</button>
<button type="button" class="chip" data-fill="a vintage film camera, matte black body" data-i18n="forge_spark.film_camera">film camera</button>
<button type="button" class="chip" data-fill="a potted monstera plant in a terracotta pot" data-i18n="forge_spark.potted_monstera">potted monstera</button>
</div>
<button type="submit" class="generate-btn" id="generate" data-i18n="forge_spark.generate_3d_model">Generate 3D model</button>
<div id="refined" class="refined" hidden></div>
</form>
<!-- Pipeline + viewer -->
<div class="stage-block">
<ol class="pipeline" id="pipeline">
<li class="stage" data-stage="nemotron" data-state="idle" data-i18n-html="forge_spark.1_nemotron_refines_your_prompt_idle">
<span class="num">1</span>
<span><span class="who">Nemotron</span><br /><span class="does">refines your prompt</span></span>
<span class="state">idle</span>
</li>
<li class="stage" data-stage="flux" data-state="idle" data-i18n-html="forge_spark.2_flux_paints_a_reference_image_idle">
<span class="num">2</span>
<span><span class="who">FLUX</span><br /><span class="does">paints a reference image</span></span>
<span class="state">idle</span>
</li>
<li class="stage" data-stage="trellis" data-state="idle" data-i18n-html="forge_spark.3_trellis_reconstructs_the_3d_mesh_idle">
<span class="num">3</span>
<span><span class="who">TRELLIS</span><br /><span class="does">reconstructs the 3D mesh</span></span>
<span class="state">idle</span>
</li>
</ol>
<div class="viewer-shell" id="viewer-shell">
<div class="viewer-empty" id="viewer-empty">
<svg width="42" height="42" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
<path d="M12 2 2 7l10 5 10-5-10-5Z" />
<path d="m2 17 10 5 10-5" />
<path d="m2 12 10 5 10-5" />
</svg>
<p data-i18n="forge_spark.your_model_will_appear_here_describe_an">Your model will appear here. Describe an object and hit generate, then orbit, light, and download the GLB.</p>
</div>
<div class="viewer-status" id="viewer-status" role="status" aria-live="polite" hidden>
<span class="spinner" aria-hidden="true"></span>
<span id="viewer-status-text" data-i18n="forge_spark.working">Working…</span>
</div>
</div>
<div class="error-note" id="error" role="alert" hidden>
<span id="error-text"></span>
<button type="button" class="error-retry" id="retry" data-i18n="forge_spark.try_again">Try again</button>
</div>
<div class="viewer-actions" id="actions" hidden>
<a id="download" download data-i18n="forge_spark.download_glb">Download GLB</a>
<button type="button" id="again" data-i18n="forge_spark.generate_another">Generate another</button>
</div>
</div>
</div>
<p class="spark-note">
The same TRELLIS NIM runs across lanes, local and cloud, so reconstruction stays
<b data-i18n="forge_spark.always_on">always on</b>. Image → 3D lives at <a href="/forge-nim" data-i18n="forge_spark.forge_nim">/forge-nim</a>; the full studio at
<a href="/forge" data-i18n="forge_spark.forge">/forge</a>.
</p>
</main>
<div id="footer-container"></div>
<script src="/nav.js" defer></script>
<script src="/footer.js" defer></script>
<script src="/model-viewer-meshopt.js"></script>
<script type="module">
import { resolveDevR2Url } from '/src/shared/dev-r2-proxy.js';
const form = document.getElementById('composer');
const promptEl = document.getElementById('prompt');
const generateBtn = document.getElementById('generate');
const refinedEl = document.getElementById('refined');
const shell = document.getElementById('viewer-shell');
const emptyEl = document.getElementById('viewer-empty');
const statusEl = document.getElementById('viewer-status');
const statusText = document.getElementById('viewer-status-text');
const errorEl = document.getElementById('error');
const errorText = document.getElementById('error-text');
const retry = document.getElementById('retry');
const actions = document.getElementById('actions');
const download = document.getElementById('download');
const again = document.getElementById('again');
const stages = {
nemotron: document.querySelector('[data-stage="nemotron"]'),
flux: document.querySelector('[data-stage="flux"]'),
trellis: document.querySelector('[data-stage="trellis"]'),
};
let viewer = null;
let busy = false;
let statusTimer = null;
let retryTimer = null;
document.getElementById('examples').addEventListener('click', (e) => {
const chip = e.target.closest('.chip');
if (!chip) return;
promptEl.value = chip.dataset.fill;
promptEl.focus();
});
function setStage(name, state, label) {
const el = stages[name];
if (!el) return;
el.dataset.state = state;
const s = el.querySelector('.state');
if (s) s.textContent = label || state;
}
// The refine lane is a chain, not one fixed model: when NVIDIA's Nemotron
// NIM is busy the request falls through to the next free rung. Rename the
// stage to whatever actually answered so the pipeline never claims a model
// that did not run.
function setStageWho(name, who) {
const el = stages[name];
const w = el && el.querySelector('.who');
if (w) w.textContent = who;
}
function resetStages() {
for (const name of Object.keys(stages)) setStage(name, 'idle', 'idle');
setStageWho('nemotron', 'Nemotron');
}
// A real elapsed counter (never a synthetic progress bar): a cold TRELLIS
// lane can hold a request for minutes, and a frozen line reads as a hang.
function showStatus(text) {
const started = Date.now();
statusText.textContent = text;
statusEl.hidden = false;
clearInterval(statusTimer);
statusTimer = setInterval(() => {
const secs = Math.round((Date.now() - started) / 1000);
statusText.textContent = secs >= 5 ? text + ' (' + secs + 's)' : text;
}, 1000);
}
function hideStatus() {
clearInterval(statusTimer);
statusTimer = null;
statusEl.hidden = true;
}
// `retryAfter` comes from the endpoint's own retry-after hint on a 429, so
// the recovery button opens exactly when a retry can succeed.
function showError(msg, retryAfter) {
errorText.textContent = msg;
errorEl.hidden = false;
clearInterval(retryTimer);
retryTimer = null;
retry.disabled = false;
retry.textContent = 'Try again';
let left = Math.min(Math.round(Number(retryAfter) || 0), 120);
if (left <= 0) return;
const tick = () => {
if (left <= 0) {
clearInterval(retryTimer);
retryTimer = null;
retry.disabled = false;
retry.textContent = 'Try again';
return;
}
retry.disabled = true;
retry.textContent = 'Try again in ' + left + 's';
left -= 1;
};
tick();
retryTimer = setInterval(tick, 1000);
}
function clearError() { errorEl.hidden = true; errorText.textContent = ''; }
function renderModel(url) {
if (!viewer) {
viewer = document.createElement('model-viewer');
viewer.setAttribute('camera-controls', '');
viewer.setAttribute('auto-rotate', '');
viewer.setAttribute('shadow-intensity', '1.0');
viewer.setAttribute('shadow-softness', '0.9');
viewer.setAttribute('exposure', '1.5');
viewer.setAttribute('tone-mapping', 'aces');
viewer.setAttribute('environment-image', 'neutral');
viewer.setAttribute('ar', '');
viewer.setAttribute('alt', 'Generated 3D model');
shell.appendChild(viewer);
}
// The R2 asset host only sends CORS headers for the production
// origins, so the viewer's fetch reads through the dev proxy on
// localhost / Codespaces and the raw URL everywhere else. The
// download link is a plain navigation, so it always keeps the
// canonical URL.
viewer.src = resolveDevR2Url(url);
emptyEl.hidden = true;
download.href = url;
actions.hidden = false;
}
// Step 1: Nemotron refines the prompt. Enhancement is a boost, never a
// gate: if the lane is unavailable we keep the user's own words.
async function refinePrompt(raw) {
setStage('nemotron', 'active', 'refining');
showStatus('Nemotron is sharpening your prompt…');
try {
const r = await fetch('/api/forge-enhance', {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ prompt: raw, engine: 'nemotron' }),
});
if (!r.ok) throw new Error('enhance ' + r.status);
const data = await r.json();
const refined = (data.prompt || raw).trim();
const model = data.model || 'Nemotron';
const label = prettyModel(model, data.provider);
refinedEl.hidden = false;
refinedEl.innerHTML =
'<b>Refined prompt</b> · ' + escapeHtml(refined) +
'<span class="by">refined with ' + escapeHtml(label) + '</span>';
setStageWho('nemotron', label);
setStage('nemotron', 'done', 'done');
return refined;
} catch (err) {
// Quiet fallback: keep the original prompt, mark the stage done.
refinedEl.hidden = false;
refinedEl.innerHTML = '<b>Using your prompt as written.</b><span class="by">refine step unavailable, generating anyway</span>';
setStage('nemotron', 'done', 'skipped');
return raw;
}
}
// Steps 2 + 3: FLUX paints a reference, TRELLIS reconstructs. /api/forge
// returns a finished glb_url synchronously, or a job to poll.
async function generateMesh(prompt) {
setStage('flux', 'active', 'painting');
showStatus('FLUX is painting a reference image…');
const r = await fetch('/api/forge', {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({ prompt, path: 'image' }),
});
const data = await r.json().catch(() => ({}));
if (!r.ok) {
throw withRetryHint(
new Error(data.message || data.error || ('forge ' + r.status)),
data.retry_after || r.headers.get('retry-after'),
);
}
if (data.status === 'done' && (data.glb_url || data.model_url)) {
markReconstructDone();
return data.glb_url || data.model_url;
}
const jobId = data.job_id;
if (!jobId) throw new Error('No model and no job returned.');
// The reference is painted; move into reconstruction while we poll.
setStage('flux', 'done', 'done');
setStage('trellis', 'active', 'reconstructing');
showStatus('TRELLIS is reconstructing the mesh…');
return pollJob(jobId);
}
function markReconstructDone() {
setStage('flux', 'done', 'done');
setStage('trellis', 'done', 'done');
}
async function pollJob(jobId) {
const deadline = Date.now() + 210_000; // generous ceiling for a cold lane
while (Date.now() < deadline) {
await sleep(2500);
let data;
try {
const r = await fetch('/api/forge?job=' + encodeURIComponent(jobId), {
headers: { accept: 'application/json' },
});
data = await r.json();
} catch {
continue; // transient network blip, keep polling
}
const status = data.status;
if (status === 'done' && (data.glb_url || data.model_url)) {
markReconstructDone();
return data.glb_url || data.model_url;
}
if (status === 'failed' || status === 'error') {
throw new Error(data.message || data.error || 'Reconstruction failed.');
}
// running / queued: keep waiting
}
throw new Error('This is taking longer than usual. Please try again.');
}
async function run() {
if (busy) return;
const raw = promptEl.value.trim();
if (raw.length < 3) {
showError('Describe the object in a few words first, then hit generate.');
promptEl.focus();
return;
}
busy = true;
generateBtn.disabled = true;
// Any countdown left from the previous failure is void the moment a
// new attempt starts.
clearInterval(retryTimer);
retryTimer = null;
retry.disabled = true;
generateBtn.textContent = 'Generating…';
clearError();
actions.hidden = true;
resetStages();
try {
const refined = await refinePrompt(raw);
const url = await generateMesh(refined);
hideStatus();
renderModel(url);
} catch (err) {
hideStatus();
// Mark whichever stage was active as failed.
for (const name of Object.keys(stages)) {
if (stages[name].dataset.state === 'active') setStage(name, 'failed', 'failed');
}
showError(err.message || 'Something went wrong. Please try again.', err.retryAfter);
} finally {
busy = false;
generateBtn.disabled = false;
// A live retry countdown owns the button until it expires.
if (!retryTimer) retry.disabled = false;
generateBtn.textContent = 'Generate 3D model';
}
}
form.addEventListener('submit', (e) => {
e.preventDefault();
run();
});
// The error note's own recovery action: same prompt, same pipeline, no
// scrolling back up to the button.
retry.addEventListener('click', run);
again.addEventListener('click', () => {
promptEl.focus();
promptEl.select();
});
function sleep(ms) { return new Promise((r) => setTimeout(r, ms)); }
function withRetryHint(err, seconds) {
const n = Number(seconds);
if (Number.isFinite(n) && n > 0) err.retryAfter = n;
return err;
}
function escapeHtml(s) {
return String(s).replace(/[&<>"']/g, (c) => ({ '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' }[c]));
}
function prettyModel(model, provider) {
const m = String(model || '').toLowerCase();
if (m.includes('nemotron')) return 'Nemotron (NVIDIA NIM)';
if (provider === 'nvidia') return model + ' (NVIDIA NIM)';
if (provider) return model + ' · ' + provider;
return model;
}
</script>
<!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->
<script type="module" src="/i18n.js"></script>
</body>
</html>