hunyuan-3d

name	hunyuan-3d
description	Generate PBR meshes (Hunyuan 3D Pro) for Canvas Studio chapters only. Use when presentation is studio and subjects need realistic 3D. Studio chrome lives in ui-studio-style — this skill owns mesh generation only.

hunyuan-3d

Produce a GLB (or batch of GLBs) for the studio stage. Soft-fail to procedural geometry.

UI chrome: follow skills/ui-studio-style/ (editorial specimen-explorer shell). Do not invent a separate layout.

When

• presentation: studio only — never call generate_mesh for page/slide lessons (cost gate)
• viz-engineer / mesh role during asset_plan
• capsule-author embeds mesh(es) inside the clipped studio stage canvas

Steps

1. Prompt — educational, single centered object, PBR, no text overlays
2. Optional image-to-3D — get_media().generate_image, then generate_mesh(image_url=...) for complex detail
3. Mesh tool — generate_mesh(prompt=..., enable_pbr=true, face_count=150000) via providers.registry.get_mesh()
4. Embed in studio shell:

   <canvas id="studio-canvas" width="640" height="420"></canvas>
   <div data-mesh-src="/build/mesh/model.glb" data-mesh-canvas="studio-canvas" hidden></div>
   

5. Multi-subject catalogs — propose_studio_subjects + run_studio_mesh_catalog build a sidebar catalog; up to MESH_STUDIO_MAX_HUNYUAN (default 3) use Hunyuan, the rest procedural. Wire SUBJECTS[id].meshSrc and swap via __hitutoReloadMesh.

Do not

• Start a second Three.js loop when data-mesh-src is present (mesh runtime owns the canvas)
• Invent OrbitControls CDN / ES modules
• Mix studio tokens with cobalt paper theme
• Generate Hunyuan meshes outside studio presentation

Soft-fail

Missing mesh credentials (TENCENTCLOUD_SECRET_ID/KEY preferred; GMI/Atlas are optional fallbacks), API errors, or timeouts must not fail the lesson — procedural abstract fallback inside the clipped stage.