| name | rodin3d-bang-skill |
| description | Generate segmented 3D part files from a user-provided image or text prompt using Hyper3D Rodin Gen-2 plus the BANG API. Use when Codex needs to turn an image or prompt into downloaded BANG parts, inspect BANG task status, integrate Hyper3D image-to-parts automation, or create a controllable local web visualization from generated parts. Text prompts are supported only as source input for BANG parts, not as ordinary unsplit 3D model generation. |
Hyper3D BANG Parts
Use this skill to produce split 3D part files from one input image or, when needed, a text prompt.
Workflow
Run the bundled script and always provide an output directory:
python <skill_dir>/scripts/generate_banged_parts.py \
--image path/to/input.png \
--output ./output \
--strength 5 \
--geometry-file-format glb \
--material Shaded \
--resolution Basic \
--api-key "$HYPER3D_API_KEY"
Before starting, tell the user that Rodin Gen-2 generation usually takes about 5 minutes and the BANG split usually takes roughly another 5 minutes. The whole request may take around 10 minutes before files are available.
The script performs the required asynchronous sequence:
- Submit a Rodin Gen-2 image or prompt task to create the source asset.
- Poll
https://api.hyper3d.com/api/v2/status until the source asset is Done.
- Submit
https://api.hyper3d.com/api/v2/bang with the Rodin Gen-2 task UUID as asset_id.
- Poll the BANG subscription key until all BANG jobs are
Done.
- Call
https://api.hyper3d.com/api/v2/download with the BANG task UUID and immediately download the returned files.
BANG download URLs expire quickly, so do not return only URLs to the user. Download the files and report the local output directory.
